添加和配置“更新作业属性”

运行作业的用户可通过“更新作业属性”步骤更新扩展属性和以下作业属性:

  • job_name
  • start_date
  • due_date
  • priority_rank
  • description
  • owned_by
  • job_status
  • notes
  • parent_job

运行步骤时,作业中将显示在步骤中配置的属性。 如果为步骤配置了步骤帮助,则其会显示在作业底部。 默认值或当前值将在每个属性下可以更新的文本框中显示。

如果属性包含无效值或必需属性不含值,则属性将以红色高亮显示并且继续不可用。

注:

如果属性已自动更新并且遇到错误,则步骤将失败,作业中将显示一条错误。 该错误还会写入 ArcGIS Server 日志。

运行该步骤时,可以执行以下操作:

  • 通过单击取消,可以取消该步骤。
  • 可通过单击继续来继续执行步骤。

配置步骤

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

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

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

  3. 步骤名称文本框中提供步骤的名称。
  4. 或者,在用户提示文本框中添加您希望在该步骤运行时显示的消息。

    如果用户提示包含纯文本和 Arcade 表达式,请将文本格式设置如下:

    'This job is currently assigned to ' + JobOwner($Job) + '.'
    提示:

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

  5. 单击作业属性下拉箭头,然后选择要更新的扩展属性或作业属性。

    可以在作业属性文本框中提供关键字以过滤列表,使其显示包含该关键字的有效作业属性。

  6. 可以选择性地单击显示默认值 Show Default Value 以定义运行步骤时属性的默认值和可见性设置。
    1. 选择以下选项之一:
      • - 提供静态值。
      • Arcade 表达式 - 使用 Arcade 表达式提供动态值
    2. Arcade 表达式文本框中提供属性的默认值。
    3. 选中可见复选框允许在运行步骤时更改值。
      警告:

      如果未选中可见复选框,则必须提供默认值。

    4. 选中可编辑复选框以允许在运行步骤时编辑值。
      注:

      如果未选中可见复选框,则可编辑复选框将不可用。

    注:

    在该步骤中选中可见可编辑复选框将覆盖扩展属性表中的可见可编辑复选框规范。

  7. (可选)单击添加新作业属性,然后重复步骤 5 和 6 添加更多属性。
    注:

    要删除作业属性,请将鼠标悬停在该属性上,然后单击删除属性 Delete Property

  8. (可选)将鼠标悬停在属性上,单击重新排序属性 Reorder Property,然后将其拖至所需位置以重新排序属性。
  9. 单击选项选项卡。
  10. 根据需要配置步骤选项
    • 手动 - 手动运行步骤。
      • 可选 - 允许完成步骤而无需运行。
    • 自动 - 步骤被激活后立即执行。
      注:

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

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

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

  11. 或者,选中步骤注释部分中的启用复选框,以允许用户在运行步骤时向该步骤添加注释。
  12. 或者,如果您启用了步骤注释,请选中步骤注释部分中的必需复选框,以要求在完成步骤之前将注释添加到步骤中。
  13. (可选)选择以下选项之一配置步骤中的帮助:
    • - 配置不含步骤帮助的步骤。
    • 文本 - 在文本文本框中配置步骤的帮助文本。

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

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

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

返回值

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

返回值描述

S000001

该步骤成功完成。

F000001

该步骤未能成功完成。

相关主题


在本主题中
  1. 配置步骤
  2. 返回值