Skip To Content

Ajouter et configurer une étape Run GP Service (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) Starting apparaît sur la vignette de la tâche. Lorsque le service démarre, l’icône Running (En cours d’exécution) Running 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, l’étape vous permet de définir les valeurs de paramètre avant le démarrage du service de géotraitement. Si des valeurs par défaut ont été configurées pour les paramètres, elles apparaissent lorsque vous exécutez l’étape et peuvent être remplacées. Les paramètres obligatoires sont mis en surbrillance en rouge.

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

When the step is run, the following actions can be performed:

  • Si l’option Visible At Runtime (Visible à l’exécution) est activée, les valeurs de paramètre peuvent être indiquées et vous pouvez exécuter l’étape en cliquant sur Proceed (Poursuivre).
  • Pour annuler l’étape, cliquez sur le bouton Cancel Step (Annuler l’étape) Cancel Step.
    Remarque :

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

  • Pour terminer l’étape, cliquez sur le bouton Complete Step (Terminer l’étape) Complete Step.

Configurer l’étape

To configure the step, do the following:

  1. Create or edit a workflow diagram to access the Step Library panel.
  2. Faites glisser Run GP Service (Exécuter un service de géotraitement) depuis le volet Step Library (Bibliothèque d’étapes) vers une flèche de connexion d’une étape de la zone d’affichage du workflow.

    The Step Details panel appears.

  3. Provide a name for the step in the Step Name text box.
  4. Saisissez l’URL du service de géotraitement dans la zone de texte GP Service URL (URL du service de géotraitement).
  5. 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.
  6. Dans la section Arguments, cliquez sur Edit (Mettre à jour).

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

  7. 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.

  8. 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.
  9. Mettez à jour la valeur renvoyée si nécessaire.
  10. Click the Options tab.
  11. Configure Step Options as necessary.
    • Manual—Run the step manually.
      • Optional—Allow the step to be finished without being run.
    • Automatic—Run the step as soon as it becomes active.
      Remarque :

      If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.

    • Run on a Schedule—Run the step according to a schedule you set.

      Learn more about scheduling options

  12. Optionally, provide help text for the step in the Step Help text box.

    You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:

    'For further assistance, please contact ' + jobCreator($job) + '.'
  13. Optionally, click the Style tab to change the shape and color of the step.
  14. Optionally, click the About tab and provide a description for the step in the Step Description text box.
    Remarque :

    The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.

Return value

When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:

Return valuesDescription

S000001

The step completed successfully.

F000001

The step failed to complete successfully.

Valeur en sortie

When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:

Nom de la valeur en sortieDescriptionSyntaxe de l’expression ArcGIS Arcade

<GeoprocessingServiceOutput>

Renvoie toutes les valeurs en sortie reçues du service de géotraitement.

jobOutputValue($job, '<step_id>','<geoprocessing_service_output_parameter_name>')

Remarque :

geoprocessing_service_output_parameter_name est un paramètre facultatif. Si aucun nom de paramètre en sortie dérivé n’est fourni, la première valeur en sortie dérivée est renvoyée.

Rubriques connexes