Le versionnement permet à plusieurs utilisateurs d’effectuer leur travail avec leur propre version de données spatiales afin qu’ils puissent réconcilier et réinjecter leurs mises à jour sur la version de branche par défaut à l’aide de l’étape Run GP Service (Exécuter un service de géotraitement). Cela permet de s’assurer que les utilisateurs accèdent aux données appropriées au bon moment et d’éviter les conflits de mise à jour.
Lorsque l’étape est exécutée, elle vérifie chacune des sources de données de service d’entités définies dans le workflow d’une version existante des données, spécifique à une tâche. Si la source de données ne contient pas de version spécifique à une tâche, l’étape Create Version (Créer une version) en crée automatiquement une et l’associe à la tâche. L’étape Create Version (Créer une version) prend uniquement en charge une seule version de tâche par service d’entités pour les sources de données définies dans le diagramme de workflow de la tâche.
Remarque :
S’il existe déjà une version privée de la source de données pour la tâche, une nouvelle version est créée pour la source de données si l’étape est exécutée par un utilisateur qui n’est pas le propriétaire de la version privée existante.
S’il existe déjà une version publique portant le même nom de tâche, l’étape Create Version (Créer une version) échoue. La version existante n’est pas associée à la tâche et aucune nouvelle version n’est créée.
When the step finishes running, a message appears on the job tile with the result of the step.
Si aucune source de données n’a été définie pour l’étape ou si l’étape ne parvient pas à créer des versions, un message CreateVersionFailed apparaît et la tâche ne passe pas à l’étape suivante. Survolez le message d'erreur pour afficher des informations supplémentaires sur l'erreur.
If the step fails and the return codes don't match any of the configured paths, and the step isn't optional, the step remains in a failed state and can’t be skipped.
Configurer l’étape
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- Faites glisser Create Version (Créer une version) 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.
- Provide a name for the step in the Step Name text box.
- Si vous le souhaitez, spécifiez un nom pour la version dans la zone de texte Version Name (Nom de la version).
Remarque :
Pour ajouter un ID unique au nom de la version, saisissez [index] à l’endroit où l’ID unique doit apparaître dans le nom de la version.
- Configurez les niveaux d’autorisation des versions dans la section Access Permission (Autorisation d’accès) le cas échéant.
Remarque :
Le paramètre d’autorisation d’accès vous permet d’empêcher l’affichage ou la mise à jour des versions par des utilisateurs autres que le propriétaire de la version. La valeur par défaut est Private (Privé).
- Dans la section Data Sources (Sources de donnés), sélectionnez l’une des options suivantes :
- All (Toutes) - Sélectionnez cette option afin de créer une version pour toutes les sources de données configurées dans le diagramme de processus.
- Select Sources (Sélectionner les sources) - Sélectionnez cette option et cliquez sur Add Source (Ajouter une source) afin de sélectionner les sources de données pour lesquelles vous souhaitez créer des versions.
Conseil :
Pour supprimer une source de données, cliquez sur le bouton Delete (Supprimer)
. - Arcade Expression (Expression Arcade) - Sélectionnez cette option et fournissez une expression ArcGIS Arcade afin de déterminer dynamiquement la source de données pour laquelle des versions seront créées lors de l’exécution de l’étape.
L’expression Arcade doit renvoyer l’ID de la source de données spatiales et non pas son nom. Si vous devez changer plusieurs sources de données, vous devez formater votre expression comme suit :
'["' + JobExtendedProperty($Job, 'versions', 'datasource1') + '"' + ',' + '"' + JobExtendedProperty($Job, 'versions', 'datasource2') + '"]'Conseil :
Click the This input supports Arcade Expressions button
and choose an ArcGIS Arcade expression to add it to its associated text box.
- Click the Options tab.
- 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.
- Manual—Run the step manually.
- Optionally, provide help text for the step in the Step Help text box.
You can also use ArcGIS Arcade expressions to provide a dynamic value for the step help. If the step help contains plain text and Arcade expressions, you'll need to format the text as follows:
'For further assistance, please contact ' + JobCreator($Job) + '.' - Optionally, click the Style tab to change the shape and color of the step.
- 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 values | Description |
|---|---|
| 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 lists the step's output values:
| Sortie | Description |
|---|---|
| versions | Renvoie une matrice de toutes les versions créées. |
dataSources | Renvoie une matrice de toutes les URL de source de données pour lesquelles des versions ont été créées avec succès. |
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?