Gérer les compléments

Un complément est une fonctionnalité personnalisée créée par des développeurs ou des utilisateurs avec ArcGIS Pro SDK 3.0 for .NET. Les compléments s’intègrent parfaitement avec ArcGIS Pro. Dans de nombreux cas, les compléments personnalisent l’interface utilisateur. Ils fournissent un nouvel outil, ou un jeu d’outils, qui apparaît sur l’onglet de ruban Add-In (Complément) ou sur d’autres onglets, ou dans d’autres zones de l’application comme les fenêtres personnalisées.

Remarque :

ArcGIS Pro 3.0 et les versions ultérieures chargent uniquement les compléments qui ont été compilés avec ArcGIS Pro SDK 3.0 et les versions ultérieures. Voir la section Schéma de chargement des compléments pour plus d’informations.

Lorsque le complément MagnifierWindow est installé, un outil personnalisé apparaît sur l'onglet Complément. L’outil vous permet de vous déplacer et de zoomer sur une deuxième fenêtre dans une vue cartographique.

Un complément est empaqueté sous forme de fichier compressé unique avec l’extension .esriAddInX. Il s’agit d’un type de fichier simple qui peut être envoyé par courrier électronique, téléchargé depuis un portail ou échangé comme d’autres fichiers ordinaires.

Vous pouvez installer les compléments dans un dossier local par défaut avec un utilitaire d’installation ou les charger depuis un dossier désigné en tant que dossier connu. Les deux méthodes sont décrites dans les sections ci-après. Vous pouvez afficher et supprimer les compléments dans Add-In Manager (Gestionnaire de compléments) sur la page Settings (Paramètres) d'ArcGIS Pro.

Les compléments fournissent des fonctions uniques, mais peuvent également introduire des risques de sécurité ou entraîner un comportement instable du logiciel. Il est important de connaître et d’approuver la source d’un complément.

Pour créer vos propres compléments, vous avez besoin d'ArcGIS Pro SDK. Le site ArcGIS Developer dispose de didacticiels pour vous aider à concevoir votre premier complément.

Installer un complément avec l’utilitaire d’installation

Lorsque vous installez un complément avec l’utilitaire d’installation, le complément est copié dans cet emplacement par défaut : %System Drive%\Users\<username>\Documents\ArcGIS\AddIns\ArcGISPro. Avant de copier le fichier, l’utilitaire vérifie qu’une version plus récente du complément ne se trouve pas déjà à l’emplacement.

1. Accédez à l’emplacement de dossier d’un fichier de complément (*.esriAddInX) sur votre ordinateur ou sur un lecteur réseau.
2. Double-cliquez sur le fichier pour ouvrir la fenêtre Esri ArcGIS Add-In Installation Utility (Utilitaire d’installation des compléments Esri ArcGIS).

   Examinez les informations de la fenêtre Esri ArcGIS Add-In Installation Utility (Utilitaire d’installation des compléments Esri ArcGIS).

3. Pour continuer, cliquez sur Install Add-In (Installer un complément).

   Le complément est copié à l’emplacement par défaut et installé. Une copie du fichier reste à l’emplacement dans lequel vous l’avez recherché.

4. Si ArcGIS Pro est ouvert, quittez et redémarrez l’application.

   Le complément est maintenant prêt à être utilisé.

Charger un complément à partir d’un dossier connu

Vous pouvez désigner un dossier local ou réseau en tant qu’emplacement connu pour les compléments. Au démarrage, ArcGIS Pro vérifie ce dossier et charge automatiquement les compléments qu’il trouve à l’intérieur.

La désignation d’un dossier connu sur un lecteur réseau permet à différentes personnes dans un espace de travail d’utiliser les mêmes compléments. Cela peut en revanche ralentir le démarrage d'ArcGIS Pro. Si vous utilisez un dossier réseau, il est recommandé d’utiliser un sous-dossier du dossier racine ; ce sous-dossier ne devant contenir que des fichiers de compléments.

1. Ouvrez la page Settings (Paramètres) d'ArcGIS Pro.
   • Dans la page de démarrage ArcGIS Pro, cliquez sur l’onglet Settings (Paramètres) .
   • Dans un projet ouvert, cliquez sur l’onglet Project (Projet) sur le ruban.
2. Dans la liste d’onglets sur la gauche, cliquez sur Add-In Manager (Gestionnaire de compléments).
3. Sur l’onglet Add-In Manager (Gestionnaire de compléments), cliquez sur Options.
4. Sur l’onglet Options, cliquez sur Add Folder (Ajouter un dossier).
5. Dans la boîte de dialogue de navigation, accédez au dossier que vous voulez désigner comme dossier connu.
6. Cliquez sur le dossier pour le sélectionner. Cliquez sur  OK.

   

   Le chemin d’accès complet au dossier apparaît dans la liste des dossiers connus.

   Remarque :

   Par défaut, l’option sélectionnée permet de charger tous les compléments qui se trouvent dans le dossier connu. Vous pouvez changer d’option si vous souhaitez charger uniquement les compléments fournis par Esri ou uniquement ceux qui sont signés numériquement par un éditeur approuvé.

7. Quittez ArcGIS Pro.
8. Utilisez l’Explorateur Windows pour copier un ou plusieurs fichiers .esriAddInX dans le dossier connu à son emplacement sur le disque.
9. Démarrez ArcGIS Pro.

   Les compléments dans le dossier connu sont chargés. Les compléments récemment ajoutés ou supprimés sont recherchés dans le dossier chaque fois que vous démarrez ArcGIS Pro.

   Conseil :

   Pour ne plus utiliser un dossier connu, cliquez sur le dossier dans la liste des dossiers connus et sélectionnez Remove Folder (Supprimer un dossier). Redémarrez ArcGIS Pro.

Afficher les compléments

Vous pouvez voir les compléments disponibles dans Add-In Manager (Gestionnaire de compléments).

1. Ouvrez la page Settings (Paramètres) de ArcGIS Pro :
   • Dans la page de démarrage ArcGIS Pro, cliquez sur l’onglet Settings (Paramètres) .
   • Dans un projet ouvert, cliquez sur l’onglet Project (Projet) sur le ruban.
2. Dans la liste d’onglets sur la gauche, cliquez sur Add-In Manager (Gestionnaire de compléments).
3. Sur l’onglet Add-Ins (Compléments), sous My Add-Ins (Mes compléments), cliquez sur un complément pour consulter ses informations.

   

Supprimer un complément

Si vous n’avez plus besoin d’un complément, vous pouvez le supprimer de la fenêtre Add-In Manager (Gestionnaire de compléments). Lorsque vous supprimez un complément installé, il est désinstallé d'ArcGIS Pro et le fichier .esriAddInX est déplacé vers la corbeille du système.

Attention :

Si vous utilisez Add-In Manager (Gestionnaire de compléments) pour supprimer un complément qui est chargé depuis un dossier connu sur un lecteur réseau, le fichier .esriAddInX est supprimé définitivement, comme ce serait le cas si vous utilisiez l’Explorateur Windows pour supprimer le fichier de son emplacement sur le disque.

1. Ouvrez Add-In Manager (Gestionnaire de compléments) et sélectionnez un complément selon la description donnée à la section Afficher les compléments ci-dessus.
2. Cliquez sur Delete this Add-In (Supprimer ce complément).

   

   Le complément est marqué comme devant être supprimé, mais reste disponible dans votre session ArcGIS Pro actuelle.

   

3. Quittez et redémarrez ArcGIS Pro.

   Le complément est désinstallé et supprimé de Add-In Manager (Gestionnaire de compléments).

   Remarque :

   Vous ne pouvez pas supprimer les compléments qui s’affichent sous l’en-tête Shared Add-Ins (Compléments partagés) de la fenêtre Add-In Manager (Gestionnaire de compléments) car ils sont gérés par votre adminstrateur de logiciels. Pour en savoir plus, consultez la section Créer des paramètres d’administration ci-dessous.

Désactiver les compléments

Si ArcGIS Pro se comporte de façon inattendue ou arrête de fonctionner après l’installation de compléments, vous pouvez désactiver les compléments en démarrant ArcGIS Pro depuis l’invite de commande Windows avec un paramètre spécial. Si le logiciel se comporte normalement lorsque les compléments sont désactivés, vous devez peut-être en supprimer un ou plusieurs.

Pour désactiver les compléments, démarrez ArcGIS Pro à partir de la ligne de commande avec la commande suivante :

"%ProgramFiles%\ArcGIS\Pro\bin\ArcGISPro.exe" /disableaddins

Aucun complément n’apparaît dans la fenêtre Add-In Manager (Gestionnaire de compléments). Pour réactiver les compléments, quittez et redémarrez ArcGIS Pro normalement.

Créer des paramètres d’administration

En tant qu’administrateur des logiciels, vous pouvez mettre à jour le registre en vue de bloquer l’accès utilisateur aux compléments, désigner des dossiers connus et définir des niveaux de sécurité pour les compléments.

Dans l’éditeur du registre Windows, sous HKEY_LOCAL_MACHINE > SOFTWARE > ESRI > ArcGISPro > Settings, créez une clé Add-In Folders (Dossiers de compléments) et utilisez des valeurs de chaîne pour désigner des dossiers connus. Les fichiers de compléments placés dans ces dossiers apparaîtront en tant que Shared Add-Ins (Compléments partagés) dans la fenêtre Add-In Manager (Gestionnaire de compléments). Pour plus d’informations sur la mise à jour du registre, reportez-vous à la rubrique Clés de registre ArcGIS Pro.