您可以通过“设置作业版本”步骤将现有的分支版本设置为作业的当前版本。 运行此步骤时,作业版本将覆盖为指定版本。 如果指定版本不存在或运行步骤的用户没有该版本的访问权限,则步骤将运行失败,作业磁贴上将出现一条错误消息。
当您为步骤启用管理的工作流时,Workflow Manager 会管理分支版本,可以使用声明版本和清理步骤更改或删除版本。
配置步骤
要配置步骤,请执行以下操作:
- 创建或编辑工作流示意图,以访问步骤库面板。
- 将设置作业版本从步骤库面板拖至工作流画布中步骤的连接箭头。
步骤详细信息面板随即出现。
- 在步骤名称文本框中提供步骤的名称。
- 在数据源部分中,选择一个选项:
- 选择源 - 单击选择源下拉箭头,然后选择要设置的数据源版本。
- Arcade 表达式 - 提供一个 ArcGIS Arcade 表达式,该表达式用于返回要设置的数据源版本的项目 ID。
提示:
单击此输入支持 Arcade 表达式 ,然后选择 ArcGIS Arcade 表达式以将其添加至其关联文本框。
注:
仅可以为此步骤使用一个数据源。 如果您需要将作业版本设置为使用多个数据源,请在工作流示意图中配置额外的“设置作业版本”步骤。
- 在版本部分中,选择一个选项:
- 版本 GUID - 提供要使用的分支版本的 GUID。 这样做性能更佳,因此建议采用此方法。
- 版本名称 - 提供要使用的分支版本的完全限定版本名称,例如 WORKFLOWUSER.JOB_44。
- 可以选中管理的工作流复选框以使 Workflow Manager 管理分支版本。
- 单击选项选项卡。
- 根据需要配置步骤选项。
- 手动 - 手动运行步骤。
- 可选 - 允许完成步骤而无需运行。
- 自动 - 步骤被激活后立即执行。
注:
如果您的工作流示意图配置为自动运行一系列步骤,其中包括“评估数据质量”或“运行 GP 服务”步骤,则在启动步骤序列的用户令牌到期后,尝试自动运行的步骤将失败。 您必须拥有 ArcGIS Workflow Manager Server Advanced 角色的许可才能继续运行更多自动化步骤,而无需手动干预。
- 按计划运行 - 根据您设置的计划运行步骤。
- 手动 - 手动运行步骤。
- (可选)选择以下选项之一配置步骤中的帮助:
- 无 - 配置不含步骤帮助的步骤。
- 文本 - 在文本文本框中配置步骤的帮助文本。
可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式,则必须将文本格式设置如下:
'For further assistance, please contact' + JobCreator($Job) + '.'
- URL - 在 URL 文本框中为步骤配置指向帮助资源的链接。
注:
在 Web 应用程序中运行的步骤仅支持 HTTP 和 HTTPS URL 格式。 在 ArcGIS Pro 中运行的步骤支持 HTTP、HTTPS 和文件格式。
还可以使用 Arcade 表达式提供动态值。 如果 URL 包含纯文本和 Arcade 表达式,则必须将文本格式设置如下:
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'
配置自动编码 Arcade 结果复选框:
- 如果 Arcade 表达式返回了在转换为 URL 时必须进行转义的特殊字符(例如空格或正斜线),请确保已选中自动编码 Arcade 结果复选框。
- 如果使用 Arcade 表达式构建基础 URL,则请取消选中自动编码 Arcade 结果复选框。
- 或者,单击样式选项卡以更改步骤的形状和颜色。
- 或者,单击关于选项卡并在步骤描述文本框中提供该步骤的描述。
提示:
关于选项卡还包含步骤 ID,可与动态作业属性配合使用以获取步骤的输出。 单击复制步骤 ID 将步骤 ID 复制到剪贴板。
返回值
当该步骤完成时,将存储返回值以指示该步骤的结果。 可以使用路径立即评估返回值,以确定工作流中的后续步骤。 您还可以使用 ArcGIS Arcade 表达式在整个工作流中检索已完成步骤的返回值。 下表列出了该步骤的返回值:
返回值 | 描述 |
---|---|
S000001 | 该步骤成功完成。 |
F000001 | 该步骤未能成功完成。 |
输出值
该步骤完成后,其输出值将被存储,可用于确定工作流所遵循的路径,或者可用作整个工作流中其他步骤的输入。 下表列出了该步骤的输出值:
输出 | 描述 |
---|---|
版本 | 将返回所设置版本的数组。 |
dataSource | 将返回已成功设置版本的数据源 URL 数组。 |