添加和配置“创建版本”

许可:

要使用此步骤,必须为组织成员分配 ArcGIS Advanced Editing 用户类型扩展模块的许可。

版本化允许多个用户使用自己的空间数据版本完成工作,以便协调编辑内容并提交到默认分支版本。 这样可确保用户在适当的时间访问正确的数据,并且可以避免编辑冲突。

运行该步骤时,将检查在工作流中定义的所有要素服务数据源中是否存在现有作业特定数据版本。 如果数据源不含作业特定版本,“创建版本”步骤将自动创建该版本并将其与作业相关联。 “创建版本”步骤仅支持为在作业工作流示意图中定义的数据源的每个要素服务创建单一作业版本。

当该步骤完成运行时,作业切片上会显示一条消息,其中包含该步骤的结果。

如果尚未定义步骤的数据源,或者如果步骤无法创建版本,将显示 CreateVersionFailed 消息,作业不会继续执行下一步。 将光标悬停在该错误消息上可显示有关错误的其他信息。

如果某个步骤失败,返回代码与任何配置路径都不匹配,且该步骤不是可选的,则该步骤将维持失败状态,并且无法跳过。

配置步骤

执行以下操作来配置该步骤:

  1. 创建编辑工作流示意图,以访问步骤库面板。
  2. 创建版本步骤库面板拖至工作流画布上步骤的连接箭头。

    步骤详细信息面板随即出现。

  3. 步骤名称文本框中提供步骤的名称。
  4. (可选)在版本名称文本框中提供版本的名称。
    提示:

    要将唯一 ID 添加至版本名称,在版本名称中要显示唯一 ID 的位置键入 [index]

  5. 根据需要在访问权限部分中配置版本的权限级别。
    注:

    访问权限设置可用于限制非版本所有者的用户查看或编辑版本。 默认值为私有

  6. 数据源部分中,选择以下选项之一:
    • 全部 - 选择此选项可为在工作流示意图中配置的所有数据源创建版本。
    • 选择源 - 选择此选项,然后单击添加源可选择要为其创建版本的数据源。
      提示:

      要删除数据源,单击删除 Delete

    • Arcade 表达式 - 选择此选项,然后提供 ArcGIS Arcade 表达式可动态引用运行步骤时将为其创建版本的数据源。

      Arcade 表达式必须返回空间数据源 ID。而不是空间数据源名称。 如果需要选择多个数据源,则需要如下格式化表达式:

      '["' + JobExtendedProperty($Job, 'versions', 'datasource1') + '"' + ',' + '"' + JobExtendedProperty($Job, 'versions', 'datasource2') + '"]'
      提示:

      单击此输入支持 Arcade 表达式 This input supports Arcade expressions,然后选择 ArcGIS Arcade 表达式以将其添加至其关联文本框。

  7. 单击选项选项卡。
  8. 根据需要配置步骤选项
    • 手动 - 手动运行步骤。
      • 可选 - 允许完成步骤而无需运行。
    • 自动 - 步骤被激活后立即执行。
      注:

      如果您的工作流示意图配置为自动运行一系列步骤,其中包括“评估数据质量”或“运行 GP 服务”步骤,则在启动步骤序列的用户令牌到期后,尝试自动运行的步骤将失败。 您必须拥有 ArcGIS Workflow Manager Server Advanced 角色的许可才能继续运行更多自动化步骤,而无需手动干预。

    • 按计划运行 - 根据您设置的计划运行步骤。

      了解有关计划工具的详细信息

  9. (可选)选择以下选项之一配置步骤中的帮助:
    • - 配置不含步骤帮助的步骤。
    • 文本 - 在文本文本框中配置步骤的帮助文本。

      可以使用 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 结果复选框。

  10. 或者,单击样式选项卡以更改步骤的形状和颜色。
  11. 或者,单击关于选项卡并在步骤描述文本框中提供该步骤的描述。
    提示:

    关于选项卡还包含步骤 ID,可与动态作业属性配合使用以获取步骤的输出。 单击复制步骤 ID Copy Step ID 将步骤 ID 复制到剪贴板。

返回值

当该步骤完成时,将存储返回值以指示该步骤的结果。 可以使用路径立即评估返回值,以确定工作流中的后续步骤。 您还可以使用 ArcGIS Arcade 表达式在整个工作流中检索已完成步骤的返回值。 下表列出了该步骤的返回值:

返回值描述

S000001

该步骤成功完成。

F000001

该步骤未能成功完成。

输出值

该步骤完成后,其输出值将被存储,可用于确定工作流所遵循的路径,或者可用作整个工作流中其他步骤的输入。 下表列出了该步骤的输出值:

输出描述

版本

返回所有已创建版本数组。

数据源

返回已成功创建版本的所有数据源 URL 数组。

dataSourceNames

返回每个创建版本的所有数据源名称的数组。

相关主题