标注 | 说明 | 数据类型 |
输入工程 | 要合并的工程(.aprx 文件)。 | File |
输出文件夹 | 此输出文件夹将包含合并的工程和数据。 如果指定的文件夹不存在,将创建一个文件夹。 | Folder |
在组织外共享 (可选) | 指定是将工程和所有数据合并到单个文件夹(在组织外共享)还是引用这些工程和数据(在组织内共享)。 通过企业级地理数据库或 UNC 文件系统引用的数据路径可在内部共享。 如果工程并非通过此类数据路径构建,则数据将合并到工程包中。 注:如果工程通过本地路径(例如 c:\gisdata\landrecords.gdb\)引用数据和地图,则将对这些数据和地图进行合并和打包(不考虑该参数设置)。
| Boolean |
范围 (可选) | 指定用于选择或裁剪要素的范围。
| Extent |
仅将范围应用到企业级地理数据库图层 (可选) | 指定将范围参数值应用到所有图层,还是仅应用到企业级地理数据库图层。
| Boolean |
合并为模板 (可选) | 指定将工程作为模板工程还是规则工程进行合并。 模板可以包含地图、布局、数据库和服务器的连接等。 通过工程模板,您可以标准化一系列地图以在工程中使用,并确保人们可立即使用正确的图层。
| Boolean |
保留移动地理数据库 (可选) | 用于指定是保留移动地理数据库还是将其转换为文件地理数据库。 注:该参数仅适用于移动地理数据库 (.geodatabase),主要用于 ArcGIS Runtime 应用程序中的离线工作流。 文件扩展名为 .sqlite 或 .gpkg 的 SQLite 数据库将转换为文件地理数据库。
| Boolean |
版本 (可选) | 指定合并工程的另存 ArcGIS AllSource 版本。 保存到较早版本可以确保工具向后兼容。 如果尝试将工具箱合并到较早版本,而工具箱中包含仅在较新版本中可用的功能,则会发生错误。 您必须移除与较早版本不兼容的工具或指定兼容的版本。
| String |
仅保留与范围内要素相关的行 (可选) | 指定是否将指定的范围应用至相关数据源。
| Boolean |
摘要
将工程(.aprx 文件)与引用的地图和数据合并到一个指定的输出文件夹。
使用情况
工程的所有元素都将合并,并包括在 .aprx 文件中,这些元素中包括地图、图层引用的数据、工具箱、样式、布局和连接(如果适用)。
在组织外共享参数控制数据是否合并到文件夹。
- 未选中 - 将为内部环境创建包,表示将不合并数据。 UNC 路径以及企业级地理数据库图层、样式和连接仍将在合并工程中引用。
- 选中 - 将包的所有所需数据源复制到合并文件夹。 网络外不可用的项目(例如企业级地理数据库连接和 UNC 文件夹路径)将不包括在内。 但是,如果这些源中的数据包括在工程内的地图或布局中,则这些数据将会复制到输出文件夹。
注:
如果工程通过本地路径(例如 c:\gisdata\landrecords.gdb\)引用数据和地图,则将合并这些数据和地图(不考虑在组织外共享参数设置)。
可使用合并为模板参数创建模板。 使用工程模板,可以定义图层、地图和数据以及创建工程时所需的连接。
在执行合并例程之前,将使用针对 Pro 分析工具工具分析属于工程组成部分的工具箱。 识别出的错误将停止合并进程。 您必须修复这些错误,或从工程中移除工具。 无论数据是否属于工程中地图的一部分,都将合并工具所需的输入数据。
连接(例如文件夹、服务器、数据库、工作流以及数据质检)将仅包含在内部包中。 如果创建包的目的是要在组织外共享,则将移除这些项目。
如果项目(例如附件、样式和任务)为 UNC 路径中的工程的一部分,则将对内部包引用项目。 在所有其他情况下,都将对这些项目进行复制和打包。
对于要素图层,使用范围参数选择将要合并的要素。 对于栅格图层,使用范围参数裁剪栅格数据集。
参数
arcpy.management.ConsolidateProject(in_project, output_folder, {sharing_internal}, {extent}, {apply_extent_to_enterprise_geo}, {package_as_template}, {preserve_sqlite}, {version}, {select_related_rows})
名称 | 说明 | 数据类型 |
in_project | 要合并的工程(.aprx 文件)。 | File |
output_folder | 此输出文件夹将包含合并的工程和数据。 如果指定的文件夹不存在,将创建一个文件夹。 | Folder |
sharing_internal (可选) | 指定是否将工程和所有数据合并到输出文件夹,以便在外部共享。
| Boolean |
extent (可选) | 指定用于选择或裁剪要素的范围。
| Extent |
apply_extent_to_enterprise_geo (可选) | 指定将 extent 参数值应用到所有图层,还是仅应用到企业级地理数据库图层。
| Boolean |
package_as_template (可选) | 指定将工程作为模板工程还是规则工程进行合并。 模板可以包含地图、布局、数据库和服务器的连接等。 通过工程模板,您可以标准化一系列地图以在工程中使用,并确保人们可立即使用正确的图层。
| Boolean |
preserve_sqlite (可选) | 用于指定是保留移动地理数据库还是将其转换为文件地理数据库。 注:该参数仅适用于移动地理数据库 (.geodatabase),主要用于 ArcGIS Runtime 应用程序中的离线工作流。 文件扩展名为 .sqlite 或 .gpkg 的 SQLite 数据库将转换为文件地理数据库。
| Boolean |
version (可选) | 指定合并工程的另存 ArcGIS AllSource 版本。 保存到较早版本可以确保工具向后兼容。 如果尝试将工具箱合并到较早版本,而工具箱中包含仅在较新版本中可用的功能,则会发生错误。 您必须移除与较早版本不兼容的工具或指定兼容的版本。
| String |
select_related_rows (可选) | 指定是否将指定的范围应用至相关数据源。
| Boolean |
代码示例
以下 Python 脚本演示了如何在 Python 窗口中使用 ConsolidateProject 函数。
import arcpy
arcpy.management.ConsolidateProject('c:\\projects\\SE_Pipelines\\PipeDevelopment.aprx',
'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline',
'INTERNAL')
以下脚本采用输入目录(其中工程文件 (.aprx) 位于 UNC 共享中)并将工程合并到本地驱动器。 由于使用了 INTERNAL 关键字,该数据现在仍可供本地工程访问。
import os
import arcpy
enterpriseProjectDir = "\\\\centralFileServer\\gisData\\ArcGISProProjects"
localProjectDir = "c:\\GISdata\\localProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for fname in filenames:
project = os.path.join(dirpath, fame)
outputFolder = os.path.join(localProjectDir,
os.path.splitext(os.path.basename(project))[0])
print("Consolidating: {0} to {1}".format(project, outputFolder))
arcpy.management.ConsolidateProject(project, outputFolder, "INTERNAL")