Utiliser des outils web avec un service d’entités en sortie

Lorsque vous consommez un outil web avec des entités en sortie normales, la sortie est générée sur l serveur et renvoyée au client en tant qu’entité. Le service d’entités en sortie se trouve dans ArcGIS Data Store sur votre serveur d’hébergement et vous permet de servir les données d’entités en sortie et les tables non spatiales sur le réseau plutôt que d’enregistrer le résultat sur un disque local. Cela permet également de réduire les frais généraux liés au transport des données générées vers le client, améliorant ainsi l’efficacité d’un outil web si les entités en sortie du résultat sont trop volumineuses. Vos données sont également mises à la disposition de différents clients, tels que des clients web, des applications bureautiques et des applications de terrain.

Création

Pour utiliser cette fonctionnalité, vous devez disposer d’une sortie de type table ou classe d’entités..

Inutile de modifier quoi que ce soit lorsque vous créez votre outil web, que la sortie soit facultative ou obligatoire.

Publication

Pour partager un outil web avec un service d’entités en sortie, vous devez respecter la configuration logicielle requise suivante :

• ArcGIS Pro 2.3 ou version ultérieure
• ArcGIS Server et Portal for ArcGIS 10.7 ou version ultérieure
• ArcGIS Server doit être fédéré sur Portal for ArcGIS
• Portal for ArcGIS doit avoir un serveur d’hébergement

Après avoir exécuté l’outil, configurez les paramètres suivants dans la boîte de dialogue Share As A Web Tool (Partager en tant qu’outil web) :

• Vous ne pouvez partager l’outil web qu’avec des groupes de votre portail ou ArcGIS Enterprise. Ne partagez pas votre outil web avec Everyone (Tout le monde) car cela entraîne des problèmes d’autorisation lors de la consommation de l’outil.
• Définissez Execution Mode (Mode d’exécution) sur Asynchronous (Asynchrone).
• Laissez l’option View output in map image layer (Afficher la sortie dans la couche d’images de carte) désélectionnée.
• L’option Maximum number of records returned by server (Nombre maximum d’enregistrements renvoyés par le serveur) n’a aucune incidence que le service d’entités en sortie.

Remarque :

Si vous utilisez la fonction Python arcpy.CreateGPSDDraft pour publier un outil web, vous devez spécifier server_type en tant que MY_HOSTED_SERVICES.

Consommation

Lorsque vous consommez un outil web avec des entités ou une table en sortie, un paramètre en entrée facultatif supplémentaire nommé Output feature service name (Nom du service d’entités en sortie) est disponible à la fin de la liste des paramètres. Ce paramètre est automatiquement généré pendant la publication. Il ne peut être ni supprimé, ni renommé. Pour consommer un outil web avec ce paramètre, indiquez un nom de service qui respecte les conditions requises suivantes :

• Le nom du service d’entités en sortie doit être unique parmi tous les services hébergés de votre portail, car tous les services d’entités en sortie résideront dans le dossier Hosted du portail.
• Le nom peut contenir uniquement des caractères alphanumériques ou des traits de soulignement et ne doit pas dépasser 120 caractères.
• L’utilisateur du portail doit disposer des privilèges permettant la création d’un service d’entités en sortie/ Les seuls rôles dotés de ce privilège sont les rôles Publication et Administration. Dans le cas d’utilisateurs du portail dotés d’un rôle personnalisé, ce rôle doit disposer des privilèges Members/View (Membres/Afficher), Content/Publish hosted feature layers (Contenu/Publier des couches d’entités hébergées) et Content and Analysis/Standard Feature Analysis (Contenu et analyse/Analyse d’entités standard).

Lors de la consommation de l’outil web avec un service d’entités en sortie, toutes les entités en sortie sont copiées dans le répertoire de données du serveur d’hébergement, quel que soit l’endroit où réside le résultat sur le serveur.

Remarque :

Lorsque vous publiez un outil web sur un site fédéré ArcGIS Server avec votre portail, une commande allowconnection doit être exécutée sur votre serveur d’hébergement. Sinon, les résultats ne peuvent pas être copiés sur le serveur d’hébergement.

Lors de l’exécution de l’outil web, le serveur fournit une URL au service d’entités résultant. Si vous consommez l’outil web dans ArcGIS Pro, le résultat est ajouté en tant que couche avec une URL de service à la table des matières. Si vous consommez l’outil web à partir d’une extrémité REST, le résultat est une représentation JSON de l’URL.

Remarque :

Le paramètre Output feature service name (Nom du service d’entités en sortie) est facultatif. Si vous laissez ce paramètre Output feature service name (Nom du service d’entités en sortie) vide et que vous consommez un outil web, une table ou une entité en sortie normale est générée.

Les propriétés du paramètre en sortie d’origine affectent le rendu du service d’entités. Voici les scénarios courants :

• Sorties multiples : lorsqu’il existe plusieurs paramètres d’entités en sortie, chaque résultat en sortie est ajouté en tant que couche au service d’entités en sortie, mais il n’y a qu’un seul service d’entités en sortie lors de l’exécution d’un outil web.
• Sortie vide : si le résultat d’un paramètre en sortie est vide lors de l’exécution d’un outil web, une couche avec des entités vides est générée et ajoutée au service.
• Sortie facultative et dérivée : si le type de paramètre en sortie est facultatif ou dérivé, il se peut que la sortie ne soit pas générée lors de l’exécution de l’outil web. Dans ce cas, aucune couche n’est ajoutée au service.
• Sortie avec plusieurs valeurs : l’exécution d’un outil web dont la sortie comporte plusieurs valeurs ne prend pas en charge un service d’entités en sortie.
• Symbologies : si une symbologie est définie pour la sorties de l’outil, le service d’entités en sortie la conserve. Si aucune symbologie n’est définie lors de la création de l’outil, la symbologie par défaut est utilisée.