“定义位置”步骤用于为作业识别需要执行工作的位置。 位置可以是现有要素服务中、ArcGIS Pro 工程中或 ArcGIS Workflow Manager Web 应用程序的 Web 地图中的点、线或面。
如果该步骤在 Workflow Manager Web 应用程序中运行并且选择地图作为定位方法,作业切片中将显示在步骤中配置的 Web 地图。 如果为步骤配置了帮助文本,该文件将在作业切片的底部显示。 可选图层将在地图上显示,除作业位置图层之外的所有附加图层均为只读。 使用管理图层微件 更改各个图层的可见性,使用绘制要素 或选择要素 微件定义作业的位置。
注:
如果作业位置已定义,则无法对其进行编辑,但是可以通过绘制或选择新要素进行替换。
如果该步骤在 ArcGIS Pro 中运行并且选择地图作为选择方法,则运行步骤时作业位置图层将添加至在步骤中配置的地图,并且创建要素窗格将出现并显示作业位置图层。 如果为步骤配置了帮助文本,该文件将在作业切片的底部显示。 使用创建要素窗格定义作业的位置。
用于作业位置的几何类型基于在步骤中配置的几何类型。 定义作业位置时,考虑以下条件:
- 只能将具有正确几何类型的要素另存为作业位置。
- 如果选择了几何类型正确的多个面要素或多个线要素,则位置将另存为多部件要素。
- 在 Workflow Manager web 应用程序中绘制位置时,将移除任何现有选择,选择要素时,将移除绘制的位置。
如果选择地图作为定位方法,则可以在运行步骤时执行以下操作:
- 可以定义作业位置。
- 通过单击取消,可以取消该步骤。
- 可通过单击继续来继续执行步骤。
如果选择几何作为定位方法,将在运行步骤时自动定义作业位置,并且将自动完成步骤。 如果 Arcade 表达式返回的几何为空或无效,则该步骤将失败。 如果几何类型返回的 Arcade 表达式与在步骤中配置的几何类型不一致,则该步骤将失败。
配置步骤
执行以下操作来配置该步骤:
- 创建或编辑工作流逻辑示意图,以访问步骤库面板。
- 将定义位置从步骤库面板拖至工作流画布上步骤的连接箭头。
步骤详细信息面板随即出现。
- 在步骤名称文本框中提供步骤的名称。
- 或者,在用户提示文本框中添加您希望在该步骤运行时显示的消息。
如果用户提示包含纯文本和 Arcade 表达式,请将文本格式设置如下:
'This job is currently assigned to ' + JobOwner($Job) + '.'
提示:
单击此输入支持 Arcade 表达式 ,然后选择 ArcGIS Arcade 表达式以将其添加至其关联文本框。
- 单击几何类型下拉箭头,然后为作业位置选择几何选择类型。
还可以使用 ArcGIS Arcade 表达式提供动态值。
- 选择以下选项之一:
- 地图 - 允许用户定义作业在地图上的位置。
- 几何 - 使用坐标以 Esri JSON 格式自动定义作业位置。
- 如果选择地图,执行以下步骤:
- 根据需要选择位置方法选项:
- 选择 - 在地图上选择现有要素。
- 绘制 - 使用 ArcGIS Pro 中的绘制工具或 Workflow Manager Web 应用程序中的微件创建要素。
- 在地图部分的 Web 地图下,单击添加添加要在 Workflow Manager Web 应用程序中使用的 Web 地图。
随即显示定义位置步骤对话框。
注:
Web 地图无法用于在 ArcGIS Pro 中定义位置。 必须提供要在 ArcGIS Pro 工程中使用的地图的名称才能定义位置。
- 要指定 Web 地图所在的位置,选择以下选项之一:
- 此 Enterprise - 添加在 Workflow Manager 所在门户上可用的 web 地图。
- ArcGIS Online - 添加位于 ArcGIS Online 上的公共 Web 地图。
- 其他 - 添加位于另一个门户上的公共 Web 地图。
- 如果选择其他,在门户 URL 文本框中键入包含 web 地图的门户的 URL,然后按 Enter 键。
对于 ArcGIS Enterprise,请使用格式 https://webadaptorhost.domain.com/webadaptorname。
- 在项目 ID 文本框中键入 Web 地图的项目 ID。
- 在引用名称文本框中,提供 Web 地图的名称。
- 单击确定。
步骤详细信息面板中将显示 Web 地图 URL。
注:
要编辑 Web 地图,可单击编辑,要进行删除,单击移除。
- 在 ArcGIS Pro 文本框中提供要在 ArcGIS Pro 工程中使用的地图的名称。
- (可选)如果为 Web 地图配置了启用搜索,在搜索文本文本框中提供定义查询、搜索文本或 Arcade 表达式,以在 Workflow Manager Web 应用程序中运行步骤时缩放至初始地图范围。
- 根据需要选择位置方法选项:
- 如果选择几何,按照以下示例以 Esri JSON 格式使用坐标定义作业位置。
可使用字符串、Arcade 表达式或二者的组合定义位置。
使用 JSON 字符串定义点位置。
{"x" : -118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}}
使用 Arcade 表达式定义点位置。
'{"x":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testx') + ', "y":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testy') + ', "spatialReference" : {"wkid" : ' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'wkid') + "}}"
使用 Arcade 表达式定义点位置,以将坐标从 GeoJSON 格式转换为 EsriJSON 格式。
{GeoJsonToEsriJson(JobExtendedProperty($Job, 'assets', 'geojson'), 'Point'), "spatialReference" : {"wkid" : 4326}}
使用 shape 字段定义位置。
JobExtendedProperty($Job, '<table_name>','shape')
注:
shape 字段是用于从扩展属性表获取几何的字段的名称。
默认空间参考为 Web 墨卡托辅助球体 (wkid 3857)。 如果 Arcade 表达式返回的几何具有其他空间参考,则将定义位置并将空间参考转换为 wkid 3857。
- 单击选项选项卡。
- 根据需要配置步骤选项。
- 手动 - 手动运行步骤。
- 可选 - 允许完成步骤而无需运行。
- 自动 - 步骤被激活后立即执行。
注:
如果您的工作流逻辑示意图配置为自动运行一系列步骤,其中包括“评估数据质量”或“运行 GP 服务”步骤,则在启动步骤序列的用户令牌到期后,尝试自动运行的步骤将失败。 您必须拥有 ArcGIS Workflow Manager Server Advanced 角色的许可才能继续运行更多自动化步骤,而无需手动干预。
- 按计划运行 - 根据您设置的计划运行步骤。
- 手动 - 手动运行步骤。
- 或者,在步骤帮助文本框中提供该步骤的帮助文本。
还可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式,则必须将文本格式设置如下:
'For further assistance, please contact' + JobCreator($Job) + '.'
- 或者,单击样式选项卡以更改步骤的形状和颜色。
- 或者,单击关于选项卡并在步骤描述文本框中提供该步骤的描述。
提示:
关于选项卡还包含步骤 ID,可与动态作业属性配合使用以获取步骤的输出。 单击复制步骤 ID 将步骤 ID 复制到剪贴板。
返回值
当该步骤完成时,将存储返回值以指示该步骤的结果。 可以使用路径立即评估返回值,以确定工作流中的后续步骤。 您还可以使用 ArcGIS Arcade 表达式在整个工作流中检索已完成步骤的返回值。 下表列出了该步骤的返回值:
返回值 | 描述 |
---|---|
S000001 | 该步骤成功完成。 |
F000001 | 该步骤未能成功完成。 |
输出值
该步骤完成后,其输出值将被存储,可用于确定工作流所遵循的路径,或者可用作整个工作流中其他步骤的输入。 下表列出了该步骤的输出值:
输出 | 描述 |
---|---|
<Location> | 返回已定义的位置。 |