版本化允许多个用户使用自己的空间数据版本完成工作，以使用运行 GP 服务步骤协调编辑内容并提交到默认分支版本。 这有助于确保用户在适当的时间访问正确的数据，并且有助于避免编辑冲突。
运行该步骤时，将检查在工作流中定义的所有要素服务数据源中是否存在现有作业特定数据版本。 如果数据源不含作业特定版本，“创建版本”步骤将自动创建该版本并将其与作业相关联。 “创建版本”步骤仅支持为在作业工作流逻辑示意图中定义的数据源的每个要素服务创建单一作业版本。
注：
如果已存在作业数据源的私有版本，将为该数据源创建新版本，前提是步骤当前由不是现有私有版本所有者的用户运行。
如果已存在具有相同作业名称的公共版本，则“创建版本”步骤将失败。 现有版本不与作业相关联，并且不会创建新版本。
When the step finishes running, a message appears on the job tile with the result of the step.
如果尚未定义步骤的数据源，或者如果步骤无法创建版本，将显示 CreateVersionFailed 消息，作业不会继续执行下一步。 将光标悬停在该错误消息上可显示有关错误的其他信息。
If the step fails and the return codes don't match any of the configured paths, and the step isn't optional, the step remains in a failed state and can’t be skipped.
配置步骤
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- 将创建版本从步骤库面板拖至工作流画布上步骤的连接箭头。
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- 根据需要在访问权限部分中配置版本的权限级别。
注：
访问权限设置可用于限制非版本所有者的用户查看或编辑版本。 默认值为私有。
- Click the Options tab.
- 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 the additional automated steps without manual intervention.
- Run on a Schedule—Run the step according to a schedule you set.
- Manual—Run the step manually.
- 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) + '.' - Optionally, click the Style tab to change the shape and color of the step.
- 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.
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. |