Agregar y configurar Actualizar propiedades de trabajo

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
• descripción
• 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 se ha configurado texto de ayuda para este paso, este aparece 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 requerida no contiene un valor, la propiedad se resalta en rojo y el botó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.

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

• The step can be cancelled by clicking Cancel.
• The step can be finished by clicking Proceed.

Configurar el paso

To configure the step, do the following:

1. Create or edit a workflow diagram to access the Step Library panel.
2. 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.

   Learn more about adding steps to a workflow diagram

   The Step Details panel appears.

3. Provide a name for the step in the Step Name text box.
4. Optionally, add the message you want to appear when the step is run in the User Prompt text box.

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

   'This job is currently assigned to ' + jobOwner($job) + '.'

5. En la sección Argumentos, escriba el nombre de la tabla y el nombre de campo de la propiedad que desea actualizar en el cuadro de texto Propiedad del trabajo usando la siguiente sintaxis:

   tablename.fieldname

   Nota:

   El nombre de la tabla para las propiedades de trabajo es jobs. Los nombres de tabla de las tablas de propiedades extendidas se encuentran en la pestaña Propiedades extendidas de la plantilla de trabajo.

6. Si lo desea, haga clic en el botón Mostrar valor predeterminado para definir la configuración de visibilidad y valor predeterminado de la propiedad cuando se ejecuta el paso.
   1. 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.
   2. Proporcione un valor predeterminado para la propiedad en el cuadro de texto Valor o Expresión de Arcade.
   3. Active la casilla de verificación Visible para permitir cambiar el valor al ejecutar el paso.

   Precaución:

   Si no se proporciona un valor predeterminado y la casilla de verificación Visible no está activada, el valor actual de la propiedad de trabajo se elimina al ejecutar el paso.

7. 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 el botón Eliminar propiedad .

8. Optionally, hover over a property, click the Reorder Property button , and drag it to the desired location to reorder the properties.
9. Click the Options tab.
10. 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.

      Learn more about scheduling options

11. Optionally, check the Enabled check box in the Step Commenting section to allow a user to add a comment when the step is run.
12. Optionally, if you enabled step commenting, check the Required check box in the Step Commenting section to require a comment.
13. 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) + '.'

14. Optionally, click the Style tab to change the shape and color of the step.
15. 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.