添加并配置 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 键。

   对于 ArcGIS Enterprise，请使用格式 https://webadaptorhost.domain.com/webadaptorname。

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

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

   注：

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

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 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式，则必须将文本格式设置如下：

      
      'For further assistance, please contact' + JobCreator($Job) + '.'

      提示：

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

    • 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 结果复选框。

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

    提示：

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

返回值

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

返回值	描述
S000001	该步骤成功完成。
F000001	该步骤未能成功完成。

输出值

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

输出	描述
<GlobalID>	返回上次创建、查看或编辑的调查的 globalid。