添加并配置 Survey123

Survey123 步骤可用于在 ArcGIS Workflow Manager 中采集、查看和编辑 ArcGIS Survey123 测量。

Survey123 步骤需要通过测量表单创建扩展属性表,才能将测量数据与作业相关联。 在提交测量后,关联的扩展属性表将使用测量采集的数据进行填充。 如果未通过测量表单创建扩展属性表,则可以采集测量,但是作业无法访问采集的数据。

提示:

要查看在工作流外部采集的测量中的数据,通过测量表单创建扩展属性表。 在工作流逻辑示意图中 Survey123 步骤前面添加更新作业属性步骤,然后使用现有测量的 globalid 更新扩展属性表中的链接 ID 值。

Workflow Manager Web 应用程序中运行步骤时,作业切片中将显示在步骤中配置的测量。 在 ArcGIS Pro 中运行步骤时,作业切片上将显示在 Web 上打开按钮,用于在 Workflow Manager Web 应用程序中打开在步骤中配置的测量。如果为步骤配置了帮助文本,该文本将在作业切片的底部显示。

注:

运行步骤的用户在 Survey123 中必须具有足够的权限,才能查看、编辑或提交在步骤中配置的测量表单。

了解有关在 Survey123 中共享测量的详细信息

警告:

如果未在 ArcGIS Workflow Manager Server 所在的 ArcGIS Enterprise 门户上托管在步骤中配置的测量,建议使用不同的 Web 浏览器登录 Workflow Manager Web 应用程序和 Survey123。 如果在运行步骤时在同一 Web 浏览器中登录多个门户,则将使用 Survey123 凭据访问测量,而不是 Workflow Manager 凭据。

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

  • 可以提交、查看或编辑已配置测量。
  • 可通过单击取消取消步骤。
  • 可通过单击继续来继续执行步骤。

配置步骤

要配置步骤,请执行以下操作:

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

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

  3. 步骤名称文本框中提供步骤的名称。
  4. Survey123 表单部分中,单击添加 Survey123 表单

    随即显示添加 Survey123 表单对话框。

  5. 要指定 Survey123 表单所在的位置,选择以下选项之一:
    • 此 Enterprise - 添加在 Workflow Manager 所在门户上可用的测量
    • ArcGIS Online - 添加位于 ArcGIS Online 上的公共测量
    • 其他 - 添加位于另一个门户上的公共测量
  6. 如果选择其他,在门户 URL 文本框中键入包含调查的门户的 URL,然后按 Enter 键。

    例如,格式可以是 https://webadaptorhost.domain.com/webadaptorname

  7. 表单 ID 文本框中,键入调查的表单 ID。
  8. 引用名称文本框中,提供调查的名称。
  9. 单击确定

    步骤详细信息面板中将显示测量。

    注:

    可通过单击删除测量按钮 Delete Survey 删除测量。

  10. 单击关系开关按钮在与 Workflow Manager 作业表具有一对一 (1-1) 或一对多 (1-M) 测量关系之间进行切换。
    • 1-1 - 将关系设置为一对一,以仅允许将一个测量与作业相关联。
    • 1-M - 将关系设置为一对多,以允许将多个测量与作业相关联。
  11. 选择以下选项之一作为模式设置:
    • 新建 - 创建并采集测量。
      注:

      此选项仅适用于具有一对多 (1-M) 关系的测量。

    • 编辑 - 编辑测量。
      注:

      如果不存在作业测量,将创建并采集测量。 如果测量配置为具有一对多 (1-M) 关系,将编辑上次采集的测量。

    • 查看 - 查看测量。
      注:

      如果测量配置为具有一对多 (1-M) 关系,将打开上次采集的测量进行查看。

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

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

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

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

  14. 或者,在步骤帮助文本框中提供该步骤的帮助文本。

    您也可以借助以下示例使用 ArcGIS Arcade 表达式显示动态值:

    
    'For further assistance, please contact ' + jobCreator($job) + '.'
  15. 或者,单击样式选项卡以更改步骤的形状和颜色。
  16. 或者,单击关于选项卡并在步骤描述文本框中提供该步骤的描述。
    注:

    关于选项卡还包含步骤 ID,可与动态作业属性配合使用以获取步骤的输出。

返回值

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

返回值描述

S000001

该步骤成功完成。

F000001

该步骤未能成功完成。

输出值

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

输出描述ArcGIS Arcade 表达式语法

<GlobalID>

返回上次创建、查看或编辑的测量的 globalid

jobOutputValue($job, '<step_id>')

相关主题