添加和配置“设置作业版本”

您可以通过“设置作业版本”步骤将现有的分支版本设置为作业的当前版本。 运行此步骤时，作业版本将覆盖为指定版本。 如果指定版本不存在或运行步骤的用户没有该版本的访问权限，则步骤将运行失败，作业磁贴上将出现一条错误消息。

当您为步骤启用管理的工作流时，Workflow Manager 会管理分支版本，可以使用声明版本和清理步骤更改或删除版本。

配置步骤

要配置步骤，请执行以下操作：

1. Create or edit a workflow diagram to access the Step Library panel.
2. 将设置作业版本从步骤库面板拖至工作流画布中步骤的连接箭头。

   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. 在数据源部分中，选择一个选项：
   • 选择源 - 单击选择源下拉箭头，然后选择要设置的数据源版本。
   • Arcade 表达式 - 提供一个 ArcGIS Arcade 表达式，该表达式用于返回要设置的数据源版本的项目 ID。

     提示：

     Click This input supports Arcade Expressions and choose an ArcGIS Arcade expression to add it to its associated text box.

   注：

   仅可以为此步骤使用一个数据源。 如果您需要将作业版本设置为使用多个数据源，请在工作流示意图中配置额外的“设置作业版本”步骤。

5. 在版本部分中，选择一个选项：
   • 版本 GUID - 提供要使用的分支版本的 GUID。 这样做性能更佳，因此建议采用此方法。
   • 版本名称 - 提供要使用的分支版本的完全限定版本名称，例如 WORKFLOWUSER.JOB_44。
6. 可以选中管理的工作流复选框以使 Workflow Manager 管理分支版本。

   这样做也会启用声明版本和清理步骤，以便您更改或删除版本。

7. Click the Options tab.
8. 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.

     注：

     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 additional automated steps without manual intervention.

   • Run on a Schedule—Run the step according to a schedule you set.

     Learn more about scheduling options

9. 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) + '.'

10. Optionally, click the Style tab to change the shape and color of the step.
11. Optionally, click the About tab and provide a description for the step in the Step Description text box.

    提示：

    The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output. Click Copy Step ID to copy the step ID to your clipboard.

返回值

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 value	Description
S000001	The step completed successfully.
F000001	The step failed to complete successfully.

输出值

When the step is completed, its output value is stored and can be used to determine the path the workflow follows or can be used as inputs for other steps throughout the workflow. The following table lists the step's output values:

输出	描述
版本	将返回所设置版本的数组。
dataSource	将返回已成功设置版本的数据源 URL 数组。