Les valeurs des paramètres que vous choisissez lors du partage d’un outil en tant qu’outil Web définissent son mode de consommation par les applications client. Les paramètres les plus courants et les plus fréquemment modifiés d’un service peuvent être définis au cours du partage. Les paramètres moins courants peuvent être modifiés dans ArcGIS Server Manager, une fois l’outil partagé. Quelques paramètres avancés peuvent uniquement être définis sur l’API REST administrateur de ArcGIS Server. Peu d’outils Web (services de géotraitement) nécessiteront la modification de ces paramètres avancés.
Paramètres
Les sous-sections ci-dessous décrivent les paramètres que vous pouvez utiliser lors du partage d’un outil Web.
Généralités
Les valeurs suivantes peuvent être utilisées pour les paramètres généraux :
Paramètre | Description |
---|---|
Nom | Le nom de l’outil Web qui sera partagé sur votre portail. Ce nom doit être unique sur votre portail et ne doit pas contenir d’espaces ou de caractères spéciaux. Ce paramètre est hérité des métadonnées de l’outil. |
Résumé | Résumé et balises qui permettent de décrire le document et grâce auxquels l’outil web peut faire l’objet d’une recherche. Les valeurs de ces paramètres sont héritées des métadonnées de l’outil. Le résumé et les balises sont requis en cas de partage sur un portail ArcGIS Enterprise 10.9 ou versions antérieures. Vous pouvez utiliser un maximum de 128 balises. |
Balises | |
Version | Version ArcGIS Enterprise ou ArcGIS Server sur laquelle vous allez partager. Ce paramètre n’est activé que lorsque vous enregistrez une définition de service hors connexion pour un outil Web ou un service de géotraitement. |
Données | Spécifie le traitement qui sera appliqué aux données
En savoir plus sur la copie, le référencement et l’utilisation des données d’URL |
Emplacement | Indique où l’outil Web sera créé :
|
Partager avec | Détermine avec quelles personnes et quels groupes l’outil Web sera partagé. Un outil Web est toujours partagé dans My Content (Mon contenu). Lorsque vous partagez un outil Web avec Everyone (Tout le monde) celui-ci devient public. Toute personne accédant au site Web du portail peut le trouver et l’utiliser, et les propriétaires de groupes peuvent l’inclure au contenu de leur groupe. Si vous partagez un outil Web sur ArcGIS Enterprise, l’outil est partagé avec tous les membres de votre portail qui ont accès à un élément. Vous pouvez le partager avec tous les groupes auxquels vous appartenez actuellement. |
Configuration
Les valeurs suivantes sont disponibles pour les paramètres de configuration :
Paramètre | Description |
---|---|
Publier | Indique si un client peut charger un fichier sur votre serveur afin de l’utiliser en entrée de l’outil Web. L’opération de téléchargement est généralement utilisée par les clients Web qui ont besoin d’une solution pour envoyer un fichier au serveur pour traitement. Une fois le chargement terminé, un ID unique est renvoyé pour le fichier, ID que l’application web peut transmettre à l’outil web. Cette option est désactivée par défaut. Autoriser les chargements dans votre service peut comporter un risque de sécurité. Activez cette option uniquement si vous en avez besoin. |
Mode d’exécution | Définit la façon dont le client (l’application utilisant l’outil Web) interagit avec l’outil Web et génère la sortie. Lorsqu’un outil Web est défini sur Synchronous (Synchrone), le client attend la fin de la tâche. En général, un service synchrone s’exécute rapidement (en moins de quelques secondes). Lorsqu’il est défini sur Asynchronous (Asynchrone), l’exécution du service prend généralement plus de temps et le client doit régulièrement interroger le serveur pour savoir si le service est terminé et, si c’est le cas, obtenir le résultat. Une application Web qui utilise un service asynchrone doit être dotée d’une logique qui vérifie l’état et gère le résultat une fois l’exécution terminée. |
Afficher la sortie dans la couche d’images de carte | Lorsque vous publiez un outil Web, vous pouvez afficher la sortie en tant qu’image de carte. L’image de carte est créée sur le serveur et retransmise sur le client sous forme d’image (fichier .tiff, avec des informations de style). La symbologie, l’étiquetage, la transparence et les autres propriétés de l’image de la carte sont identiques à ceux de la couche en sortie de la session ArcGIS Pro lors de la publication d’origine. Vous pouvez utiliser l’option View output in map image layer (Afficher la sortie dans la couche d’images de carte) pour les raisons suivantes :
Remarque :Une image de carte en sortie peut uniquement être utilisée lorsque l’outil web est défini sur Asynchronous (Asynchrone). Ce paramètre n’est pas pris en charge lors de la publication d’un outil Web sur Kubernetes. |
Niveau du message | Vous pouvez renvoyer des messages de niveaux différents au client qui a exécuté votre outil Web, comme suit :
Attention :Tous les messages, quel que soit leur niveau, peuvent contenir des noms et des chemins d’accès au jeu de données, ce qui peut représenter un risque en termes de sécurité. Le niveau Info contient des références aux noms et chemins d’accès au jeu de données. En général, activez le renvoi des messages en phase de développement et désactivez-le en phase de production. |
Nombre maximum d’enregistrements renvoyés | Nombre maximal de résultats que le service peut renvoyer à un client. Si cette valeur est définie sur un nombre élevé, cela signifie que le serveur SIG peut gérer l’envoi de nombreux enregistrements individuels ou d’entités au client. Si vous ne souhaitez pas renvoyer d’entités, définissez cette valeur sur 0 (zéro). En règle générale, cette valeur est définie sur zéro uniquement lorsque vous activez l’option Afficher la sortie dans la couche d’images de carte. |
Les valeurs des paramètres mentionnés précédemment peuvent être modifiées dans ArcGIS Server Manager une fois l’outil Web partagé, à l’exception du résumé et des balises. Ces informations de description peuvent être mises à jour sur la page de l’élément de l’outil web partagé sur votre portail.
Contenu
Les paramètres suivants peuvent uniquement être modifiés au moment de la publication d’un outil web.
Ajouter un outil
Pour ajouter des outils à partir de l’historique du géotraitement à un outil Web existant, cliquez sur le bouton Add Tool (Ajouter un outil) sur l’onglet Content (Contenu). Pour supprimer des outils, cliquez sur le nom de l’outil et sélectionnez Remove (Supprimer).
Configurer les propriétés d’un outil
Pour configurer les propriétés de l’outil, cliquez sur le bouton d’édition en regard du nom de l’outil.
Propriété | Description |
---|---|
Nom | Nom de l’outil. La valeur par défaut est basée sur les métadonnées de l’outil. |
Description | Description de l’outil. La description n’est pas héritée des métadonnées de l’outil. Si elle est vide, indiquez une description ; elle sera conservée à chaque fois que vous procéderez à un partage depuis l’historique. |
Les propriétés suivantes peuvent être configurées pour chaque paramètre :
Propriété | Description |
---|---|
Nom | Nom et description du paramètre. Ces deux propriétés héritent du nom du paramètre et de la description des métadonnées de l’outil. Vous pouvez les modifier ici sans affecter les métadonnées d’origine de l’outil. |
Description | |
Type | Le type de paramètre indique si le client doit fournir une valeur afin que l’outil s’exécute avec succès. L’onglet Content (Contenu) permet uniquement de modifier les paramètres facultatifs en paramètres obligatoires. Pour modifier un paramètre obligatoire en paramètre facultatif, quittez la fenêtre de partage, mettez à jour les propriétés de l’outil et exécutez à nouveau l’outil afin de créer un nouveau résultat. |
Conserver le type de données en tant que Composite | Cette propriété n’est disponible que lorsque le paramètre est un type de données composite. Détermine si le paramètre sera publié en tant que type de données composite (case cochée). Cette option est désactivée par défaut. |
Input Mode (Mode en entrée) | Détermine de quelle façon les clients entreront des entités dans la tâche. Pour la conception et l’utilisation de l’interface utilisateur graphique, reportez-vous à la rubrique Mode en entrée d’un paramètre.
|
Convertir le type de données en Chaîne | Cette propriété ne s’applique qu’au type de données Unité surfacique. Cela indique si l’unité surfacique sera convertie en type de données Chaîne (case cochée) ou publiée en tant qu’unité surfacique (case non cochée). Cette option est désactivée par défaut. |
Supprimer la valeur par défaut | À partir de ArcGIS Pro 3.3, lorsque cette case est cochée, la valeur par défaut utilisée lorsque l’outil est exécuté sera supprimée pendant le processus de publication. Cette option est désactivée par défaut. |
Valeur par défaut | La valeur par défaut de l’outil est déterminée par la valeur de paramètre indiquée lors de l’exécution de l’outil. Pour ajouter ou modifier la valeur par défaut d’un paramètre, vous devez exécuter à nouveau l’outil avec le paramètre correspondant. |
Utiliser uniquement les couches par défaut | Cette propriété ne s’applique qu’au mode en entrée des listes de choix. Cela spécifie si seules les options utilisées pendant l’exécution de l’outil seront cochées dans la vue de liste sous cette case de sélection (case cochée). Cette option est désactivée par défaut. |
Type de géométrie | Cette propriété s’applique uniquement aux entités. Le type de géométrie découle des entités en entrée et en sortie utilisées pour créer le résultat. Il ne peut pas être modifié dans l’onglet Content (Contenu). Vous devez réexécuter l’outil à l’aide d’entités du type de géométrie spécifié, puis partager le résultat obtenu par cette opération. |
Structure | Cette propriété s’applique uniquement aux entités et aux tables. La structure est une liste de champs (attributs) qui doivent être fournis par le client lorsqu’il construit les entités à entrer pour l’outil. Cette liste de champs est la même que la couche ou le jeu de données utilisé en entrée ou sortie de l’outil ayant créé le résultat. |
Les paramètres de configuration suivants s’appliquent à la totalité de l’outil :
Paramètre | Description |
---|---|
Ajouter un paramètre de service d’entités en sortie facultatif | Un paramètre en sortie facultatif qui indique si la sortie peut être enregistrée en tant que service d’entités lors de l’utilisation de l’outil Web (case cochée). Ce paramètre est uniquement pris en charge lors de la publication en tant qu’outil Web avec mode asynchrone. Il ne peut pas être utilisé pour la configuration en dehors de cela. Cette case est cochée par défaut. |
Supprimer toutes les valeurs par défaut | À compter de ArcGIS Pro 3.3, lorsque cette case est cochée, toutes les valeurs par défaut utilisées lorsque l’outil est exécuté seront supprimées, et l’option Remove default value (Supprimer la valeur par défaut) dans la configuration du paramètre de l’outil ci-dessus sera automatiquement sélectionnée. Cette option est désactivée par défaut. |
Paramètres de ArcGIS Server Manager
Les valeurs des paramètres des sous-sections ci-dessous ne peuvent être modifiées que dans ArcGIS Server Manager. Les paramètres de configuration mentionnés précédemment peuvent également être modifiés dans ArcGIS Server Manager une fois le service publié.
Remarque :
La modification des paramètres suivants entraîne le redémarrage du service.
Paramètres
Les valeurs suivantes des paramètres sont disponibles :
Paramètre | Description |
---|---|
Agrégat | La grappe hébergeant le service. Ce paramètre peut uniquement être modifié si ArcGIS Server fait partie d’une grappe. |
Répertoires | Les répertoires utilisés par le serveur pour écrire les fichiers lors de l’exécution de l’outil. |
Fonctionnalités
La valeur suivante du paramètre Fonctionnalités est disponible :
Paramètre | Description |
---|---|
WPS | Active les fonctionnalités WPS des services de géotraitement, ce qui permet à d’autres clients de se connecter à des outils et de les utiliser via les protocoles standard OGC. |
Groupage
Les valeurs suivantes du paramètre Groupage sont disponibles :
Paramètre | Description |
---|---|
Number of instances (Nombre d’instances) | Le nombre minimum et maximum d’instances du service. Les valeurs par défaut sont 1 (minimum) et 2 (maximum). La définition d’une valeur minimum de 0 réduit les ressources système. Une instance démarre à la demande d’un client. |
Durée maximale pendant laquelle un client peut utiliser un service | Durée maximale, exprimée en seconde, d’utilisation d’un service. Vous pouvez avoir besoin d’augmenter la valeur par défaut à 600 secondes (10 minutes) pour les tâches de géotraitement avec une durée d’exécution plus longue. Vous pouvez également réduire ce temps pour vous assurer qu’un client ne profite pas des services. |
The maximum time a client will wait to get a service (La durée maximale d’attente d’un client avant d’obtenir un service) | Période maximale, exprimée en seconde, durant laquelle un client doit attendre pour se connecter à une instance avant la période d’expiration. Lorsque toutes les instances sont occupées avec le traitement de demandes, les demandes sont placées dans une file d’attente. Si cette période d’expiration s’écoule avant qu’une instance ne soit disponible, la tâche échoue. La valeur par défaut est de 60 secondes (1 minute). |
The maximum time an idle instance can be kept running (La durée maximale d’exécution d’une instance inactive) | Période maximale, exprimée en seconde, durant laquelle un client doit attendre pour se connecter à une instance avant la période d’expiration. Toutes les instances inutilisées au-delà du nombre minimal d’instances sont arrêtées dès que la période d’inactivité a atteint la valeur limite définie. |
Processus
La valeur suivante du paramètre Processus est disponible :
Paramètre | Description |
---|---|
Recyclage | Contrôle à quelle fréquence et à quel moment un service est recyclé. La valeur par défaut est d’une fois toutes les 24 heures, à partir de minuit. Les services de géotraitement s’exécutent uniquement en isolement élevé, contrairement à certains autres types de service qui peuvent s’exécuter en isolement faible ou élevé. |
Vous avez un commentaire à formuler concernant cette rubrique ?