Survey123 步骤可用于在 ArcGIS Workflow Manager 中采集、查看和编辑 ArcGIS Survey123 调查。
Survey123 步骤需要通过调查表单创建扩展属性表，才能将调查数据与作业相关联。 在提交调查后，关联的扩展属性表将使用调查采集的数据进行填充。 如果未通过调查表单创建扩展属性表，那么可以采集调查，但是作业无法访问采集的数据。
提示：
要显示或编辑在工作流外部采集的调查中的数据，请通过调查表单创建扩展属性表。 在工作流示意图中的 Survey123 步骤前面添加更新作业属性步骤，然后使用现有调查的 globalid 更新扩展属性表中的链接 ID 值。
在 Workflow Manager Web 应用程序中运行步骤时，作业磁贴中将显示在步骤中配置的调查。 在 ArcGIS Pro 中运行步骤时，作业磁贴上将显示在 Web 上打开按钮，用于在 Workflow Manager Web 应用程序中打开步骤中配置的调查。如果为步骤配置了步骤帮助，则帮助文本会显示在作业磁贴的底部。
运行该步骤时，可以执行以下操作：
- 可以提交、查看或编辑已配置的调查。
- 通过单击取消，可以取消该步骤。
- 可通过单击继续来继续执行步骤。
配置步骤
要配置步骤，请执行以下操作：
- 创建或编辑工作流示意图，以访问步骤库面板。
- 将 Survey123 从步骤库面板拖至工作流画布上步骤的连接箭头。
步骤详细信息面板随即出现。
- 在步骤名称文本框中提供步骤的名称。
- 在 Survey123 表单部分中，单击添加 Survey123 表单。
随即显示添加 Survey123 表单对话框。
- 要指定 Survey123 表单所在的位置，选择以下选项之一：
- ArcGIS Online - 添加位于 ArcGIS Online 上的调查。
- 其他 - 添加位于 ArcGIS Enterprise 门户上的公共调查。
- 如果选择其他，在门户 URL 文本框中提供包含调查的门户的 URL，然后按 Enter 键。
对于 ArcGIS Enterprise，请使用格式 https://webadaptorhost.domain.com/webadaptorname。
- 在表单 ID 文本框中，提供调查的表单 ID。
- 在引用名称文本框中，提供调查的名称。
- 单击确定。
步骤详细信息面板中将显示测量。
注：
可通过单击删除测量按钮
删除测量。 - 单击关系开关按钮在与 Workflow Manager 作业具有一对一 (1-1) 或一对多 (1-M) 调查关系之间进行切换。
- 1-1 - 将关系设置为一对一，以仅允许将一个调查与作业相关联。
- 1-M - 将关系设置为一对多，以允许将多个测量与作业相关联。
- 选择以下选项之一作为模式设置：
- 新建 - 创建并采集测量。
注：
此选项仅适用于具有一对多 (1-M) 关系的测量。
- 编辑 - 编辑测量。
注：
如果不存在作业测量，将创建并采集测量。 如果测量配置为具有一对多 (1-M) 关系，将编辑上次采集的测量。
- 查看 - 查看测量。
注：
如果测量配置为具有一对多 (1-M) 关系，将打开上次采集的测量进行查看。
- 新建 - 创建并采集测量。
- 单击选项选项卡。
- 根据需要配置步骤选项：
- 手动 - 手动运行步骤。
- 可选 - 允许完成步骤而无需运行。
- 自动 - 步骤被激活后立即执行。
注：
如果工作流示意图配置为自动运行一系列步骤，其中包括“运行 GP 服务”步骤，则在用户令牌到期后，尝试自动运行的步骤将失败。 ArcGIS Workflow Manager Advanced 组织扩展模块需要在没有人工干预的情况下运行额外的自动步骤。
- 按计划运行 - 根据您设置的计划运行步骤。
- 手动 - 手动运行步骤。
- （可选）选择以下选项之一配置步骤中的帮助：
- 无 - 配置不含步骤帮助的步骤。
- 文本 - 在文本文本框中配置步骤的帮助文本。
可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式，则必须将文本格式设置如下：
'For further assistance, please contact' + JobCreator($Job) + '.'提示：
单击此输入支持 Arcade 表达式
，然后选择 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 结果复选框。
- 或者，单击样式选项卡以更改步骤的形状和颜色。
- 或者，单击关于选项卡并在步骤描述文本框中提供该步骤的描述。
提示：
关于选项卡还包含步骤 ID，可与动态作业属性配合使用以获取步骤的输出。 单击复制步骤 ID
将步骤 ID 复制到剪贴板。
返回值
当该步骤完成时，将存储返回值以指示该步骤的结果。 可以使用路径立即评估返回值，以确定工作流中的后续步骤。 您还可以使用 ArcGIS Arcade 表达式在整个工作流中检索已完成步骤的返回值。 下表列出了该步骤的返回值：
| 返回值 | 描述 |
|---|---|
| S000001 | 该步骤成功完成。 |
F000001 | 该步骤未能成功完成。 |
输出值
该步骤完成后，其输出值将被存储，可用于确定工作流所遵循的路径，或者可用作整个工作流中其他步骤的输入。 下表列出了该步骤的输出值：
| 输出 | 描述 |
|---|---|
<GlobalID> | 返回上次创建、查看或编辑的调查的 globalid。 |