添加和配置“定义位置”

“定义位置”步骤用于为作业识别需要执行工作的位置。 位置可以是现有要素服务中、ArcGIS Pro 工程中或 ArcGIS Workflow Manager Web 应用程序的 Web 地图中的点、线或面。

如果该步骤在 Workflow Manager Web 应用程序中运行并且选择地图作为定位方法，作业中将显示在步骤中配置的 Web 地图。 为步骤配置步骤帮助时，则其会显示在作业磁贴底部。 可选图层将在地图上显示，除作业位置图层之外的所有附加图层均为只读。 使用管理图层微件 更改各个图层的可见性，使用绘制要素 或选择要素 微件定义作业的位置。

注：

如果作业位置已定义，则无法对其进行编辑，但是可以通过绘制或选择新要素进行替换。

如果该步骤在 ArcGIS Pro 中运行并且选择地图作为选择方法，则运行步骤时作业位置图层将添加至在步骤中配置的地图，并且创建要素窗格将出现并显示作业位置图层。 为步骤配置步骤帮助时，则其会显示在作业磁贴底部。 使用创建要素窗格定义作业的位置。

用于作业位置的几何类型基于在步骤中配置的几何类型。 定义作业位置时，考虑以下条件：

• 只有具有面、折线或多点几何类型的要素才可以保存为作业的位置。 曲线几何不受支持。
• 圆形、椭圆形、河道、手绘和自动完成手绘折线和面构造工具不能用于定义作业的位置。
• 如果选择了几何类型正确的多个面要素或多个线要素，则位置将另存为多部件要素。
• 在 Workflow Manager Web 应用程序中绘制位置时，将移除任何现有选择，选择要素时，将移除绘制的位置。

如果选择地图作为定位方法，则可以在运行步骤时执行以下操作：

• 可以定义作业位置。
• 通过单击取消，可以取消该步骤。
• 可通过单击继续来继续执行步骤。

如果选择几何作为定位方法，将在运行步骤时自动定义作业位置，并且将自动完成步骤。 如果 ArcGIS Arcade 表达式返回的几何为空或无效，则该步骤将失败。 如果几何类型返回的 Arcade 表达式与在步骤中配置的几何类型不一致，则该步骤将失败。

配置步骤

要配置步骤，请执行以下操作：

1. 创建或编辑工作流示意图，以访问步骤库面板。
2. 将定义位置从步骤库面板拖至工作流画布上步骤的连接箭头。

   了解有关向工作流示意图添加步骤的详细信息

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

3. 在步骤名称文本框中提供步骤的名称。
4. 或者，在用户提示文本框中添加您希望在该步骤运行时显示的消息。

   如果用户提示包含纯文本和 ArcGIS Arcade 表达式，请将文本格式设置如下：

   'This job is currently assigned to ' + JobOwner($Job) + '.'

   提示：

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

5. 单击几何类型下拉箭头，然后为作业位置选择几何选择类型。

   还可以使用 ArcGIS Arcade 表达式提供动态值。

6. 选择以下选项之一：
   • 地图 - 允许用户定义作业在地图上的位置。
   • 几何 - 使用坐标以 Esri JSON 格式预定义作业位置。
7. 如果选择地图，请完成以下步骤添加地图：
   1. 根据需要选中选择方法选项：
      • 选择 - 在地图上选择现有要素。
      • 绘制 - 使用 ArcGIS Pro 中的绘制工具或 Workflow Manager Web 应用程序中的微件创建要素。
   2. 从 web 地图下拉菜单中选择 web 地图。
   3. 如果没有与工作流量逻辑示意图关联的 web 地图，则单击添加数据参考。

      随即显示添加数据参考对话框。

   4. 通过执行以下操作之一添加数据参考：
      • 浏览项目 - 在当前门户的项目列表中浏览并进行选择。

        提示：

        可通过将过滤器和标签应用于搜索细化结果。

      • 手动输入项目 ID - 选择数据参考所在的环境并在项目 ID 和参考名称文本框中提供项目 ID 和参考名称。 如果选择其他，提供包含门户 URL 文本框中的数据参考的 ArcGIS 组织 URL。

        该项目通过 Workflow Manager 自动进行验证，并且数据参考类型在类型栏中进行设置。

        如果数据参考无法验证，则必须提供与设定数据参考类型相匹配的有效数据参考项目 ID。

   5. 单击确定保存数据参考或单击取消退出。

      您可以通过单击 X 来删除 Web 地图数据参考。

   6. 从 ArcGIS Pro 下拉菜单中选择 ArcGIS Pro 地图。
   7. 如果没有与工作流逻辑示意图关联的 ArcGIS Pro 地图数据参考，则单击添加 ArcGIS Pro 数据参考。

      随即显示添加 ArcGIS Pro 数据参考对话框，其中 Pro 项目类型框设置为地图。

   8. 在 Pro 项目名称文本框中提供 ArcGIS Pro 地图数据参考的名称。
   9. 单击确定保存数据参考或单击取消退出。

      您可以通过单击 X 来删除 ArcGIS Pro 地图数据参考。

      了解有关管理数据参考的详细信息

   10. （可选）如果为 Web 地图配置了启用搜索，可在搜索文本文本框中提供定义查询、搜索文本或 Arcade 表达式，以便在 Workflow Manager Web 应用程序中运行步骤时缩放至初始地图范围。
8. 如果选择几何，按照以下示例以 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 格式转换为 Esri JSON 格式。

   {GeoJsonToEsriJson(JobExtendedProperty($Job, 'assets', 'geojson'), 'Point'), "spatialReference" : {"wkid" : 4326}}

   使用 shape 字段定义位置。

   JobExtendedProperty($Job, '<table_name>', 'shape')

   注：

   shape 字段是用于从扩展属性表获取几何的字段的名称。

   默认空间参考为 Web 墨卡托辅助球体 (wkid 3857)。 如果 Arcade 表达式返回的几何具有其他空间参考，则将定义位置并将空间参考转换为 wkid 3857。

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

      注：

      如果工作流示意图配置为自动运行一系列步骤，其中包括“运行 GP 服务”步骤，则在用户令牌到期后，尝试自动运行的步骤将失败。 ArcGIS Workflow Manager Advanced 组织扩展模块需要在没有人工干预的情况下运行额外的自动步骤。

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

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

11. （可选）选择以下选项之一配置步骤中的帮助：
    • 无 - 配置不含步骤帮助的步骤。
    • 文本 - 在文本文本框中配置步骤的帮助文本。

      可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式，请将文本格式设置如下：

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

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

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

    提示：

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

返回值

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

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

输出值

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

输出	描述
<Location>	返回已定义的位置。