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

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

注：

如果工程包正用于编辑和同步离线复本图层，则无法在启用在组织外共享选项的情况下共享工程包。

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

在 ArcGIS Workflow Manager Web 应用程序中运行该步骤时，作业磁贴中将显示下载按钮。 下载 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 工程，然后执行以下操作：
   1. 选择以下选项之一指定工程包所在的位置：
      • ArcGIS Online - 在 ArcGIS Online 中托管的工程包。
      • 其他 - 位于 ArcGIS Enterprise 门户中的工程包。
   2. 如果选择其他，在门户 URL 文本框中提供包含工程包的门户的 URL，然后按 Enter 键。

      对于 ArcGIS Enterprise，请使用格式 https://webadaptorhost.domain.com/webadaptorname。

   3. （可选）在项目 ID 文本框中，提供其他工程包名称。
   4. （可选）在参考名称文本框中，提供工程包的其他参考名称。

      这是在步骤配置中显示的名称。

   5. 单击确定。

      工程包将显示在 ArcGIS Pro 制图步骤对话框中。

      注：

      要编辑工程包，可单击编辑；要删除工程包，可单击删除。

8. 如果选择文件路径，则在文件路径文本框中提供工程包的本地或网络路径。
9. 在打开项目部分中，单击打开新项目以添加要在工程中打开的项目。

   注：

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

10. 单击更改输入类型下拉箭头，然后为名称文本框选择输入类型：
    • 字符串 - 为项目名称提供字符串值。
    • Arcade - 使用 Arcade 表达式为项目名称提供动态值。
11. 在名称文本框中，提供要使用的项目的名称。
12. 在类型下拉菜单中，选择要使用的项目的类型：
    • 地图 - 地图
    • 布局 - 页面布局
    • 场景 - 局部或全球场景
    • 任务 - 任务项目
13. 或者，重复以上步骤以添加更多项目。

    提示：

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

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

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

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

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

    • 运行 ArcGIS Pro 命令 - 在步骤中配置的项目打开时，运行 ArcGIS Pro 自定义加载项命令。

      单击添加命令，然后指定想要运行的自定义加载项命令的命令 ID。 或者，您也可以重新排序命令或删除命令。

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

      注：

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

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

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

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

17. 单击保存。

    注：

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

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

      注：

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

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

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

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

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

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

    提示：

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

返回值

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

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