Exécuter un service de géotraitement

L’étape Run GP Service (Exécuter un service de géotraitement) exécute un service de géotraitement configuré. L’étape peut être utilisée pour exécuter des outils de géotraitement, des outils de script Python et des modèles ModelBuilder publiés sur un portail ArcGIS Enterprise en tant que services.

Lorsque l’étape est exécutée, l’icône Starting (En cours de démarrage)  apparaît sur la tâche et lorsque le service démarre, l’icône Running (En cours d’exécution)  apparaît pour indiquer que le service de géotraitement est en cours d’exécution.

Si des paramètres d’étape sont configurés avec une expression ArcGIS Arcade, ils sont convertis en valeurs appropriées avant le début de l’exécution du service de géotraitement.

Si l’option Visible At Runtime (Visible à l’exécution) est activée, une boîte de dialogue s’affiche dans ArcGIS Pro lorsque l’étape est exécutée pour vous permettre de définir les valeurs de paramètre. Si une valeur par défaut a été configurée, elle apparaît dans la boîte de dialogue. Les paramètres obligatoires sont mis en surbrillance en rouge. Lorsque vous avez terminé de définir les valeurs de paramètre, cliquez sur Continue (Continuer) pour poursuivre l’exécution de l’étape.

Si l’étape s’exécute avec succès, une icône Step Complete (Étape terminée) apparaît. Si l’étape échoue, une icône GP Step Failed (Échec de l’étape de géotraitement) apparaît.

Remarque :

Si une valeur de paramètre obtenue à partir d’une expression ArcGIS Arcade est incompatible avec le service de géotraitement, l’étape échoue.

Lorsque l’étape est exécutée, vous pouvez réaliser les actions suivantes :

• Cliquez sur le bouton Cancel Step (Annuler l’étape)  pour arrêter le service de géotraitement en cours d’exécution.

  Remarque :

  Dans certains cas, l’étape ne peut pas être annulée une fois que son exécution a commencé.

• Cliquez sur le bouton Complete Step (Terminer l’étape)  pour finaliser l’étape.

Configurer l’étape

Pour configurer l’étape Run GP Service (Exécuter un service de géotraitement), procédez comme suit :

1. Créez ou modifiez un diagramme de workflow pour accéder au volet Step Library (Bibliothèque d’étapes).
2. Faites glisser Run GP Service (Exécuter un service de géotraitement) depuis Step Library (Bibliothèque d’étapes) vers une flèche de connexion d’une étape de la zone d’affichage du workflow.

   En savoir plus sur l’ajout d’étapes à un diagramme de processus

   Le volet Step Details (Détails de l’étape) s’affiche.

3. Spécifiez un nom pour l’étape dans la zone de texte Step Name (Nom de l’étape).
4. Si vous le souhaitez, indiquez une description de l’étape dans la zone de texte Step Description (Description de l’étape).
5. Configurez les options de l’étape dans la section Options si nécessaire.
   • Automatically Executes (Exécution automatique) : l’étape est exécutée dès qu’elle devient active.
   • Can Be Skipped (Peut être ignorée) : permet de finaliser la tâche sans l’exécuter.
6. Dans la section Logic (Logique), saisissez l’URL du service de géotraitement dans la zone de texte GP Service URL (URL du service de géotraitement).
7. Vous pouvez désélectionner la case Secure (Sécurisé) si le service de géotraitement n’est pas sécurisé et qu’il n’exige pas qu’un jeton soit indiqué dans la requête.
8. Cliquez sur Edit (Mettre à jour) figurant à côté de Arguments.

   La boîte de dialogue Step Arguments (Arguments d’étape) apparaît.

9. Configurez les valeurs de paramètre en entrée dans les zones de texte Parameter Value (Valeur de paramètre), le cas échéant.

   Remarque :

   Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour les valeurs de paramètre. Si un paramètre ne prend pas en charge les valeurs de chaîne, cliquez sur le bouton Token (Jeton) pour utiliser une expression Arcade.

10. Vous pouvez cocher la case Visible At Runtime (Visible à l’exécution) en regard d’un paramètre pour autoriser la définition de sa valeur lorsque l’étape est exécutée dans ArcGIS Pro.
11. Mettez à jour la valeur de retour si nécessaire.
12. Vous pouvez également cliquer sur l’onglet Help (Aide) et saisir un texte d’aide concernant l’étape dans la zone de texte Help (Aide).
13. Cliquez éventuellement sur l’onglet Style pour changer la forme et la couleur de l’étape.

Codes de retour

À la fin de l’exécution de l’étape, un code de retour est renvoyé pour indiquer le résultat de l’étape. Le code de retour est évalué et le workflow suit tous les chemins qui correspondent à la valeur de retour de l’étape. Le tableau suivant répertorie les codes de retour de l’étape :

Code de retour	Description
<CustomReturnCode>	L’étape s’est terminée et renvoie le code de retour personnalisé défini dans l’étape.
Echec	L’étape ne s’est pas terminée correctement.
Opération réussie	L’étape s’est terminée correctement.