El versionado permite que varios usuarios completen el trabajo con su propia versión de los datos espaciales, con el fin de que puedan conciliar y publicar sus ediciones en la versión en rama predeterminada mediante el paso Ejecutar servicio de GP. Esto ayuda a garantizar que los usuarios acceden a los datos correctos en el momento adecuado, y ayuda a evitar conflictos de edición.
Cuando se ejecuta el paso, se comprueba cada una de las fuentes de datos del servicio de entidades definidas en el flujo de trabajo para una versión de los datos específica del trabajo existente. Si la fuente de datos no contiene una versión específica del trabajo, el paso Crear versión crea automáticamente una y la asocia al trabajo. El paso Crear versión solo admite la creación de una única versión de trabajo por servicio de entidades para las fuentes de datos definidas en el diagrama de flujo de trabajo del trabajo.
Nota:
Si ya existe una versión privada de la fuente de datos para el trabajo, se crea una nueva versión para la fuente de datos si un usuario que no es el propietario de la versión privada existente está ejecutando el paso.
Si ya existe una versión pública con el mismo nombre de trabajo, el paso Crear versión fallará. La versión existente no está asociada al trabajo y no se crea una nueva versión.
When the step finishes running, a message appears on the job tile with the result of the step.
Si no se ha definido una fuente de datos para este paso, o si el paso no logra crear versiones, aparece el mensaje CreateVersionFailed y el trabajo no continúa con el siguiente paso. Pase el cursor por encima del mensaje de error para ver información adicional sobre el error.
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.
Configurar el paso
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- Arrastre Crear versión desde el panel Biblioteca de pasos a una flecha de conexión de un paso en el lienzo del flujo de trabajo.
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- Si lo desea, proporcione un nombre para la versión en el cuadro de texto Nombre de la versión.
Nota:
Para agregar un Id. único al nombre de la versión, escriba [índice] allí donde desea que aparezca el Id. único en el nombre de la versión.
- Configure los niveles de permiso para las versiones en la sección Permisos de acceso según sea necesario.
Nota:
La configuración de los permisos de acceso le permite restringir que usuarios que no sean el propietario de la versión vean o editen versiones. La configuración predeterminada es Privado.
- En la sección Fuentes de datos, elija una de las siguientes opciones:
- Todas: elija esta opción para crear una versión para todas las fuentes de datos configuradas en el diagrama de flujo de trabajo.
- Seleccionar fuentes: elija esta opción y haga clic en Agregar fuente para elegir las fuentes de datos para las que desea crear versiones.
Sugerencia:
Para eliminar una fuente de datos, haga clic en el botón Eliminar
. - Expresión de Arcade: elija esta opción y proporcione una expresión ArcGIS Arcade para determinar dinámicamente la fuente de datos para la que se crearán versiones cuando se ejecute el paso.
La expresión Arcade debe devolver el Id. de la fuente de datos espaciales y no el nombre de la fuente de datos espaciales. Si necesita elegir más de una fuente de datos, tendrá que dar formato a la expresión de la siguiente manera:
'["' + JobExtendedProperty($Job, 'versions', 'datasource1') + '"' + ',' + '"' + JobExtendedProperty($Job, 'versions', 'datasource2') + '"]'Sugerencia:
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.
Nota:
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.
Nota:
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. |
Valores de salida
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:
| Salida | Descripción |
|---|---|
| versiones | Devuelve una matriz con todas las versiones creadas. |
dataSources | Devuelve una matriz con todas las direcciones URL de la fuente de datos para la que se crearon correctamente las versiones. |