添加和配置“打开 Pro 工程项目”

“打开 Pro 工程项目”步骤用于在 ArcGIS Pro 中打开现有工程或工程包。 可以配置要添加至工程的项目，例如地图、布局、场景、任务项目和 Web 地图，以确保对正确的项目执行操作。 如果工程包含制图项目，则数据图层可以自动指向适当的作业特定数据版本。

在 ArcGIS Pro 中运行该步骤时，在该步骤中定义的项目将在指定的 ArcGIS Pro 工程中打开。 如果该步骤已配置运行 ArcGIS Pro 命令选项，则在工程打开时将运行步骤中配置的 ArcGIS Pro 自定义加载项命令。 如果该步骤已配置查看错误检查器选项，则在工程打开时会显示错误检查器窗格，并且一个包含错误要素的图层将添加到 ArcGIS Pro 中的地图。 为步骤配置步骤帮助时，则步骤配置会显示在作业磁贴底部。

在 ArcGIS Workflow Manager Web 应用程序中运行该步骤时，作业磁贴中将显示下载 ArcGIS Pro 工程按钮。 下载 .pitemx 文件，然后双击该文件以在 ArcGIS Pro 中打开该工程。 如果该步骤已配置运行 ArcGIS Pro 命令选项，则 ArcGIS Pro 将运行已配置的自定义加载项命令。 如果该步骤已配置查看错误检查器选项，将显示错误检查器窗格，并且一个包含错误要素的图层将添加到地图。 为步骤配置步骤帮助时，则其会显示在作业磁贴底部。

警告：

在 ArcGIS Pro 中打开下载的 .pitemx 文件之前，请添加门户连接以连接到包含工作流项目的门户。

只能使用一次 .pitemx 文件以在 ArcGIS Pro 中打开该工程。 要再次打开该工程，您必须从 Workflow Manager Web 应用程序的作业中下载新的 .pitemx 文件。

运行该步骤时，可以执行以下操作：

• 可通过单击暂停来暂停步骤。
• 可通过单击完成来完成步骤。

注：

如果步骤不是可选步骤，则步骤必须先运行或暂停至少一次，然后才能完成。

配置步骤

可以添加在 ArcGIS Enterprise 门户、ArcGIS Online 或文件系统中托管的工程包。 可以配置要添加至工程的项目，例如地图、布局、场景、Web 地图和任务项目。 在 ArcGIS Pro 中打开项目的顺序取决于将其添加至步骤的顺序。

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

1. 创建或编辑工作流示意图，以访问步骤库面板。
2. 将打开 Pro 工程项目从步骤库面板拖至工作流画布上步骤的连接箭头。

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

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

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

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

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

   提示：

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

5. 在参数部分中，单击编辑。

   ArcGIS Pro 制图步骤对话框随即显示。

6. 在 Pro 工程部分中，选择以下选项之一指定工程所在的位置：
   • 当前 - 当前在 ArcGIS Pro 内打开的工程包。

     了解有关在 ArcGIS Pro 中打开工程的详细信息

   • 门户 - 在 ArcGIS Enterprise 门户或 ArcGIS Online 中托管的工程包。
   • 文件路径 - 在网络文件共享或本地文件系统中托管的工程包。

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

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

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

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

        提示：

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

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

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

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

   3. 单击确定保存数据参考或单击取消退出。
9. 如果选择文件路径，则在文件路径文本框中提供工程包的本地或网络路径。
10. 在打开项目部分中，单击打开新项目以添加要在工程中打开的项目。

    注：

    运行步骤时，项目必须位于 ArcGIS Pro 工程中，否则步骤将失败。

11. 单击更改输入类型下拉箭头，然后为名称文本框选择输入类型：

    • 选择 - 从与工作流逻辑示意图相关联的 ArcGIS Pro 数据参考列表中选择。 如果没有与工作流逻辑示意图关联的 ArcGIS Pro 数据参考，则单击添加 ArcGIS Pro 数据参考。

      从 Pro 项目类型下拉菜单中选择项目类型并在 Pro 项目名称 文本框中提供项目的名称。

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

    • Arcade - 从类型下拉菜单中选择项目类型并使用 Arcade 表达式为项目名称提供动态值。
12. 或者，重复以上步骤以添加更多项目。

    提示：

    要删除项目，将光标悬停在项目上，然后单击删除项目 。

13. （可选）如果选择门户或文件路径作为 Pro 工程设置，选中关闭 ArcGIS Pro 工程复选框以在步骤暂停或完成时关闭工程。

    在步骤暂停或完成后，工程将关闭，ArcGIS Pro 将保持打开，以便可以恢复该步骤或完成更多步骤。

14. （可选）单击高级选项卡，然后根据需要配置选项。
    • 缩放至位置 - 如果定义了作业位置，将地图缩放至作业位置。
    • 查看错误检查器 - 打开错误检查器窗格，以检查地图上的错误要素。

      对于要素服务数据源，错误图层必须在服务中存储并且数据源必须为具有验证功能的分支版本。

    • 运行 ArcGIS Pro 命令 - 在步骤中配置的项目打开时，运行 ArcGIS Pro 自定义加载项命令。 从下拉菜单中选择 ArcGIS Pro 命令。

      如果没有与工作流逻辑示意图关联的 ArcGIS Pro 命令数据参考，则单击添加 ArcGIS Pro 数据参考并在命令名称和命令 ID 文本框中提供命令名称和命令 ID。

      或者，单击添加命令以添加更多 ArcGIS Pro 命令。

      注：

      仅可以使用自定义加载项的命令 ID。 如果指定了多个命令，则命令将按照在步骤中配置的顺序运行。

      了解有关在 ArcGIS Pro 中的屏幕提示中显示命令 ID 的详细信息

15. （可选）打开将编辑限制为作业位置将编辑限制为作业位置。
    1. 单击运算符下拉箭头，然后选择以下选项之一：
       • 与作业位置相交 - 允许对与作业位置相交的要素进行编辑。
       • 完全位于作业位置内 - 允许对完全位于作业位置内的要素进行编辑。
    2. （可选）在缓冲区文本框中提供值，以允许对作业位置指定距离内的要素进行编辑。

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

       如果缓冲区包含 Arcade 表达式，它必须评估为整数。

16. 单击保存。

    注：

    当参数配置了无效值时，保存不可用。

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

      注：

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

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

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

19. 或者，选中步骤注释部分中的启用复选框，以允许用户在运行步骤时向该步骤添加注释。
20. 或者，如果您启用了步骤注释，请选中步骤注释部分中的必需复选框，以要求在完成步骤之前将注释添加到步骤中。
21. （可选）选择以下选项之一配置步骤中的帮助：
    • 无 - 配置不含步骤帮助的步骤。
    • 文本 - 在文本文本框中配置步骤的帮助文本。

      可以使用 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 结果复选框。

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

    提示：

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

返回值

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

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