El paso Actualizar propiedades de trabajo permite a la persona que ejecuta un trabajo actualizar las propiedades extendidas y las siguientes propiedades del trabajo:
- job_name
- start_date
- due_date
- priority_rank
- description
- owned_by
- job_status
- notes
- parent_job
Cuando se ejecuta el paso, las propiedades configuradas en el paso aparecen en la tesela de trabajo. Si el paso se ha configurado con ayuda para pasos, aparecerá en la parte inferior de la tesela del trabajo. Los valores predeterminados o actuales aparecen en un cuadro de texto debajo de cada propiedad actualizable.
Si una propiedad contiene un valor no válido o una propiedad obligatoria no contiene ningún valor, la propiedad se resalta en rojo y la opción Continuar no está disponible.
Nota:
Si se actualiza una propiedad automáticamente y se produce un error, el paso falla y aparece un error en la tesela de trabajo. El error también se escribe en los registros de ArcGIS Server.
Cuando el paso se ejecuta, pueden realizarse las siguientes acciones:
- El paso se puede cancelar haciendo clic en Cancelar.
- El paso se puede finalizar haciendo clic en Continuar.
Configurar el paso
Haga lo siguiente para configurar el paso:
- Cree o edite un diagrama de flujo de trabajo para acceder al panel Biblioteca de pasos.
- Arrastre Actualizar propiedades de 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.
- Si lo desea, agregue el mensaje que desea que aparezca cuando se ejecute el paso en el cuadro de texto Indicación al usuario.
Si el mensaje de usuario contiene texto sin formato y expresiones de Arcade, formatee el texto de la siguiente manera:
'This job is currently assigned to ' + JobOwner($Job) + '.'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. - Haga clic en la flecha desplegable Propiedad de trabajo y elija la propiedad ampliada o la propiedad del trabajo que desee actualizar.
Opcionalmente, proporcione una palabra clave en el cuadro de texto Propiedad de trabajo para filtrar la lista y mostrar las propiedades válidas del trabajo que contengan la palabra clave.
- Opcionalmente, haga clic en Mostrar valor predeterminado
para definir el valor predeterminado y la configuración de visibilidad de la propiedad cuando se ejecuta el paso.- Elija una de las siguientes opciones:
- Valor: proporcione un valor estático.
- Expresión de Arcade: proporcione un valor dinámico usando una expresión de Arcade.
- Proporcione un valor predeterminado para la propiedad en el cuadro de texto Valor o Expresión de Arcade.
- Active la casilla de verificación Visible para permitir cambiar el valor al ejecutar el paso.
Precaución:
Si la casilla de verificación Visible no está activada, se debe proporcionar un valor predeterminado.
- Active la casilla de verificación Editable para permitir editar el valor al ejecutar el paso.
Nota:
Si la casilla de verificación Visible no está activada, la casilla de verificación Editable no está disponible.
Nota:
Activar la casilla de verificación Visible o Editable en este paso anula la especificación de la casilla de verificación Visible o Editable en la tabla de propiedades extendidas.
- Elija una de las siguientes opciones:
- Si lo desea, haga clic en Agregar nueva propiedad de trabajo y repita los pasos 5 y 6 para agregar más propiedades.
Nota:
Para eliminar una propiedad de trabajo, pase el cursor por encima de ella y haga clic en Eliminar propiedad
. - Opcionalmente, mantenga el puntero en una propiedad, haga clic en Reordenar propiedad
y arrástrela a la ubicación deseada para reordenar las propiedades. - 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.
- También puede activar la casilla de verificación Habilitado en la sección Comentarios del paso para permitir que un usuario agregue un comentario al paso cuando se ejecute el paso.
- Si lo desea y ha habilitado los comentarios del paso, active la casilla de verificación Obligatorio en la sección Comentarios del paso para que sea obligatorio agregar un comentario al paso para que pueda completarse.
- 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. |