| 标注 | 说明 | 数据类型 |
输入工程 | 要打包的工程（.aprx 文件）。 | File |
输出文件 | 输出工程包（.ppkx 文件）。 | File |
在组织外共享 (可选) | 指定是否将工程和所有数据合并、转换或复制到包中（以便在组织外部共享）或按原样引用而不进行转换或不将其包含在包中（以便在组织内部共享）。 注：如果工程通过本地路径（例如 c:\gisdata\landrecords.gdb\）引用数据和地图，则将对这些数据和地图进行合并和打包（不考虑该参数设置）。
| Boolean |
打包为模板 (可选) | 指定将创建工程模板还是工程包。 工程模板可以包含地图、布局、数据库和服务器的连接等。 使用工程模板，可以标准化不同工程的一系列地图并可确保正确的图层可供所有人直接用于他们的地图中。
| Boolean |
范围 (可选) | 指定用于选择或裁剪要素的范围。
当手动提供坐标时，坐标必须为数值，并且位于活动地图的坐标系中。 地图可能使用与提供的坐标不同的显示单位。 在南纬和西经坐标中使用负号。 | Extent |
仅将范围应用于企业级地理数据库图层 (可选) | 指定是将指定范围应用到所有图层，还是仅应用到企业级地理数据库图层。
| Boolean |
附加文件 (可选) | 软件包中将包含的附加文件。 | File |
摘要 (可选) | 将添加到包属性中的摘要信息。 | String |
标签 (可选) | 将添加到包属性中的标签。 使用逗号或分号分隔多个标签。 | String |
包版本 (可选) | 指定与某些对象（例如工程、地图和图层）兼容并将保留到的 ArcGIS Pro 版本。 如果工程将与旧版软件一起使用，则保存为早期版本会很有帮助。 警告：保存为早期版本的包可能会丢失早期版本不支持的功能或属性。
| String |
包括工具箱 (可选) | 指定是否对工程工具箱以及这些工具箱中工具所引用的数据、进行合并并将其包括在输出包中。 所有工程都需要一个默认工具箱，因此无论如何设置，该工具箱都将包含在输出包中。 连接文件夹中的工具箱不会被视为工程工具箱，且不受此设置的影响。
| Boolean |
包括历史项目 (可选) | 指定是否合并地理处理历史项目并将其包括在输出包中。 包括的历史项目将合并重新处理历史项目所需的数据。
| String |
只读包 (可选) | 指定工程是否为只读状态。 无法修改或保存只读工程。
| Boolean |
仅保留与范围内要素相关的行 (可选) | 指定是否将指定的范围应用至相关数据源。
| Boolean |
保留移动地理数据库 (可选) | 指定输入移动地理数据库数据是保留在输出中还是写入文件地理数据库格式。 如果输入数据是移动地理数据库网络数据集，则输出将为移动地理数据库。
| Boolean |
摘要
将 ArcGIS Pro 工程 (.aprx) 及其内容（地图和数据）合并、并打包到已打包的工程文件 (.ppkx) 中。
使用情况
将工程的数据和元素合并到工程包 (.ppkx) 中，这些元素包括地图和 3D 视图、位于地图中的数据和图层、工具箱、地理处理历史项目、样式、布局以及文件夹或连接（服务器、工作流等）（如果适用）。
在组织外共享参数可用于控制是创建供内部使用（组织网络内）的包，还是创建供外部使用的包。 选中在组织外共享后，企业级地理数据库图层、要素服务和跨网络共享（UNC 路径）引用的数据将被复制（或转换）并包含在工程包中。 存储在本地计算机上的数据也将被合并和打包。
注：
如果与无法访问网络资源（企业级地理数据库、要素服务和通过磁盘共享 [UNC 路径] 引用的数据）的同事共享包含引用数据的内部包，则创建的链接将断开。
可使用打包为模板参数创建模板。 使用工程模板（.aptx 文件），可通过定义图层、地图和数据以及所需的连接来创建新工程。
在执行合并过程之前，使用 Pro 分析工具和版本分析工具箱工具来分析工程的工具箱。 识别出的错误会停止合并进程。 修复错误或从工程中删除该工具。 通过取消选中包括工具箱参数可以将工具箱从输出工程包中排除。
与工程工具箱类似，地理处理历史（来自运行地理处理工具的结果信息）将包含在包中。 处理历史项目所需的数据将包括在输出包中，而无论其是否存在于地图或场景中。 任何无效（在处理过程中失败）或者无法找到数据的历史项目都将导致打包过程停止。 您必须移除或修复有问题的历史项目。 通过取消选中包括历史项目参数可以将历史项目从输出工程包中排除。
连接（例如文件夹、服务器、数据库以及工作流）将仅包括在内部包中。 如果创建包时选中了在组织外共享参数，则这些项目将被删除。
对于要素图层，使用范围参数选择将要合并的要素。 对于栅格图层，使用范围参数裁剪栅格数据集。
软件包中将包含的附加文件。 使用附加文件参数，可将图像、PDF、Word 文档和 .zip 文件包括在包中。
警告：
只能通过 ArcGIS Pro 创建和打开工程包 (.ppkx 文件)。
参数
- 范围基于活动地图或场景。
- 范围将基于在地图或场景上绘制的矩形。
- 范围基于活动地图图层。 选择可用图层或者使用
- 所有要素的范围。
- 选定要素的范围。
- 可见要素的范围。
- 范围将基于数据集。
- 范围将为所有输入的相交范围。
- 范围将为所有输入的合并范围。
- 可在剪贴板中复制和粘贴范围。
- 将范围和坐标系复制到剪贴板。
- 将范围重置为默认值。arcpy.management.PackageProject(in_project, output_file, {sharing_internal}, {package_as_template}, {extent}, {apply_extent_to_arcsde}, {additional_files}, {summary}, {tags}, {version}, {include_toolboxes}, {include_history_items}, {read_only}, {select_related_rows}, {preserve_sqlite})| 名称 | 说明 | 数据类型 |
in_project | 要打包的工程（.aprx 文件）。 | File |
output_file | 输出工程包（.ppkx 文件）。 | File |
sharing_internal (可选) | 指定是否将工程和所有数据合并、转换或复制到包中（以便在组织外部共享）或按原样引用而不进行转换或不将其包含在包中（以便在组织内部共享）。
| Boolean |
package_as_template (可选) | 指定将创建工程模板还是工程包。 工程模板可以包含地图、布局、数据库和服务器的连接等。 使用工程模板，可以标准化不同工程的一系列地图并可确保正确的图层可供所有人直接用于他们的地图中。
| Boolean |
extent (可选) | 指定用于选择或裁剪要素的范围。
| Extent |
apply_extent_to_arcsde (可选) | 指定是将指定范围应用到所有图层，还是仅应用到企业级地理数据库图层。
| Boolean |
additional_files [additional_files,...] (可选) | 软件包中将包含的附加文件。 | File |
summary (可选) | 将添加到包属性中的摘要信息。 | String |
tags (可选) | 将添加到包属性中的标签。 使用逗号或分号分隔多个标签。 | String |
version [version,...] (可选) | 指定与某些对象（例如工程、地图和图层）兼容并将保留到的 ArcGIS Pro 版本。 如果工程将与旧版软件一起使用，则保存为早期版本会很有帮助。 警告：保存为早期版本的包可能会丢失早期版本不支持的功能或属性。
| String |
include_toolboxes (可选) | 指定是否合并工程工具箱并将其包括在输出包中。 所有工程都需要一个默认工具箱，因此无论如何设置，该工具箱都将包含在输出包中。
| Boolean |
include_history_items (可选) | 指定是否合并地理处理历史项目并将其包括在输出包中。 包括的历史项目将合并重新处理历史项目所需的数据。
| String |
read_only (可选) | 指定工程是否为只读状态。 无法修改或保存只读工程。
| Boolean |
select_related_rows (可选) | 指定是否将指定的范围应用至相关数据源。
| Boolean |
preserve_sqlite (可选) | 指定移动地理数据库数据是保留在输出中还是写入文件地理数据库格式。 如果输入数据是移动地理数据库网络数据集，则输出将为移动地理数据库。
| Boolean |
代码示例
以下 Python 脚本演示了如何在 Python 窗口中使用 PackageProject 函数。
import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.management.PackageProject(p.filePath, f'E:\gisShare\projects\Pipelines\SE_Pipeline.ppkx', 'INTERNAL')以下 Python 脚本将目录中文件名带有单词 oil 的所有工程转到工程包 (.ppkx) 中。
import os
import arcpy
enterpriseProjectDir = r"\\centralFileServer\gisData\ArcGISProProjects"
sharedProjectDir = r"c:\publicFiles\sharedProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for filename in filenames:
if "oil" in filename.lower():
project = os.path.join(dirpath, filename)
out_ppkx = os.path.join(sharedProjectDir, os.path.splitext(os.path.basename(project))[0] + ".ppkx")
print(f"Packaging: {project} to {out_ppkx}")
arcpy.management.PackageProject(project, out_ppkx, "EXTERNAL")许可信息
- Basic: 是
- Standard: 是
- Advanced: 是