Survey123 步骤可用于在 ArcGIS Workflow Manager 中采集、查看和编辑 ArcGIS Survey123 测量。
Survey123 步骤需要通过测量表单创建扩展属性表，才能将测量数据与作业相关联。 在提交测量后，关联的扩展属性表将使用测量采集的数据进行填充。 如果未通过测量表单创建扩展属性表，则可以采集测量，但是作业无法访问采集的数据。
提示：
要查看在工作流外部采集的测量中的数据，通过测量表单创建扩展属性表。 在工作流逻辑示意图中 Survey123 步骤前面添加更新作业属性步骤，然后使用现有测量的 globalid 更新扩展属性表中的链接 ID 值。
在 Workflow Manager Web 应用程序中运行步骤时，作业切片中将显示在步骤中配置的测量。 在 ArcGIS Pro 中运行步骤时，作业切片上将显示在 Web 上打开按钮，用于在 Workflow Manager Web 应用程序中打开在步骤中配置的测量。如果为步骤配置了帮助文本，该文本将在作业切片的底部显示。
警告：
如果未在 ArcGIS Workflow Manager Server 所在的 ArcGIS Enterprise 门户上托管在步骤中配置的测量，建议使用不同的 Web 浏览器登录 Workflow Manager Web 应用程序和 Survey123。 如果在运行步骤时在同一 Web 浏览器中登录多个门户，则将使用 Survey123 凭据访问测量，而不是 Workflow Manager 凭据。
When the step is run, the following actions can be performed:
- 可以提交、查看或编辑已配置测量。
- The step can be cancelled by clicking Cancel.
- The step can be finished by clicking Proceed.
配置步骤
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- 将 Survey123 从步骤库面板拖至工作流画布上步骤的连接箭头。
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- 在 Survey123 表单部分中，单击添加 Survey123 表单。
随即显示添加 Survey123 表单对话框。
- 要指定 Survey123 表单所在的位置，选择以下选项之一：
- 此 Enterprise - 添加在 Workflow Manager 所在门户上可用的测量
- ArcGIS Online - 添加位于 ArcGIS Online 上的公共测量
- 其他 - 添加位于另一个门户上的公共测量
- 如果选择其他，在门户 URL 文本框中键入包含调查的门户的 URL，然后按 Enter 键。
例如，格式可以是 https://webadaptorhost.domain.com/webadaptorname。
- 在表单 ID 文本框中，键入调查的表单 ID。
- 在引用名称文本框中，提供调查的名称。
- 单击确定。
步骤详细信息面板中将显示测量。
注：
可通过单击删除测量按钮
删除测量。 - 单击关系开关按钮在与 Workflow Manager 作业表具有一对一 (1-1) 或一对多 (1-M) 测量关系之间进行切换。
- 1-1 - 将关系设置为一对一，以仅允许将一个测量与作业相关联。
- 1-M - 将关系设置为一对多，以允许将多个测量与作业相关联。
- 选择以下选项之一作为模式设置：
- 新建 - 创建并采集测量。
注：
此选项仅适用于具有一对多 (1-M) 关系的测量。
- 编辑 - 编辑测量。
注：
如果不存在作业测量，将创建并采集测量。 如果测量配置为具有一对多 (1-M) 关系，将编辑上次采集的测量。
- 查看 - 查看测量。
注：
如果测量配置为具有一对多 (1-M) 关系，将打开上次采集的测量进行查看。
- 新建 - 创建并采集测量。
- Click the Options tab.
- Configure Step Options as necessary.
- Manual—Run the step manually.
- Optional—Allow the step to be finished without being run.
- Automatic—Run the step as soon as it becomes active.
注：
If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.
- Run on a Schedule—Run the step according to a schedule you set.
- Manual—Run the step manually.
- Optionally, provide help text for the step in the Step Help text box.
You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:
'For further assistance, please contact ' + jobCreator($job) + '.' - Optionally, click the Style tab to change the shape and color of the step.
- Optionally, click the About tab and provide a description for the step in the Step Description text box.
注：
The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.
Return value
When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:
| Return values | Description |
|---|---|
| S000001 | The step completed successfully. |
F000001 | The step failed to complete successfully. |
输出值
When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:
| 输出 | 描述 | ArcGIS Arcade 表达式语法 |
|---|---|---|
<GlobalID> | 返回上次创建、查看或编辑的测量的 globalid。 | jobOutputValue($job, '<step_id>') |