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 lorsqu’un utilisateur lance l’application pour la première fois.
• Les utilisateurs peuvent adopter les paramètres configurés par l’administrateur dans le dossier bin en cliquant sur Reset (Réinitialiser) dans la section Settings (Réglages) de l’application.
• Dans le cas d’une installation par utilisateur de ArcGIS Earth, vous pouvez également rechercher et 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, Configurer un service d’élévation par défaut et Géocodage pour plus de détails si vous vous connectez à ArcGIS Enterprise. Reportez-vous à la rubrique Administrer une organisation pour plus de détails si vous vous connectez à ArcGIS Online.

Paramètres de l’application configurables

Les administrateurs peuvent utiliser le fichier de configuration pour modifier des paramètres sans devoir recompiler l’application. Les utilisateurs peuvent également définir les stratégies qui affectent la manière dont ArcGIS Earth s’exécute sur leur 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.

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

Paramètre	Description
enableCheckForUpdates	Active la recherche des mises à jour de ArcGIS Earth. La valeur par défaut est False.
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	Vous permet de personnaliser (Custom (Personnalisé)) la vue de démarrage ou de commencer là où vous avez quitté (History (Historique)).
spatialReference	Définit la référence spatiale utilisée par ArcGIS Earth comme Web Mercator ou WGS84. Il s'agit par défaut de 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.
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 (Système). Si la valeur est System (Système), 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 entre Default (Par défaut) et None (Aucun). La valeur par défaut est Default (Par défaut).
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 l’avant ou l’arrière. La valeur par défaut est Forward (Avant).
navigatorMode	Définit le mode de fonctionnement du navigateur à l’écran entre Default (Par défaut), Expanded (Développée) et Collapsed (Réduit). La valeur par défaut est Default (Par défaut).
continuousPanning	Active (True (Vrai)) ou désactive (False (Faux)) 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 basculer l’effet Atmosphère entre Aucun, Horizon uniquement et Réaliste. La valeur par défaut est Horizon uniquement.
elevationExaggeration	Définit la valeur d’exagération de l’élévation du terrain. La valeur par défaut est 1.
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	Définit l’activation de la navigation dans les données souterraines et la configuration de la transparence du sol. La valeur par défaut est Off (Désactivé).
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 (Mètres).
area	Spécifie l’unité de surface par défaut. La valeur par défaut est SquareMeters (MètresCarrés).
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.
address	Spécifie l’adresse du serveur proxy.
username	Spécifie le nom d’utilisateur du serveur proxy.
password	Spécifie le mot de passe du serveur proxy.

Paramètres de l’administrateur de l’application

Paramètre	Description
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.
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/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).
popup	Définit le mode de redimensionnement et la taille des fenêtres contextuelles. La valeur par défaut de size fixed est True (Vrai) et les valeurs par défaut de width et height sont 300 et 420. Définissez la valeur False (Faux) pour size fixed afin d’activer le mode de redimensionnement des fenêtres contextuelles. Remarque : Les valeurs minimales de la fenêtre contextuelle width et height sont égales à 300 px et 420 px. La valeur maximale de la taille des fenêtres contextuelles ne peut pas être supérieure à la taille des fenêtres de ArcGIS Earth.
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/KMZ, WMS et ses sous-couches, WFS et ses sous-couches, GeoJSON, shapefile, raster, paquetage de tuiles, paquetage de couche de scène, paquetage de scène mobile, scène Web et carte Web. L’icône d’avertissement indique que le chemin est manquant 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/KMZ, WMS, raster, paquetage de tuiles, paquetage de couche de scène et services ArcGIS.
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. Lisez un exemple issu du 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 la valeur False est définie, ArcGIS Earth utilise les icônes KML de google.com. Si la valeur est 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	Définit l’adresse URL sur 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 : Dans le cas d’utilisateurs situés 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 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 que les paramètres utilisateur ont été 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.