Étendre les services

Vous pouvez étendre les services d’imagerie et de carte publiés à partir de ArcGIS Pro avec des extensions d’objet serveur (SOE). Les SOE permettent de créer des opérations de service afin d’étendre les fonctions de base des services. Elles peuvent être développées avec ArcGIS Enterprise SDK.

Ces extensions sont encapsulées dans des fichiers .soe et peuvent être ajoutées à votre organisation et gérées à partir de ArcGIS Enterprise Manager.

Ajouter une extension

Pour ajouter une extension à une organisation, vous avez besoin du fichier .soe qui a été créé par le développeur de l’extension. Ce fichier peut contenir une ou plusieurs extensions.

Une fois que vous disposez du fichier, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
  2. Cliquez sur le bouton Extensions dans la barre latérale.

    La page des extensions apparaît.

  3. Cliquez sur Add extension (Ajouter une extension).
  4. Cliquez sur Choose file (Choisir un fichier) et choisissez le fichier .soe à ajouter à votre organisation.
  5. Cliquez sur Add extension (Ajouter une extension).

    Le fichier .soe est ajouté à l’organisation.

Maintenant que vous avez ajouté l’extension à votre organisation, vous devez l’inscrire auprès d’un service. Pour ce faire, activez la fonctionnalité SOE sur le service d’imagerie ou de carte souhaité lors de la publication du service à partir de ArcGIS Pro.

Configurer les paramètres de débogage

Afin d’activer le débogage, ArcGIS Enterprise Manager vous permet de modifier le comportement de l’extension. Vous pouvez suspendre le démarrage du service de manière à joindre le débogueur au processus de service avant l'appel des méthodes d'initialisation de l'extension. Vous pouvez également indiquer une plage de ports qui sera utilisée lors du débogage du service.

Pour accéder à ces paramètres de débogage dans Enterprise Manager, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
  2. Cliquez sur le bouton Services dans la barre latérale.

    La page des services apparaît.

  3. Localisez le nom d’un service inscrit auprès d’une extension d’objet serveur et cliquez dessus.
  4. Sélectionnez l’onglet Advanced (Avancé) et activez le mode de débogage.

    Les paramètres de débogage de l’extension apparaissent une fois le mode de débogage activé.

  5. Si vous le souhaitez, vous pouvez également activer Suspend service startup (Suspendre le service au démarrage) et spécifier le nombre de secondes de retard pour le démarrage du service.
  6. Vous pouvez éventuellement indiquer une plage de ports à utiliser lors du débogage.
  7. Cliquez sur Save (Enregistrer).

Supprimer une extension

Lorsque vous supprimez une extension dans ArcGIS Enterprise Manager, elle est retirée de votre organisation. Si l’extension est inscrite auprès d’un service, sa suppression déclenche également sa désinscription du service.

Pour supprimer une extension, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
  2. Cliquez sur le bouton Extensions dans la barre latérale.

    La page des extensions apparaît.

  3. Cliquez sur le bouton More options (Autres options) pour l’extension à supprimer, puis sur Delete (Supprimer).
  4. Cliquez une nouvelle fois sur Delete (Supprimer) pour confirmer la suppression.

    L’extension est désinscrite du service et supprimée de l’organisation.

Mettre à jour une extension

Vous pouvez mettre à jour une extension qui a été ajoutée à votre organisation en ajoutant son fichier .soe mis à jour.

Pour mettre à jour l’extension, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
  2. Cliquez sur le bouton Extensions dans la barre latérale.

    La page des extensions apparaît.

  3. Cliquez sur le bouton More options (Autres options) pour l’extension à mettre à jour, puis sur Update (Mettre à jour).
  4. Cliquez sur Choose File (Choisir un fichier) et sélectionnez la version actualisée du fichier .soe.

    Le nom de fichier doit correspondre au nom du fichier .soe d’origine.

  5. Cliquez sur Update extension (Mettre à jour l’extension).

    L’extension est mise à jour avec le nouveau fichier .soe.