Vous pouvez étendre les services d’imagerie et de carte publiés à partir de ArcGIS Pro avec des extensions d’objet serveur (SOE) et des intercepteurs d’objet serveur (SOI). Les SOE permettent de créer des opérations de service afin d’étendre les fonctions de base des services, tandis que les SOI vous permettent d’intercepter les requêtes et réponses inhérentes aux opérations intégrées d’un service.
Les extensions d’objet serveur (SOE) et les intercepteurs d’objet serveur (SOI) peuvent être développés à l’aide de ArcGIS Enterprise SDK et sont tous les deux encapsulés dans des fichiers .soe. Ils peuvent être ajoutés à votre organisation et gérées à partir de ArcGIS Enterprise Manager. Une fois ajoutés à votre organisation, les extensions d’objet serveur (SOE) et les intercepteurs d’objet serveur (SOI) peuvent être activés sur les services d’imagerie et de carte lors d’une publication à partir de ArcGIS Pro ou sur des couches d’images de carte à partir de la page des détails des éléments.
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 :
-
Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
Remarque :
Les organisations peuvent autoriser les éditeurs à déployer des extensions. Reportez-vous à la rubrique Modifier les privilèges de publication des services de géotraitement et des extensions de service pour plus d’informations.
- Cliquez sur le bouton Extensions dans la barre latérale.
La page des extensions apparaît.
- Cliquez sur Add extension (Ajouter une extension).
- Cliquez sur Choose file (Choisir un fichier) et choisissez le fichier .soe à ajouter à votre organisation.
- 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 activer la fonctionnalité SOE ou SOI sur le service de carte ou d’imagerie souhaité.
Activer des extensions SOE
Une fois qu’une extension d’objet serveur (SOE) a été ajoutée à votre organisation, vous pouvez activer la fonctionnalité sur un service de carte ou d’imagerie. Les extensions SOE peuvent être activées sur des couches d’images de carte à partir de la page des détails des éléments.
Pour activer une extension d’objet serveur (SOE) à partir de la page des détails des éléments d’une couche, procédez comme suit :
- Connectez-vous à une organisation en tant que propriétaire d’un élément doté de privilèges de publication ou en tant qu’administrateur.
- Ouvrez la page des détails des éléments de la couche d’images de carte.
- Cliquez sur Settings (Paramètres).
- Accédez à la section Map Image Layer (Couche d’images de carte) et développez le titre Extensions.
- Développez le titre Server object extensions (SOEs) (Extensions d’objets serveur (SOE)).
Une liste des extensions d’objet serveur (SOE) ajoutées à votre organisation apparaît.
- Activez le bouton bascule en regard de l’extension d’objet serveur (SOE) à activer sur le service.
- Développez le titre de l’extension d’objet serveur (SOE) que vous avez activée.
Les opérations et propriétés de l’extension d’objet serveur (SOE) apparaissent. Elles ont éventuellement été créées par le développeur de l’extension et vous permettent d’exercer un contrôle plus précis sur les actions que les utilisateurs peuvent effectuer avec les extensions d’objet serveur (SOE).
- Le cas échéant, sélectionnez les opérations que vous souhaitez autoriser.
- Le cas échéant, mettez à jour les propriétés disponibles.
- Cliquez sur Save (Enregistrer) pour appliquer les modifications.
L’extension d’objet serveur (SOE) est maintenant activée sur le service. Pour la désactiver, désactivez le bouton bascule en regard de l’extension SOE et cliquez sur Save (Enregistrer).
Activer des extensions SOI
Une fois qu’un intercepteur d’objet serveur (SOI) a été ajouté à votre organisation, vous pouvez activer la fonctionnalité sur un service de carte ou d’imagerie. Les intercepteurs d’objet serveur (SOI) peuvent être activés sur des couches d’images de carte à partir de la page des détails des éléments.
Le terme d'enchaînement désigne l'activation de plusieurs extensions SOI. Lorsque vous procédez à un enchaînement, vous devez spécifier l’ordre d’exécution des intercepteurs d’objet serveur (SOI) dans le service.
Pour activer un intercepteur d’objet serveur (SOI) à partir de la page des détails des éléments d’une couche, procédez comme suit :
- Connectez-vous à une organisation en tant que propriétaire d’un élément doté de privilèges de publication ou en tant qu’administrateur.
- Ouvrez la page des détails des éléments de la couche d’images de carte.
- Cliquez sur Settings (Paramètres).
- Accédez à la section Map Image Layer (Couche d’images de carte) et développez le titre Extensions.
- Développez le titre Server object interceptors (SOIs) (Intercepteurs d’objet serveur (SOI)).
Une liste des intercepteurs d’objet serveur (SOI) ajoutés à votre organisation apparaît.
- Activez le bouton bascule en regard des intercepteurs d’objet serveur (SOI) à activer sur le service.
- Si vous activez plusieurs intercepteurs d’objet serveur (SOI), utilisez les fonctions glisser-déposer pour spécifier leur ordre d’exécution dans la chaîne.
L’intercepteur d’objet serveur (SOI) au début de la liste est exécuté en premier.
Conseil :
Vous pouvez revenir dans cette boîte de dialogue à tout moment pour modifier la liste des intercepteurs d’objet serveur (SOI) activés, ainsi que l’ordre dans lequel ils sont exécutés dans la chaîne.
- Développez le titre de chaque intercepteur d’objet serveur (SOI) que vous avez activé.
Les opérations et propriétés de l’intercepteur d’objet serveur (SOI) apparaissent. Elles ont éventuellement été créées par le développeur de l’extension et vous permettent d’exercer un contrôle plus précis sur les actions que les utilisateurs peuvent effectuer avec les intercepteurs d’objet serveur (SOI).
- Le cas échéant, sélectionnez les opérations que vous souhaitez autoriser.
- Le cas échéant, mettez à jour les propriétés disponibles.
- Cliquez sur Save (Enregistrer) pour appliquer les modifications.
Les intercepteurs d’objet serveur (SOI) sont maintenant activés sur le service. Pour désactiver un intercepteur d’objet serveur (SOI), désactivez le bouton bascule qui se trouve en regard de son nom et cliquez sur Save (Enregistrer).
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 :
- Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
- Cliquez sur le bouton Services dans la barre latérale.
La page des services apparaît.
- Localisez le nom d’un service inscrit auprès d’une extension d’objet serveur et cliquez dessus.
- 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é.
- 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.
- Vous pouvez éventuellement indiquer une plage de ports à utiliser lors du débogage.
- 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 :
- Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
- Cliquez sur le bouton Extensions dans la barre latérale.
La page des extensions apparaît.
- Cliquez sur le bouton More options (Autres options)
pour l’extension à supprimer, puis sur Delete (Supprimer). - 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 :
- Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
- Cliquez sur le bouton Extensions dans la barre latérale.
La page des extensions apparaît.
- Cliquez sur le bouton More options (Autres options) pour l’extension à mettre à jour, puis sur Update (Mettre à jour).
- 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.
- Cliquez sur Update extension (Mettre à jour l’extension).
L’extension est mise à jour avec le nouveau fichier .soe.
Vous avez un commentaire à formuler concernant cette rubrique ?