“打开 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 中打开项目的顺序取决于将其添加至步骤的顺序。
执行以下操作来配置该步骤：
- 创建或编辑工作流示意图，以访问步骤库面板。
- 将打开 Pro 工程项目从步骤库面板拖至工作流画布上步骤的连接箭头。
步骤详细信息面板随即出现。
- 在步骤名称文本框中提供步骤的名称。
- 或者，在用户提示文本框中添加您希望在该步骤运行时显示的消息。
如果用户提示包含纯文本和 Arcade 表达式，请将文本格式设置如下：
'This job is currently assigned to ' + JobOwner($Job) + '.'提示：
单击此输入支持 Arcade 表达式
，然后选择 ArcGIS Arcade 表达式以将其添加至其关联文本框。 - 在参数部分中，单击编辑。
ArcGIS Pro 制图步骤对话框随即显示。
- 在 Pro 工程部分中，选择以下选项之一指定工程所在的位置：
- 当前 - 当前在 ArcGIS Pro 内打开的工程包。
- 门户 - 在 ArcGIS Enterprise 门户或 ArcGIS Online 中托管的工程包。
- 文件路径 - 在网络文件共享或本地文件系统中托管的工程包。
还可以使用 ArcGIS Arcade 表达式提供动态值。
- 如果选择门户，单击添加 Pro 工程，然后执行以下操作：
- 选择以下选项之一指定工程包所在的位置：
- ArcGIS Online - 在 ArcGIS Online 中托管的工程包。
- 其他 - 位于 ArcGIS Enterprise 门户中的工程包。
- 如果选择其他，在门户 URL 文本框中提供包含工程包的门户的 URL，然后按 Enter 键。
对于 ArcGIS Enterprise，请使用格式 https://webadaptorhost.domain.com/webadaptorname。
- （可选）在项目 ID 文本框中，提供其他工程包名称。
- （可选）在参考名称文本框中，提供工程包的其他参考名称。
这是在步骤配置中显示的名称。
- 单击确定。
工程包将显示在 ArcGIS Pro 制图步骤对话框中。
注：
要编辑工程包，可单击编辑；要删除工程包，可单击删除。
- 选择以下选项之一指定工程包所在的位置：
- 如果选择文件路径，则在文件路径文本框中提供工程包的本地或网络路径。
- 在打开项目部分中，单击打开新项目以添加要在工程中打开的项目。
注：
运行步骤时，项目必须位于 ArcGIS Pro 工程中，否则步骤将失败。
- 单击更改输入类型下拉箭头，然后为名称文本框选择输入类型：
- 字符串 - 为项目名称提供字符串值。
- Arcade - 使用 Arcade 表达式为项目名称提供动态值。
- 在名称文本框中，提供要使用的项目的名称。
- 在类型下拉菜单中，选择要使用的项目的类型：
- 地图 - 地图
- 布局 - 页面布局
- 场景 - 局部或全球场景
- 任务 - 任务项目
- 或者，重复以上步骤以添加更多项目。
提示：
要删除项目，将光标悬停在项目上，然后单击删除项目
。 - （可选）如果选择门户或文件路径作为 Pro 工程设置，选中关闭 ArcGIS Pro 工程复选框以在步骤暂停或完成时关闭工程。
在步骤暂停或完成后，工程将关闭，ArcGIS Pro 将保持打开，以允许用户恢复该步骤或完成更多步骤。
- （可选）单击高级选项卡，然后根据需要配置选项。
- 缩放至位置 - 如果定义了作业位置，将地图缩放至作业位置。
- 查看错误检查器 - 打开错误检查器窗格，以检查地图上的错误要素。
- 运行 ArcGIS Pro 命令 - 在步骤中配置的项目打开时，运行 ArcGIS Pro 自定义加载项命令。
单击添加命令，然后指定想要运行的自定义加载项命令的命令 ID。 或者，您也可以重新排序命令或删除命令。
了解有关在 ArcGIS Pro 中的屏幕提示中显示命令 ID 的详细信息
注：
仅可以使用自定义加载项的命令 ID。 如果指定了多个命令，则命令将按照在步骤中配置的顺序运行。
- （可选）打开将编辑限制为作业位置将编辑限制为作业位置。
- 单击运算符下拉箭头，然后选择以下选项之一：
- 与作业位置相交 - 允许对与作业位置相交的要素进行编辑。
- 完全位于作业位置内 - 允许对完全位于作业位置内的要素进行编辑。
- （可选）在缓冲区文本框中提供值，以允许对作业位置指定距离内的要素进行编辑。
还可以使用 ArcGIS Arcade 表达式提供动态值。
如果缓冲区包含 Arcade 表达式，它必须评估为整数。
- 单击运算符下拉箭头，然后选择以下选项之一：
- 单击保存。
注：
当参数配置了无效值时，保存不可用。
- 单击选项选项卡。
- 根据需要配置步骤选项。
- 手动 - 手动运行步骤。
- 可选 - 允许完成步骤而无需运行。
- 自动 - 步骤被激活后立即执行。
- 按计划运行 - 根据您设置的计划运行步骤。
- 手动 - 手动运行步骤。
- 或者，选中步骤注释部分中的启用复选框，以允许用户在运行步骤时向该步骤添加注释。
- 或者，如果您启用了步骤注释，请选中步骤注释部分中的必需复选框，以要求在完成步骤之前将注释添加到步骤中。
- （可选）选择以下选项之一配置步骤中的帮助：
- 无 - 配置不含步骤帮助的步骤。
- 文本 - 在文本文本框中配置步骤的帮助文本。
可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式，则必须将文本格式设置如下：
'For further assistance, please contact' + JobCreator($Job) + '.' - URL - 在 URL 文本框中为步骤配置指向帮助资源的链接。
注：
仅支持 HTTP 和 HTTPS URL 格式。
还可以使用 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 结果复选框。
- 或者，单击样式选项卡以更改步骤的形状和颜色。
- 或者，单击关于选项卡并在步骤描述文本框中提供该步骤的描述。
提示：
关于选项卡还包含步骤 ID，可与动态作业属性配合使用以获取步骤的输出。 单击复制步骤 ID
将步骤 ID 复制到剪贴板。
返回值
当该步骤完成时，将存储返回值以指示该步骤的结果。 可以使用路径立即评估返回值，以确定工作流中的后续步骤。 您还可以使用 ArcGIS Arcade 表达式在整个工作流中检索已完成步骤的返回值。 下表列出了该步骤的返回值：
| 返回值 | 描述 |
|---|---|
| S000001 | 该步骤成功完成。 |
F000001 | 该步骤未能成功完成。 |