Configuration de l’administrateur

En tant qu’administrateur, vous pouvez configurer des paramètres dans ArcGIS Online et ArcGIS Enterprise ou via le fichier de configuration pour que ArcGIS Earth respecte les exigences de votre organisation. Vous pouvez accéder à la page ArcGIS Earth Sample Configuration File et télécharger le fichier exemple. Une fois l’installation effectuée, le fichier de configuration se trouve dans le répertoire d’installation de l’application, qui est généralement le dossier C:\Program Files\ArcGIS\ArcGIS Earth\bin.

Pour configurer les paramètres de l’application avec un fichier de configuration, gardez les points suivants à l’esprit :

• Vous pouvez prédéfinir des paramètres de configuration et importer le fichier config.xml modifié lors de l’installation.
• Le fichier de configuration est un fichier .xml qui peut être modifié selon vos besoins. Par exemple, lorsque vous mettez à jour le fichier, utilisez & à la place de & pour indiquer un caractère d’échappement. Assurez-vous que le fichier de configuration reste codé en UTF-8 une fois qu’il a été mis à jour.
• Les configurations prédéfinies par l’administrateur sont automatiquement chargées lorsque vous lancez l’application pour la première fois.
• Vous pouvez adopter les paramètres configurés par l’administrateur dans le dossier de groupe en cliquant sur Reset (Réinitialiser) dans la section Settings (Paramètres) de l’application.
• Dans le cas d’une installation par utilisateur de ArcGIS Earth, vous pouvez également mettre à jour le fichier de configuration dans le répertoire d’installation de l’application (par exemple, C:\Users\username\AppData\Roaming\ESRI\ArcGISEarth).

Configurations d’organisation

Certains paramètres de ArcGIS Earth utilisent les configurations d’organisation de votre compte de portail ArcGIS Online ou ArcGIS Enterprise. Ces paramètres comprennent le fond de carte, le service d’élévation et le service de géocodage utilisés par ArcGIS Earth. Reportez-vous aux rubriques Définir la bibliothèque de fonds de carte et le fond de carte par défaut, Services utilitaires et Géocodage pour plus de détails si vous vous connectez à ArcGIS Enterprise. Si vous vous connectez à ArcGIS Online, reportez-vous à la rubrique Initiation aux tâches administratives pour plus d’informations.

Paramètres de l’application configurables

Les administrateurs peuvent utiliser le fichier de configuration pour modifier des paramètres sans devoir recompiler l’application. Vous pouvez également définir les règles qui affectent la manière dont ArcGIS Earth s’exécute sur votre machine. Les administrateurs peuvent accéder au fichier config.xml dans le répertoire d’installation et spécifier des valeurs pour certains attributs afin de personnaliser un paramètre de démarrage préféré en modifiant des paramètres configurables.

Les paramètres configurables de l’application sont décrits dans les tableaux ci-dessous.

Paramètres généraux de l’application

Paramètre	Description
workspace	Spécifie le répertoire de l’espace de travail et indique si l’espace de travail courant est automatiquement enregistré à la fermeture.
startupView	Permet de personnaliser (Custom) la vue de démarrage ou de commencer là où vous en étiez précédemment (History).
spatialReference	Définit la référence spatiale utilisée par ArcGIS Earth comme Web Mercator ou WGS84. La valeur par défaut est Web Mercator. Remarque : ArcGIS Earth utilise le moteur de projection GDAL, qui se trouve généralement dans le dossier C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\pedata du répertoire d’installation de l’application. Le module d’extension de données du moteur de projection peut être téléchargé via Données du moteur de projection ArcGIS Developer. Extrayez le contenu téléchargé dans le répertoire du moteur de projection ArcGIS Earth, puis redémarrez ArcGIS Earth. Le moteur de projection approprié est alors utilisé. Si vous obtenez un avertissement indiquant l’existence d’un fichier en double, ignorez-le ou remplacez le fichier. Les données du moteur de projection ne seront pas disponibles si ArcGIS Earth est installé directement à partir de Microsoft Store.
isAutoFitWindow	Définissez la valeur sur True si vous souhaitez que la taille de la fenêtre contextuelle s’adapte automatiquement au contenu. La valeur par défaut est False.
isShowInExternalBrowser	Affiche les liens HTML dans la fenêtre contextuelle avec un navigateur externe. La valeur par défaut est False.
isShowStartupTips	Affiche des conseils au démarrage de l’application. La valeur par défaut est True. Conseil : Les administrateurs peuvent personnaliser le contenu des conseils au démarrage en mettant à jour les fichiers HTML dans le dossier tips du répertoire d’installation de l’application.
language	Définit la langue d’affichage pour le texte de l’interface utilisateur de ArcGIS Earth. La valeur par défaut est System. Si la valeur est System, ArcGIS Earth adopte le paramètre de langue d’affichage de Windows.
flyto	Définit la vitesse de survol entre 0 et 100 ; la vitesse par défaut est de 50. Active automatiquement un zoom sur une nouvelle couche. La valeur par défaut est True. Définit l’angle de zoom sur la couche sur Default ou None. La valeur par défaut est Default.
mouseWheel	Définit la vitesse de la molette de la souris entre 0 et 100, ainsi que la direction du zoom contrôlé par la molette sur Forward ou Backward. La valeur par défaut est Forward.
navigatorMode	Définit le mode de fonctionnement du navigateur à l’écran sur Default, Expanded ou Collapsed. La valeur par défaut est Default.
continuousPanning	Active (True) ou désactive (False) le déplacement continu. La valeur par défaut est True.
nonMouseController	Active la navigation dans ArcGIS Earth avec un contrôleur autre que la souris.
atmosphere	Fait passer l’atmosphère à None, Horizon Only ou Realistic. La valeur par défaut est Horizon Only.
elevationExaggeration	Définit la valeur d’exagération de l’élévation du terrain. La valeur par défaut est 1.
elevationExaggerationMin	Définit la valeur minimale autorisée pour l’exagération de l’élévation. La valeur par défaut est 0.
elevationExaggerationMax	Définit la valeur maximale autorisée d’exagération de l’élévation. La valeur par défaut est 100. Toute valeur excédant 1 000 est limitée à 1 000. Remarque : La valeur maximale de l’exagération de l’élévation est mise à jour dans l’interface utilisateur une fois qu’une nouvelle valeur elevationExaggerationMax est appliquée.
undergroundNavigation	Active l’exploration souterraine des données. La valeur par défaut est Off.
groundTransparency	Ajuste la transparence du sol. La valeur par défaut est 0.
grid	Spécifiez le type de grille ainsi que son symbole de ligne et son style d’étiquette.
location	Spécifie l’unité d’emplacement par défaut. La valeur par défaut est DMS.
distance	Spécifie l’unité de distance par défaut. La valeur par défaut est Meters.
elevation	Spécifie l’unité d’élévation par défaut. La valeur par défaut est Meters.
area	Spécifie l’unité de surface par défaut. La valeur par défaut est SquareMeters.
heading	Définit le type de notation des angles de direction (angles de 0 à 360 ou de -180 à +180). La valeur par défaut est 360.
isLongitudeFront	Inverse l’ordre latitude-longitude des coordonnées sur la recherche et l’affichage. La valeur par défaut est True.
proxy	Définit l’utilisation du proxy (booléen, facultatif). La valeur par défaut est False.
historicalImagery	Définit les URL des sources d’imagerie personnalisées pour Historical Imagery explorer (Explorateur d’imagerie historique). Si l’attribut sélectionné est défini sur True (Vrai), la source est sélectionnée dans la liste et utilisée dans l’outil Historical Imagery (Imagerie historique). Exemple : <historicalImagery> <customImagerySources> <source selected="True">yourImageServerURL</source> </customImagerySources> </historicalImagery

Paramètres de l’administrateur de l’application

Paramètre	Description
autoUpdate	Si ce paramètre est défini sur False, l’utilisateur ne voit rien lié à l’outil de mise à jour dans ArcGIS Earth. La valeur CheckOnStartup dans ce paramètre sert à rechercher les mises à jour d’ArcGIS Earth au moment du lancement de l’application. La valeur par défaut est True. Exemple : <autoUpdate enable="True"> <checkOnStartup>True</checkOnStartup> </autoUpdate>
isDefaultKmlViewer	Définit ArcGIS Earth comme la visionneuse KML par défaut. La valeur par défaut est False.
isDefaultMspkViewer	Définit ArcGIS Earth comme la visionneuse de paquetage de couche de scène mobile par défaut. La valeur par défaut est True.
enableHtmlWindow	Active la fenêtre HTML. La valeur par défaut est False.
enableTableDataExport	Permet d’exporter les données d’une couche d’entités en tant que données KMZ dans la table attributaire. La valeur par défaut est True.
blockArcGISOnline	Bloque les requêtes et les connexions au portail vers ArcGIS Online au démarrage de ArcGIS Earth. La valeur par défaut est False.
findInTOC	Permet de contrôler si le KML sélectionné sur la scène sera automatiquement mis en surbrillance ou non dans la table des matières.
survey123APIUrl	Par défaut, ArcGIS Earth privilégie l’utilisation de l’URL d’enquête configurée dans le portail. Si aucune URL spécifique n’est définie sur le portail, ArcGIS Earth utilise l’URL suivante : https://survey123.arcgis.com/api/jsapi. Les utilisateurs qui ont déployé leur propre API Survey123 ou qui utilisent la version bêta de Survey123 peuvent spécifier une URL d’API personnalisée dans le fichier de configuration de ArcGIS Earth. Si une URL d’enquête personnalisée est définie dans le fichier de configuration, ArcGIS Earth remplace les paramètres par défaut et utilise à la place l’URL spécifiée par l’utilisateur.
portals	Définit l’URL du portail sur la connexion cible de ArcGIS Earth. Conseil : Si l’administrateur répertorie plusieurs URL de portail dans le fichier de configuration, ArcGIS Earth utilise le premier portail comme portail actif après l’installation.
disableAddPortal	Empêche les utilisateurs d’ajouter de nouvelles connexions au portail ou en ligne dans le gestionnaire de portail. La valeur par défaut est False. Conseil : Si elle est définie sur True, le bouton Add Portal (Ajouter un portail) dans le volet Portal Manager (Gestionnaire de portail) est inaccessible et l’utilisateur ne peut pas ajouter une nouvelle connexion au portail ou en ligne via Portal Manager (Gestionnaire de portail)​. L’utilisateur peut changer de connexion au portail en choisissant parmi les portails de préconfiguration affichés dans Portal Manager (Gestionnaire de portail).
fonts	Spécifie la police des étiquettes de l’élément de dessin. Remarque : Utilisez le nom de police figurant dans le fichier de polices comme valeur d’élément et assurez-vous que le fichier de polices est installé sur votre système d’exploitation.
log	Enregistre les informations des journaux dans le dossier ESRI\ArcGISEarth\logs à partir du répertoire AppData d’un utilisateur (par exemple, C:\Users\username\AppData\Roaming). La valeur maximale de la taille de chaque journal est égale à 10 000 et le nombre maximal de fichiers journaux à stocker est de 1 000.
startupLayers	Définit les couches de démarrage dans la table des matières, configure le nom, l’URL, le type et la visibilité, et organise les couches de démarrage en groupes hiérarchiques. Conseil : Les couches de démarrage prennent en charge les données de type services ArcGIS, KML et KMZ, WMS et ses sous-couches, WFS et ses sous-couches, GeoJSON, shapefile, raster, paquetage de tuiles, paquetage de couches de scène, paquetage de scènes mobiles, scène Web et carte Web. Le fichier de configuration est un fichier .xml qui peut être personnalisé selon vos besoins. Il doit respecter la spécification XML. Par exemple, lors de la spécification d’URL dans une balise d’URL, les caractères spéciaux tels que & doivent être précédés des caractères d’échappement &amp; pour respecter les règles de syntaxe XML. Après toute modification, assurez-vous que le fichier est enregistré avec l’encodage UTF-8. Lors de la configuration de sous-couches de WMS, les valeurs du nom et du titre doivent correspondre exactement aux nom et titre de couche correspondants définis dans le document des fonctionnalités de service WMS. Ces valeurs servent d’identifiants uniques et doivent respecter la configuration du service. Les sous-couches doivent faire référence à des couches réelles et non des nœuds de dossier. En d’autres termes, elles doivent pointer vers des nœuds feuille qui représentent des couches dessinables et non des conteneurs de couches supplémentaires. L’icône d’avertissement indique qu’il manque le chemin, ou que les données sont endommagées ou inaccessibles. Les couches de démarrage avec des états invisibles ne sont pas chargées au démarrage tant qu’elles ne sont pas activées dans la table des matières.
organizationalBasemaps	Définit les fonds de carte pour votre organisation. Conseil : Les couches de fond de carte des organisations prennent en charge les données de type KML et KMZ, WMS, raster, paquetage de tuiles, paquetage de couches de scène et services ArcGIS. Dans chaque élément <basemap>, vous pouvez spécifier une ou plusieurs couches à l’aide de nœuds <baseLayers> ou <referenceLayers>. Exemple : <basemap name="basemap_wms_with_desired_layers"> <baseLayers> <layer type="WMS" url="http://myservername.esri.com/someservice/servicename/MapServer/WMSServer"> <layer name="wms_layer_name_1(required)" title="wms_layer_title_1(required)"/> <layer name="wms_layer_name_2(required)" title="wms_layer_title_2(required)"/> </layer> </baseLayers> </basemap>
organizationalTerrains	Configure des terrains pour votre organisation. Conseil : Les couches de terrain de l’organisation prennent en charge les données de type raster local et service d’imagerie d’élévation. Pour plus d’informations, reportez-vous à la rubrique Fond de carte et terrain.
positionServiceUrl	Permet à un administrateur de saisir une URL avec certaines valeurs codées, qui seront reconnues par ArcGIS Earth et renseignées par des informations de localisation. Lorsque vous utilisez Ctrl+clic droit sur le globe, l’URL est appelée et la latitude, la longitude et l’élévation du point sur lequel vous avez cliqué sont transmises à cette URL. Tant que l’URL renvoie un fichier .kml valide, le fichier .kml s’affiche dans la fenêtre. Pour voir un exemple, lisez le blog ArcGIS Point Based Service access with ArcGIS Earth. urlwithpos : configure l’attribut clé sur l’élément add sous l’élément ServiceURL pour activer cette entité. urlwithoutpos : configure les informations qui seront lues par ArcGIS Earth. Ces informations sont un fichier .kml renvoyé par l’appel de service sans être stocké sur le disque.
localKmlIcons	Permet d’accéder au dossier des icônes KML natives ou désigne un dossier d’icônes personnalisé. Conseil : Si l’option a pour valeur False, ArcGIS Earth utilise les icônes KML de google.com. Si elle a pour valeur True, ArcGIS Earth utilise les icônes KML locales. Si la valeur directory est vide, ArcGIS Earth utilise les icônes KML locales du dossier \resources\symbols\kml dans le répertoire d’installation, généralement C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\. Si vous devez pointer sur un dossier d’icônes KML personnalisées (par exemple, les icônes KML personnalisées se trouvent dans le dossier C:\myIcons\kml), la valeur de directory doit être définie sur C:\myIcons pour inclure le dossier kml.
directoryStyleLink	Active l’adresse URL dans les fichiers de styles du dictionnaire Esri, ou personnalise l’URL et affiche le texte sur l’interface utilisateur. Par défaut, l’URL de l’hyperlien est désactivée. Conseil : Si les utilisateurs se situent derrière un pare-feu, l’administrateur peut télécharger les fichiers du dictionnaire à partir de la page Esri Styles et les enregistrer dans un répertoire partagé, activer l’hyperlien et mettre à jour l’adresse URL sur le répertoire local pour que les utilisateurs puissent accéder à votre organisation.
acknowledgement	Spécifie le texte d’affichage et l’adresse URL des remerciements.
help	Spécifie le texte d’affichage et l’adresse URL de l’aide.
submitFeedback	Spécifie le texte d’affichage et l’adresse URL pour l’envoi de commentaires.
bannerSettings	Spécifie le texte d’affichage, le style de texte, le style de police et l’alignement de la bannière.
automationAPI	Spécifie le paramètre API d’automatisation dans ArcGIS Earth. autoStart : active l’API d’automatisation de ArcGIS Earth au démarrage de ArcGIS Earth. La valeur par défaut est False.

Remarque :

• Le format du fichier de configuration a été mis à jour à partir de la version 1.10. La version précédente de config.xml offre une compatibilité ascendante, mais elle ne fait plus l’objet d’une maintenance ou de mises à jour dans les nouvelles versions du produit.
• Une fois les paramètres utilisateur modifiés dans l’interface utilisateur Settings (Paramètres) de ArcGIS Earth, l’application lit ces paramètres dans le fichier de configuration dans C:\Users\<username>\AppData\Roaming\Esri\ArcGISEarth. Même si les paramètres d’administration sont toujours stockés dans le répertoire d’installation ou dans un répertoire spécifique défini via le gestionnaire de configuration sous Advanced settings (Paramètres avancés), l’application lit les paramètres d’administration à ces emplacements.