Configure paths

Paths in ArcGIS Workflow Manager connect the steps in your workflows. Each step can be configured with multiple paths to dynamically assign the next step in the workflow to a person or group based on the result of a previous step.

To add and configure paths for steps in your workflow diagram, do the following:

  1. On the workflow canvas, hover over the step to which you want to add a path.

    The step's connection points appear.

    Hover over a step to show the step connection points.
  2. Click a connection point and drag it to the connection point of another step in the workflow.
    Add a path by dragging a connection point to another step's connection point.

    The Path Details panel appears.

    Tip:

    To delete a path, click the path and press the Delete key.

  3. Optionally, drag the path's nodes to change the shape and position of the path.
  4. In the Path Details panel, choose one of the following options:
    • Value—Choose a static value for the path assignment.
    • Arcade Expression—Determine the path assignment at runtime using dynamic job properties.
  5. If you chose Value, click the Path Assignment drop-down arrow and choose one of the following options:
    • Job Creator—Reassign the step to the person who created the job.
    • Job Owner—Reassign the step to the person who owns the job.
    • Last Run By—Reassign the step to the person who originally completed the step.
    • Maintain Assignment—Assign the step to the person who ran the previous step. This is the default.
    • <UserName>—Assign the step to the specified person.
    • <GroupName>—Assign the step to the specified group.
    Tip:

    You can also type a keyword in the Path Assignment combo box to filter the list to show options that contain the keyword.

  6. If you chose Arcade Expression, do the following:
    1. Provide an Arcadeexpression in the Arcade Expression text box.
    2. Choose one of the following path assignment options:
      • User—Choose this option if your Arcade expression returns a user.
      • Group—Choose this option if your Arcade expression returns a group.
      Note:

      If the Arcade expression doesn't return a user or group, the step is unassigned and must be manually assigned to a user or group.

  7. Optionally, if the path assignment is configured to assign the step to a group, check the Force Group Assignment check box to ensure that the step is always assigned to the group, even when the user running the step is a member of the group.
  8. Optionally, click the Status drop-down arrow and choose the status to assign to the job when the path is followed.

    You can also type a custom status name in the Status combo box.

  9. Optionally, choose one of the following Path Logic options:
    • Return Code—Evaluate the return value from the step that just completed to determine the next step in the workflow diagram.

      For example, the Create Version step can be configured with two paths, one for Return Code = Success and one for Return Code = Failure. If the Create Version step succeeds, the job proceeds to the Define Location step. If the step fails, you are prompted to run the step again as a user with sufficient privileges to create versions. Multiple combinations of return values can also be managed using the AND and OR logic operators. For example, if two return values are configured and the OR logic operator is used, the path is followed when the step's return value matches either value. However, if the AND logic operator is used, the path is only followed when the step's return value matches both values. To add return values, click Add Return Code.

    • Expressions—Evaluate the return value from the step that just completed or evaluate a completed step's output value using an ArcGIS Arcade expression to determine the next step in the diagram.

      For example, if a Run GP Service step's output value is 123, the jobOutputValue($job, 'd27395ec-ddfe-2b11-777a-6df02e86d835', 'num_acres') > 50 Arcade expression can be used to determine if the number of acres is greater than 50. Supported Arcade expression values for paths are Boolean, date, double, integer, and string.

    • Any—Proceed to the next step in the workflow regardless of the previous step's return value.
  10. Repeat steps 1 through 6 to add and configure more paths.