El paso Definir versión del trabajo le permite establecer una versión en rama existente como la versión actual del trabajo. Cuando se ejecuta el paso, la versión del trabajo se sobrescribe con la versión especificada. Si la versión especificada no existe o el usuario que ejecuta el paso no tiene acceso a la versión, el paso falla y aparece un mensaje de error en la tesela del trabajo.
Cuando habilita Flujo de trabajo administrado para el paso, Workflow Manager administra la versión en rama y los pasos Reclamar versión y Limpieza se pueden usar para modificar o eliminar la versión.
Configurar el paso
Para configurar el paso, haga lo siguiente:
- Cree o edite un diagrama de flujo de trabajo para acceder al panel Biblioteca de pasos.
- Arrastre Definir versión del trabajo desde el panel Biblioteca de pasos a una flecha de conexión de un paso en el lienzo del flujo de trabajo.
Aparece el panel Detalles del paso.
- Proporcione un nombre para el paso en el cuadro de texto Nombre de paso.
- En la sección Fuente de datos, elija una opción:
- Seleccionar fuente: haga clic en la flecha desplegable Seleccionar fuente y elija la fuente de datos con la versión que desea establecer.
- Expresión de Arcade: proporcione una expresión de ArcGIS Arcade que devuelva el Id. de elemento de la fuente de datos con la versión que desea establecer.
Sugerencia:
Haga clic en La entrada admite expresiones de Arcade
y elija una expresión de ArcGIS Arcade para agregarla su cuadro de texto asociado.
Nota:
Solo se puede utilizar una fuente de datos para este paso. Si necesita establecer la versión del trabajo para más de una fuente de datos, configure pasos adicionales Definir versión del trabajo en el diagrama de flujo de trabajo.
- En la sección Versión, elija una opción:
- GUID de versión: proporcione el GUID de la versión en rama que desea utilizar. Este es el método recomendado, ya que proporciona un rendimiento mejorado.
- Nombre de la versión: proporcione el nombre de versión totalmente calificado de la versión en rama que desea utilizar, por ejemplo, USUARIOFLUJODETRABAJO.TRABAJO_44.
- Opcionalmente, active la casilla de verificación Flujo de trabajo administrado para permitir que Workflow Manager administre la versión en rama.
Esto también habilita los pasos Reclamar versión y Limpieza para que pueda modificar o eliminar la versión.
- Haga clic en la pestaña Opciones.
- Configure Opciones de pasos según sea necesario.
- Manual: el paso se ejecuta manualmente.
- Opcional: se permite finalizar el paso sin haberlo ejecutado.
- Automático: el paso se ejecuta tan pronto como se activa.
Nota:
Si el diagrama del flujo de trabajo se configura para que se ejecute automáticamente una secuencia de pasos que incluya el paso Evaluar calidad de datos o Ejecutar servicio GP, los pasos que se intenten ejecutar después de que caduque el token de usuario que inició la secuencia de pasos no se ejecutarán de forma automática. Debe tener una licencia para que el rol de ArcGIS Workflow Manager Server Advanced siga ejecutando más pasos automáticos sin intervención manual.
- Ejecutar según programa: ejecute el paso según un programa establecido.
- Manual: el paso se ejecuta manualmente.
- Opcionalmente, elija una de las siguientes opciones para configurar la ayuda en el paso:
- Ninguno: configure el paso sin ayuda de pasos.
- Texto: configure el texto de ayuda para el paso en el cuadro de texto Texto.
Puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico para la ayuda del paso. Si la ayuda del paso contiene texto sin formato y expresiones de Arcade, tendrá que formatear el texto del siguiente modo:
'For further assistance, please contact' + JobCreator($Job) + '.' - URL: configure el paso con un vínculo a un recurso de ayuda en el cuadro de texto URL.
Nota:
Los pasos que se ejecutan en la aplicación web solo admiten los formatos URL HTTP y HTTPS. Los pasos ejecutados en ArcGIS Pro admiten los formatos de archivo, HTTP y HTTPS.
También puede usar expresiones de Arcade para proporcionar un valor dinámico. Si la URL contiene texto sin formato y expresiones de Arcade, deberá formatear el texto como se indica a continuación:
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'Configure la casilla de verificación Codificar automáticamente el resultado de Arcade:
- Si una expresión de Arcade devuelve caracteres especiales que deben ser de escape al convertirlos en una URL, como un espacio o una barra diagonal, asegúrese de que la casilla de verificación Codificar automáticamente el resultado de Arcade está activada.
- Si se utiliza una expresión Arcade para formar la URL base, desmarque la casilla de verificación Codificar automáticamente el resultado de Arcade.
- También puede hacer clic en la pestaña Estilo para cambiar la forma y el color del paso.
- Si lo desea, haga clic en la pestaña Acerca de y proporcione una descripción para el paso en el cuadro de texto Descripción del paso.
Sugerencia:
La pestaña Acerca de también contiene un Id. del paso que puede utilizarse con propiedades del paso dinámico para obtener una salida del paso. Haga clic en Copiar Id. del paso
para copiar el Id. del paso en el portapapeles.
Valor de retorno
Cuando el paso se completa, el valor de retorno se almacena para indicar el resultado del paso. El valor de retorno puede evaluarse de inmediato utilizando rutas para determinar los pasos siguientes del flujo de trabajo. También puede recuperar el valor de retorno correspondiente a los pasos completados por medio del flujo de trabajo utilizando las expresiones de ArcGIS Arcade. En la tabla siguiente figuran los valores de retorno del paso:
| Valor de retorno | Descripción |
|---|---|
| S000001 | El paso se ha completado correctamente. |
F000001 | El paso no ha podido completarse correctamente. |
Valor de salida
Cuando el paso se completa, su valor de salida se almacena y se puede utilizar para determinar la ruta que sigue el flujo de trabajo o puede usarse como entradas para otros pasos del flujo de trabajo. En la tabla siguiente figuran los valores de salida del paso:
| Salida | Descripción |
|---|---|
| versión | Se devuelve un conjunto de la versión establecida. |
dataSource | Se devuelve un conjunto de la dirección URL de la fuente de datos para la que se han establecido correctamente las versiones. |