Gérer les paramètres de l’application

Les administrateurs système chargés de déployer ArcGIS Pro au sein d’une équipe ou d’une organisation peuvent être amenés à contrôler les paramètres de l’application pour le compte de leurs utilisateurs. ArcGIS Pro permet aux administrateurs de définir des valeurs par défaut pour un certain nombre de paramètres d’application et tous les paramètres des outils de géotraitement. Il est également possible de verrouiller ces paramètres pour empêcher les utilisateurs de modifier leur valeur définie par l’administrateur.

Les sections suivantes décrivent le processus de contrôle des paramètres d’application dans votre déploiement ArcGIS Pro :

  1. Création d’un fichier Pro.settingsConfig.
  2. Publication du fichier dans un répertoire ou un partage accessible par les utilisateurs.
  3. Configuration des machines des utilisateurs pour l’utilisation du fichier déployé.

Créer un fichier Pro.settingsConfig

Pour contrôler les paramètres de l’application, vous devez commencer par créer un fichier Pro.settingsConfig. Ce type de fichier se présente au format Extensible Markup Language (XML), mais il porte l’extension .settingsConfig à la place de l’extension .xml.

Si vous avez à votre disposition un éditeur XML avancé, comme Microsoft Visual Studio, vous pouvez utiliser un fichier XML Schema Definition (.xsd) pendant le processus de création. Le fichier .xsd correspondant au format settingsConfig est inclus dans l’installation d’ArcGIS Pro. Vous trouverez le fichier ProSettings.xsd dans le répertoire \Resources\XmlSchema, à l’emplacement de l’installation d’ArcGIS Pro.

Pour créer un fichier Pro.settingsConfig, créez un fichier vierge dans l’éditeur de texte ou XML de votre choix, puis copiez et collez le contenu de l’échantillon ci-dessous et mettez-le à jour si nécessaire :

  • Pour les paramètres à utiliser, supprimez la syntaxe de mise en commentaire (<!-- et -->) au début et à la fin de la ligne.
  • Pour les paramètres à ne pas utiliser, vous pouvez conserver la syntaxe de mise en commentaire ou supprimer la ligne.

Remarque :

Cet échantillon ne comprend pas tous les paramètres d’application et propriétés disponibles. Pour la liste complète, reportez-vous à la rubrique Paramètres disponibles pour le contrôle par les administrateurs.

<?xml version="1.0" encoding="UTF-8"?>
<ArcGISProSettings xmlns="http://schemas.esri.com/ProSettings"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://schemas.esri.com/ProSettings .\prosettings.xsd">

  <Application>
    <!-- <UseLocalHelp isLocked="false">true</UseLocalHelp> -->
    <!-- <UseSpellCheck isLocked="false">true</UseSpellCheck> -->
    <!-- <UseDarkTheme isLocked="false">true</UseDarkTheme> -->
  </Application>

  <Projects>
    <!-- <CreateBackup isLocked="true">true</CreateBackup> -->
    <!-- <BackupIntervalMinutes isLocked="true">3</BackupIntervalMinutes> -->
    <!-- <LocalProject> -->
      <!-- <CustomDefaultLocation isLocked="true">C:\Testing\Team_Defaults\Team_Projects</CustomDefaultLocation> -->
      <!-- <CreateProjectInNewFolder isLocked="false">false</CreateProjectInNewFolder> -->
      <!-- <HomeFolder isLocked="false">c:\Testing\Team_Defaults\Team_Data</HomeFolder> -->
      <!-- <DefaultGeodatabase isLocked="true">C:\Testing\Team_Defaults\Team_Data\Team_EGDB.sde</DefaultGeodatabase> -->
      <!-- <DefaultToolbox isLocked="true">C:\Testing\Team_Defaults\Team_Data\Team_Tools.atbx</DefaultToolbox> -->
    <!-- </LocalProject> -->
  </Projects>

  <Versioning>
    <!-- <ConnectionDefaultVersioningType isLocked="false">Branch</ConnectionDefaultVersioningType> -->
    <!-- <ReconcileDefineConflicts isLocked="true">ByRow</ReconcileDefineConflicts> -->  
    <!-- <ReconcileResolveConflicts>FavorTargetVersion</ReconcileResolveConflicts> --> 
    <!-- <ShowReconcileDialog>true</ShowReconcileDialog> -->
    <!-- <ShowConflictDialog>true</ShowConflictDialog> -->
  </Versioning>

  <MapAndScene>
    <!-- <DefaultBasemapJson isLocked="true">FromPortal</DefaultBasemapJson> -->
    <!-- <LayerVisibleByDefault isLocked="true">true</LayerVisibleByDefault> -->
    <!-- <DefaultSpatialReference isLocked="false">Not set</DefaultSpatialReference> -->
    <!-- <ConfirmTransformation isLocked="true">true</ConfirmTransformation> -->
    <!-- <DefaultLabelEngine isLocked="true">Standard</DefaultLabelEngine> -->
    <!-- <AddDefaultElevationSource isLocked="true">true</AddDefaultElevationSource> -->
    <!-- <CustomElevationSourceXml isLocked="false">Not set</CustomElevationSourceXml> -->
    <!-- <ManageFeatureCaching isLocked="true">true</ManageFeatureCaching> -->
    <!-- <ContentPanePointLegendsPatchSizeLimit isLocked="true">48</ContentPanePointLegendsPatchSizeLimit> -->
    <!-- <AreUnRegisteredDatasetsAndCsvBackwardCompatible isLocked="true">false</AreUnRegisteredDatasetsAndCsvBackwardCompatible> -->
    <!-- <CheckMapsWhenDeleting isLocked="true">None</CheckMapsWhenDeleting> -->
    <!-- <CheckMapsWhenRenaming isLocked="true">None</CheckMapsWhenRenaming> -->
  </MapAndScene>

  <Catalog>
    <!-- <EnableIndexing isLocked="true">false</EnableIndexing> -->
    <!-- <IndexNetworkConnections isLocked="true">false</IndexNetworkConnections> -->
    <!-- <MetadataCanDeleteGPHistory isLocked="true">false</MetadataCanDeleteGPHistory> -->
    <!-- <MetadataStyle isLocked="true">ISO 19115-3 XML Schema Implementation</MetadataStyle> -->
    <!-- <SearchIndexes isLocked="true">\\dataserver1\WorldData_SearchIndex</SearchIndexes> -->
    <!-- <SkipServerConnections isLocked="true">true</SkipServerConnections> -->
  </Catalog>

  <Navigation>
    <!-- <ShowFlashCrosshairs isLocked="true">true</ShowFlashCrosshairs> -->
  </Navigation>

  <Selection>
    <!-- <KeepInvisibleFeaturesSelected isLocked="true">false</KeepInvisibleFeaturesSelected> -->
  </Selection> 

  <Editing>
    <!-- <RequireExplicitStartEditing isLocked="false">false</RequireExplicitStartEditing> -->
    <!-- <ShowSaveDialog isLocked="true">true</ShowSaveDialog> -->
    <!-- <ShowDiscardDialog isLocked="true">true</ShowDiscardDialog> -->
    <!-- <EnforceAttributeValidation isLocked="true">false</EnforceAttributeValidation> -->
    <!-- <WarnOnDelete isLocked="true">true</WarnOnDelete> -->
    <!-- <NewLayersEditable isLocked="true">false</NewLayersEditable> -->
    <!-- <AutoSaveEdits isLocked="true">time,1</AutoSaveEdits> -->
    <!-- <SaveWithProject isLocked="true">false</SaveWithProject> -->
    <!-- <WarnOnDiscardAttribute isLocked="false">apply</WarnOnDiscardAttribute> -->
    <!-- <MoveToolActivationAfterPaste isLocked="true">true</MoveToolActivationAfterPaste> -->
    <!-- <AutoApplyAttributes isLocked="true">true</AutoApplyAttributes> -->
    <!-- <WarnOnDiscardGeometry> </WarnOnDiscardGeometry> -->
  </Editing>

  <Geoprocessing>
    <!-- <AddHistoryItem isLocked="true">true</AddHistoryItem> -->
    <!-- <AddOutputsToMap isLocked="true">true</AddOutputsToMap> -->
    <!-- <EnableUndo isLocked="true">true</EnableUndo> -->
    <!-- <MessageLevelCommandSyntax isLocked="true">true</MessageLevelCommandSyntax> -->
    <!-- <MessageLevelDiagnostics isLocked="true">true</MessageLevelDiagnostics> -->
    <!-- <MessageLevelProjectionTransformation isLocked="true">true</MessageLevelProjectionTransformation> -->
    <!-- <RecordGPHistoryInMetadata isLocked="true">true</RecordGPHistoryInMetadata> -->
    <!-- <RemoveOverwrittenLayers isLocked="true">true</RemoveOverwrittenLayers> -->
    <!-- <ToolParameters><Parameter toolName="calculatefield" toolboxAlias="management" name="expression_type" isLocked="true">ARCADE</Parameter></ToolParameters> -->
  </Geoprocessing>

  <Display>
    <!-- <AntialiasingMode isLocked="true">Fast</AntialiasingMode> -->
    <!-- <TextAntialiasingMode isLocked="true">Force</TextAntialiasingMode> -->
    <!-- <StereoscopicMode isLocked="true">Off</StereoscopicMode> -->
    <!-- <RenderingMode isLocked="true">DirectX</RenderingMode> -->
    <!-- <RenderingQuality isLocked="true">1</RenderingQuality> -->
    <!-- <EnableVSync isLocked="true">true</EnableVSync> -->
    <!-- <EnableRenderingAntialiasing isLocked="true">true</EnableRenderingAntialiasing> -->
    <!-- <LocalCacheFolderPath isLocked="true">C:\Users\<name>\AppData\Local\ESRI\Local Caches</LocalCacheFolderPath> -->
    <!-- <ClearCacheWhenAppClosing isLocked="true">false</ClearCacheWhenAppClosing> -->
    <!-- <UseSquarePrimitive isLocked="true">false</UseSquarePrimitive> -->
  </Display>

  <TextAndGraphics>
    <!-- <DefaultFontName isLocked="true">Tahoma</DefaultFontName> -->
    <!-- <DefaultFontStyle isLocked="false">Regular</DefaultFontStyle> -->
    <!-- <DefaultFontVariationSettings isLocked="true"></DefaultFontVariation> -->
  </TextAndGraphics>

  <ColorManagement>
    <!-- <WorkingColorSpaceForNewItems isLocked="true">CMYK</WorkingColorSpaceForNewItems> -->
    <!-- <EnableColorManagement isLocked="true">true</EnableColorManagement> -->
    <!-- <RGBColorProfile isLocked="true">sRGB IEC61966-2.1</RGBColorProfile> -->
    <!-- <CMYKColorProfile isLocked="true">U.S. Web Coated (SWOP) v2</CMYKColorProfile> -->
    <!-- <ColorConversionRule isLocked="true">PreserveColorValues</ColorConversionRule> -->
    <!-- <RenderingIntent isLocked="true">Perceptual</RenderingIntent>-->
    <!-- <EnableDefaultBlackPointCompensation isLocked="true">false</EnableDefaultBlackPointCompensation> -->
  </ColorManagement>

  <Table>
    <!-- <DisableAddRow isLocked="true">true</DisableAddRow> -->
    <!-- <AllowWebLinks isLocked="true">false</AllowWebLinks> -->
    <!-- <SupportedUriSchemeList isLocked="true">ftp,ftps,html</SupportedUriSchemeList> -->
    <!-- <AllowFileLinks isLocked="true">false</AllowFileLinks> -->
    <!-- <SupportedFileExtensionList isLocked="true">.7z,.csv</SupportedFileExtensionList> -->
    <!-- <FontName isLocked="true">Segoe UI</FontName> -->
    <!-- <FontSize isLocked="true">11</FontSize> -->
  </Table> 

  <Report>
    <!-- <ReportCustomTemplatePath isLocked="true">C:\Users\<name>\Documents\ArcGIS\ReportTemplates</ReportCustomTemplatePath> -->
  </Report> 

  <Layout>
    <!-- <TemplatePath isLocked="true">C:\Users\<name>\AppData\Local\LayoutTemplates</TemplatePath> -->
  </Layout>

  <ShareDownload>
    <!-- <StagingPath isLocked="true">C:\Users\%USERNAME%\AppData\Local\ESRI\ArcGISPro\Staging\SharingProcesses</StagingPath> -->
    <!-- <UnpackingProjectPackageOption isLocked="true">0</UnpackingProjectPackageOption> -->
    <!-- <UnpackingProjectPackagePath isLocked="true">C:\Users\%USERNAME%\Documents\ArcGIS\Packages</UnpackingProjectPackagePath> -->
    <!-- <UnpackingOtherPackagesOption isLocked="true">0</UnpackingOtherPackagesOption> -->
    <!-- <UnpackingOtherPackagesPath isLocked="false">C:\Users\%USERNAME%\Documents\ArcGIS\Packages</UnpackingOtherPackagesPath> -->
    <!-- <OfflineMapsOption isLocked="true">0</OfflineMapsOption>-->
    <!-- <OfflineMapsPath isLocked="true">C:\Users\%USERNAME%\Documents\ArcGIS\OfflineMaps</OfflineMapsPath> -->
    <!-- <MapLayerPresetsPath isLocked="false">C:\Users\%USERNAME%\AppData\Roaming\Esri\ArcGISPro\ExportPresets</MapLayerPresetsPath> -->
  </ShareDownload> 

  <Authentication>
    <!-- <AuthConnection isLocked="true"> -->
      <!-- <Name>Connection1Name</Name> -->
      <!-- <Type>MicrosoftEntraID</Type> -->
      <!-- <Environment>AzureGlobal</Environment> -->
      <!-- <TenantID>example.domain.com</TenantID> -->
      <!-- <ClientID>123456789</ClientID> -->
    <!-- </AuthConnection> -->  
  </Authentication> 

  <GeodatabaseReplication>
    <!-- <LogFilePath isLocked="true">C:\Users\%USERNAME%\AppData\Local\ESRI\ProReplicaActivityLog.dat</LogFilePath> -->
    <!-- <LogLevel isLocked="true">Debug</LogLevel> -->
  </GeodatabaseReplication> 

</ArcGISProSettings>
Attention :

Lors de l’enregistrement du fichier Pro.settingsConfig, vérifiez que votre éditeur de texte ou éditeur XML n’ajoute pas une extension .txt ou .xml à la fin du nom de fichier. En effet, ces extensions de fichier empêchent ArcGIS Pro de charger correctement le fichier.

Déployer Pro.settingsConfig

Après avoir créé un fichier Pro.settingsConfig, vous devez le déployer à un emplacement accessible à toutes les machines client ArcGIS Pro. Il s’agit généralement d’un partage de fichiers sur un serveur. Vous pouvez toutefois placer le fichier sur le disque local de la machine client si cet emplacement se prête à votre cas.

Sur le partage ou le dossier qui héberge Pro.settingsConfig, définissez des autorisations de fichier en lecture/écriture pour l’administrateur qui a créé le fichier et en lecture seule pour les utilisateurs des machines client ArcGIS Pro. En l’absence d’autorisations adéquates, il est possible aux utilisateurs de modifier les valeurs définies dans le fichier Pro.settingsConfig, et ainsi de changer les valeurs par défaut et les paramètres verrouillés pour tous les utilisateurs.

Par exemple, sur un serveur de fichiers auquel toutes les machines client ArcGIS Pro ont accès, créez un partage de type \\dataserver1\ProSettings. Définissez des autorisations d’accès en lecture seule au partage Pro.settingsConfig pour les utilisateurs des machines client, puis copiez le fichier Pro.settingsConfig dans le partage.

Vous pouvez mettre à jour le fichier Pro.settingsConfig déployé selon l’évolution des besoins de votre organisation. Pour modifier la structure de contrôle des paramètres, mettez à jour le fichier partagé ou remplacez-le par un nouveau fichier. Les machines client ArcGIS Pro commenceront à utiliser le nouveau fichier lors du prochain démarrage de ArcGIS Pro sur les machines.

Configurer les machines des utilisateurs pour l’utilisation du fichier Pro.settingsConfig

En matière de contrôle des paramètres d’utilisateur, la dernière étape consiste à configurer chaque machine client ArcGIS Pro de sorte qu’elle puisse utiliser le fichier Pro.settingsConfig à partir de l’emplacement de son déploiement. Une fois configurée, la machine client vérifie le fichier à chaque démarrage de l’application ArcGIS Pro, modifiant les paramètres de l’utilisateur en conséquence.

Il existe deux manières de configurer les machines client pour qu’elles utilisent le fichier. Dans un cas comme dans l’autre, vous devez indiquer le chemin du partage réseau ou du dossier local dans lequel se trouve le fichier Pro.settingsConfig déployé.

La première manière, et la plus simple, consiste à définir le paramètre de ligne de commande ADMIN_SETTINGS_PATH pendant une installation de ArcGIS Pro en mode silencieux.

La deuxième manière de configurer les machines client consiste à éditer le Registre Windows. Optez pour cette méthode si ArcGIS Pro est déjà déployé, ou si vous ne souhaitez pas effectuer une installation en mode silencieux. Pour configurer les machines client, créez une valeur de chaîne nommée AdminSettingsPath dans HKEY_LOCAL_MACHINE\SOFTWARE\ESRI\ArcGISPro\Settings. Définissez les données de la valeur sur le chemin du partage réseau ou du dossier local dans lequel se trouve le fichier Pro.settingsConfig déployé. Suivant l’exemple ci-dessus, vous devez définir les données de la valeur sur \\dataserver1\ProSettings.

Lorsque vous utilisez le paramètre d’installation ADMIN_SETTINGS_PATH ou créez l’entrée AdminSettingsPath dans le Registre, le paramètre est stocké dans la ruche de registre HKEY_LOCAL_MACHINE. Il est nécessaire d’avoir des autorisations d’administration sur la machine pour modifier la valeur. Le paramètre est ainsi sécurisé, ce qui empêche les utilisateurs non-administrateurs de refuser le contrôle des paramètres défini par leur administrateur.

Lors de la configuration des machines via le registre, il est préférable d’utiliser un outil de déploiement système pour ne pas avoir à modifier manuellement chaque machine avec regedit.exe. Parmi les outils de déploiement système courants, citons Windows Active Directory Group Policy, Microsoft SCCM et Microsoft PowerShell DSC. Vous trouverez des instructions détaillées pour installer et configurer ArcGIS Pro avec ces outils dans le document technique ArcGIS 10.8, ArcGIS Pro 2.5, and ArcGIS Earth 1.10 Enterprise Deployment.

Verrouillage des paramètres et priorité des valeurs par défaut

Le mécanisme de contrôle des paramètres permet aux administrateurs à la fois de fournir les valeurs par défaut des paramètres et de verrouiller les paramètres à ces valeurs.

Le verrouillage des paramètres est régi par l’attribut XML isLocked. Lorsque cet attribut est défini sur true, l’utilisateur de la machine client ArcGIS Pro ne peut pas modifier la valeur du paramètre. Le paramètre est verrouillé à la valeur définie par l’administrateur dans le fichier Pro.settingsConfig.

Exemple : paramètre EnableIndexing

<EnableIndexing isLocked="true">false</EnableIndexing>

Dans cet exemple, l’élément EnableIndexing correspond au bouton bascule Index items (Indexer les éléments), accessible en cliquant sur Settings (Paramètres) dans la page de démarrage ou l’onglet Project (Projet), puis en cliquant sur Options (Options) > Indexing (Indexation). EnableIndexing est défini sur false, qui définit le bouton bascule Index items (Indexer les éléments) sur la position Off (Désactivé). L’attribut isLocked étant défini sur true, l’application désactive le contrôle et affiche un message indiquant que le paramètre a été verrouillé.

Paramètres d’indexation dans l’onglet Indexing (Indexation) de la boîte de dialogue Options (Options)

Si vous définissez l’attribut isLocked sur false, vous pouvez contrôler le paramètre par défaut, mais les utilisateurs peuvent le modifier si nécessaire.

Exemple : paramètre UseLocalHelp

<UseLocalHelp isLocked="false">true</UseLocalHelp>

Dans cet exemple, l’élément UseLocalHelp correspond au paramètre Help Source (Source d’aide) auquel vous avez accès en cliquant sur Settings (Paramètres) dans la page de démarrage ou l’onglet Project (Projet), puis en cliquant sur Options > General (Général). UseLocalHelp est défini sur true, si bien que les nouvelles installations de ArcGIS Pro sont définies par défaut sur Offline help from your computer (Aide hors connexion depuis votre ordinateur). Étant donné que l’attribut isLocked est défini sur false, l’utilisateur peut modifier ultérieurement le paramètre s’il le souhaite.

Paramètres Help Source (Source d’aide) dans l’onglet General (Général) de la boîte de dialogue Options

Remarque :

Les valeurs par défaut des paramètres déverrouillés sont utilisées uniquement par les nouvelles installations de ArcGIS Pro. Si vous configurez une machine de sorte qu’elle utilise un fichier Pro.settingsConfig une fois que l’utilisateur a exécuté ArcGIS Pro, les valeurs par défaut définies dans le fichier ne sont pas utilisées puisque l’utilisateur a déjà établi les valeurs par défaut standard. Vous pouvez forcer les paramètres en définissant isLocked="true" dans le fichier Pro.settingsConfig.

De plus, si un paramètre d’application correspond à une option pouvant être réinitialisée dans la boîte de dialogue Options, le paramètre dans le fichier Pro.settingsConfig est appliqué lorsque l’utilisateur clique sur Reset (Réinitialiser) Réinitialiser.

Supprimer les paramètres d’application

Pour supprimer les paramètres d’application d’une machine, supprimez la valeur du Registre AdminSettingsPath dans HKEY_LOCAL_MACHINE\SOFTWARE\ESRI\ArcGISPro\Settings. La session ArcGIS Pro suivante reflète les paramètres d’application par défaut.

Paramètres de l’application disponible

La rubrique Paramètres disponibles pour le contrôle par les administrateurs fournit une liste complète des paramètres d’application et indique leur emplacement dans le fichier Pro.settingsConfig.