打包结果 (数据管理)

摘要

将一个或多个地理处理结果(包括所有工具以及输入和输出数据集)打包为单个压缩文件 (.gpkx)。

使用情况

  • 运行工具时,会将地理处理历史项目添加到目录窗格的地理处理历史部分中。 将此项目用作打包结果工具的输入。

    Python 中运行工具时,将返回 Result 对象。 Result 对象的 resultID 属性可以用作此工具的输入。 以下第二个代码示例将演示如何使用 Result 对象的 resultID 属性。

  • 如果选中支持 ArcGIS Maps SDK,则可在 ArcGIS Maps SDKs 环境中使用创建的地理处理包。 要支持 ArcGIS Maps SDKs 环境,将发生以下情况:

    • 所有非地理数据库数据源都将转换为文件地理数据库。
    • 将在为发布配置的新工具箱中创建正在打包工具的副本。

    注:

    ArcGIS Pro 2.1 起,可创建支持 ArcGIS Maps SDKs 的地理处理包。

  • 选中将数据转换为文件地理数据库参数时,将出现以下情况:

    • 每个唯一数据会具有一个在合并文件夹或包中创建的文件地理数据库。
    • 压缩栅格和矢量格式会转换为一个文件地理数据库,并且原来的数据压缩将会丢失。
    • 不会合并企业级地理数据库数据。 要将企业级地理数据库数据转换为文件地理数据库,请选中包括企业级地理数据库数据,而不是仅引用该数据参数。

  • 未选中将数据转换为文件地理数据库参数时,将出现以下情况:

    • 将保留输入图层的数据源格式(如果可能)。
    • ADRG、CADRG/ECRG、CIB 和 RPF 栅格格式将转换为文件地理数据库栅格。 ArcGIS 本身不能写出这些格式。 出于效率方面的考虑,这些格式将转换为文件地理数据库栅格。
    • 在输出文件夹结构中,文件地理数据库将合并到一个特定于版本的文件夹中,并且所有其他格式都将合并到 commonData 文件夹中。
    • 即使针对范围参数指定了范围,也不会裁剪压缩栅格和矢量格式。

  • 对于包含连接或参与关系类的图层,所有连接或相关的数据源都将合并到输出文件夹。 默认情况下,连接或关联数据源将全部合并,或根据为范围参数指定的范围,由选择相关行参数值决定。

  • 对于要素图层,范围参数用来选择将要合并的要素。 对于栅格图层,范围参数用来裁剪栅格数据集。

  • 有些数据集会引用其他数据集。 例如,拓扑数据集可能引用 4 个要素类。 引用其他数据集的数据集示例还包括几何网络、网络和定位器。 基于这些数据集类型合并或打包图层时,参与数据集也将被合并或打包。

  • 如果选中仅方案参数,则将仅合并或打包输入和输出数据源的方案。 方案是由字段和表定义、坐标系属性、符号系统、定义查询等组成的要素类或表的结构或设计。 将不会对数据和记录进行合并或打包。

  • 不支持“仅方案”的数据源不能进行合并和打包。 如果选中仅方案参数,并且此工具遇到“仅方案”不支持的图层,则会显示一条警告消息,并会跳过该图层。 如果仅方案不支持指定的唯一图层,则该工具将失败。

  • 要对地理处理包进行解包,请使用提取包工具将内容提取到某一文件夹中。 然后浏览至目录,并浏览工具与数据。 或者,右键单击目录窗格中某个文件夹中的包,然后将其提取到当前地图。 可从地理处理历史部分访问工具。

    默认情况下,从目录窗格提取包时,会将内容提取到用户配置文件中。

参数

标注说明数据类型
结果

结果将被打包。

输入可以是当前工程的历史结果,也可以是在 Python 脚本中使用工具时的 Result 对象的 resultID 属性。

File; String
输出文件

输出包文件 (.gpkx) 的名称和位置。

File
将数据转换为文件地理数据库
(可选)

指定输入图层是转换为文件地理数据库还是保留原始格式。

  • 选中 - 所有数据将转换为文件地理数据库。 此选项不适用于企业级地理数据库数据源。 要包括企业级地理数据库数据,请选中包括企业级地理数据库数据,而不是仅引用该数据参数。
  • 未选中 - 保留数据格式(如有可能)。 这是默认设置。
Boolean
包括企业级地理数据库数据,而不是引用该数据
(可选)

指定是将输入企业级地理数据库图层转换为文件地理数据库,还是保留其原始格式。

  • 选中 - 所有企业级地理数据库数据源都将转换为文件地理数据库。 这是默认设置。
  • 未选中 - 将保留所有企业级地理数据库数据源,并在生成的包中对其进行引用。
Boolean
范围
(可选)

指定用于选择或裁剪要素的范围。

  • 当前显示范围 地图视图 - 范围基于活动地图或场景。
  • 绘制范围 构造直角并完成草图 - 范围将基于在地图或场景上绘制的矩形。
  • 图层范围 图层 - 范围基于活动地图图层。 选择可用图层或者使用所有图层中的数据范围选项。 每个地图图层具有以下选项:

    • 所有要素 全选 - 所有要素的范围。
    • 选定要素 基于选定要素的区域 - 选定要素的范围。
    • 可见要素 Extent Indicator - 可见要素的范围。

  • 浏览 浏览 - 范围将基于数据集。
  • 输入的交集 相交 - 范围将为所有输入的相交范围。
  • 输入的并集 联合 - 范围将为所有输入的合并范围。
  • 剪贴板 粘贴 - 可在剪贴板中复制和粘贴范围。
    • 复制范围 复制 - 将范围和坐标系复制到剪贴板。
    • 粘贴范围 粘贴 - 从剪贴板粘贴范围和坐标系。 如果剪贴板不包含坐标系,则范围将使用地图的坐标系。
  • 重置范围 重置 - 将范围重置为默认值。

当手动提供坐标时,坐标必须为数值,并且位于活动地图的坐标系中。 地图可能使用与提供的坐标不同的显示单位。 在南纬和西经坐标中使用负号。

Extent
仅将范围应用于企业级地理数据库图层
(可选)

指定是将指定范围应用到所有图层,还是仅应用到企业级地理数据库图层。

  • 未选中 - 指定范围将应用到所有图层。 这是默认设置。
  • 选中 - 指定范围将仅应用到企业级地理数据库图层。
Boolean
仅方案
(可选)

指定是合并或打包输入和输出数据集的所有要素和记录,还是仅合并或打包输入和输出数据集的方案。

  • 未选中 - 输入和输出数据集的所有要素和记录都将包括在合并的文件夹或包中。 这是默认设置。
  • 选中 - 仅合并或打包输入和输出数据集的方案。 输出文件夹中将不合并或打包任何要素或记录。
Boolean
支持 ArcGIS Maps SDK
(可选)

指定包是否支持 ArcGIS Maps SDKs。 要支持 ArcGIS Maps SDKs,所有数据源均将转换为文件地理数据库,并需在包中创建服务器兼容工具。

  • 未选中 - 输出包将不支持 ArcGIS Maps SDKs。 这是默认设置。
  • 选中 - 输出包将支持 ArcGIS Maps SDKs
Boolean
附加文件
(可选)

软件包中将包含的附加文件。

File
摘要
(可选)

将用作输出包的摘要属性的文本。

String
标签
(可选)

将添加到包属性中的标签信息。 可以添加多个标签,标签之间用逗号或分号进行分隔。

String
包版本
(可选)

指定与某些对象(例如工程、地图和图层)兼容并将保留到的 ArcGIS Pro 版本。 如果工程将与旧版软件一起使用,则保存为早期版本会很有帮助。

警告:

保存为早期版本的包可能会丢失早期版本不支持的功能或属性。

  • 所有版本该包的内容将与所有版本(ArcGIS Pro 2.1 及更高版本)兼容。
  • 当前版本该包的内容将与当前发布的 ArcGIS Pro 版本兼容。
  • ArcGIS Pro 2.2该包的内容将与 ArcGIS Pro 2.2 版本兼容。
  • ArcGIS Pro 2.3该包的内容将与 ArcGIS Pro 2.3 版本兼容。
  • ArcGIS Pro 2.4该包的内容将与 ArcGIS Pro 2.4 版本兼容。
  • ArcGIS Pro 2.5该包的内容将与 ArcGIS Pro 2.5 版本兼容。
  • ArcGIS Pro 2.6该包的内容将与 ArcGIS Pro 2.6 版本兼容。
  • ArcGIS Pro 2.7该包的内容将与 ArcGIS Pro 2.7 版本兼容。
  • ArcGIS Pro 2.8该包的内容将与 ArcGIS Pro 2.8 版本兼容。
  • ArcGIS Pro 2.9该包的内容将与 ArcGIS Pro 2.9 版本兼容。
  • ArcGIS Pro 3.0该包的内容将与 ArcGIS Pro 3.0 版本兼容。
  • ArcGIS Pro 3.1该包的内容将与 ArcGIS Pro 3.1 版本兼容。
  • ArcGIS Pro 3.2该包的内容将与 ArcGIS Pro 3.2 版本兼容。
  • ArcGIS Pro 3.3该包的内容将与 ArcGIS Pro 3.3 版本兼容。
  • ArcGIS Pro 3.4该包的内容将与 ArcGIS Pro 3.4 版本兼容。
String
仅保留与范围内要素相关的行
(可选)

指定是否将指定的范围应用至相关数据源。

  • 未选中 - 相关的数据源将全部合并。 这是默认设置。
  • 选中 - 仅合并指定范围内与记录对应的相关数据。
Boolean

arcpy.management.PackageResult(in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version}, {select_related_rows})
名称说明数据类型
in_result
[in_result,...]

结果将被打包。

输入可以是当前工程的历史结果,也可以是在 Python 脚本中使用工具时的 Result 对象的 resultID 属性。

File; String
output_file

输出包文件 (.gpkx) 的名称和位置。

File
convert_data
(可选)

指定输入图层是转换为文件地理数据库还是保留原始格式。

  • CONVERT数据将转换为文件地理数据库。 此选项不适用于企业级地理数据库数据源。 要转换企业级地理数据库数据,请将 convert_arcsde_data 参数设置为 CONVERT_ARCSDE
  • PRESERVE保留数据格式(如有可能)。 这是默认设置。
Boolean
convert_arcsde_data
(可选)

指定是将输入企业级地理数据库图层转换为文件地理数据库,还是保留其原始格式。

  • CONVERT_ARCSDE企业级地理数据库数据将转换为文件地理数据库,并将包含在合并的文件夹或包中。 这是默认设置。
  • PRESERVE_ARCSDE将保留企业级地理数据库数据,并将在合并文件夹或包中对其进行引用。
Boolean
extent
(可选)

指定用于选择或裁剪要素的范围。

  • MAXOF - 将使用的所有输入的最大范围。
  • MINOF - 将使用的所有输入共用的最小范围。
  • DISPLAY - 范围与可见显示范围相等。
  • 图层名称 - 将使用指定图层的范围。
  • Extent 对象 - 将使用指定对象的范围。
  • 以空格分隔的坐标字符串 - 将使用指定字符串的范围。 坐标以 x-min,y-min,x-max,y-max 的顺序表示。
Extent
apply_extent_to_arcsde
(可选)

指定是将指定范围应用到所有图层,还是仅应用到企业级地理数据库图层。

  • ALL指定范围将应用到所有图层。 这是默认设置。
  • ARCSDE_ONLY指定范围将仅应用到企业级地理数据库图层。
Boolean
schema_only
(可选)

指定是合并或打包输入和输出数据集的所有记录,还是仅合并或打包输入和输出数据集的方案。

  • ALL合并或打包输入和输出数据集中的所有记录。 这是默认设置。
  • SCHEMA_ONLY仅合并或打包输入和输出数据集的方案。
Boolean
arcgisruntime
(可选)

指定包是否支持 ArcGIS Maps SDKs。 要支持 ArcGIS Maps SDKs,所有数据源都将转换为文件地理数据库。

  • DESKTOP输出包将不支持 ArcGIS Maps SDKs。 这是默认设置。
  • RUNTIME输出包将支持 ArcGIS Maps SDKs
Boolean
additional_files
[additional_files,...]
(可选)

软件包中将包含的附加文件。

File
summary
(可选)

将用作输出包的摘要属性的文本。

String
tags
(可选)

将添加到包属性中的标签信息。 可以添加多个标签,标签之间用逗号或分号进行分隔。

String
version
[version,...]
(可选)

指定与某些对象(例如工程、地图和图层)兼容并将保留到的 ArcGIS Pro 版本。 如果工程将与旧版软件一起使用,则保存为早期版本会很有帮助。

警告:

保存为早期版本的包可能会丢失早期版本不支持的功能或属性。

  • ALL该包的内容将与所有版本(ArcGIS Pro 2.1 及更高版本)兼容。
  • CURRENT该包的内容将与当前发布的 ArcGIS Pro 版本兼容。
  • 2.2该包的内容将与 ArcGIS Pro 2.2 版本兼容。
  • 2.3该包的内容将与 ArcGIS Pro 2.3 版本兼容。
  • 2.4该包的内容将与 ArcGIS Pro 2.4 版本兼容。
  • 2.5该包的内容将与 ArcGIS Pro 2.5 版本兼容。
  • 2.6该包的内容将与 ArcGIS Pro 2.6 版本兼容。
  • 2.7该包的内容将与 ArcGIS Pro 2.7 版本兼容。
  • 2.8该包的内容将与 ArcGIS Pro 2.8 版本兼容。
  • 2.9该包的内容将与 ArcGIS Pro 2.9 版本兼容。
  • 3.0该包的内容将与 ArcGIS Pro 3.0 版本兼容。
  • 3.1该包的内容将与 ArcGIS Pro 3.1 版本兼容。
  • 3.2该包的内容将与 ArcGIS Pro 3.2 版本兼容。
  • 3.3该包的内容将与 ArcGIS Pro 3.3 版本兼容。
  • 3.4该包的内容将与 ArcGIS Pro 3.4 版本兼容。
String
select_related_rows
(可选)

指定是否将指定的范围应用至相关数据源。

  • KEEP_ONLY_RELATED_ROWS仅合并指定范围内与记录对应的相关数据。
  • KEEP_ALL_RELATED_ROWS相关的数据源将全部合并。 这是默认设置。
Boolean

代码示例

PackageResult 示例 1(Python 窗口)

以下 Python 脚本演示了如何在 Python 窗口中使用 PackageResult 函数。


import arcpy
arcpy.env.workspace = "C:/ResultFiles" 
arcpy.management.PackageResult('Parcel.rlt', 'Parcel.gpk', "PRESERVE", 
                               "CONVERT_ARCSDE", "#", "ALL", "ALL", 
                               "DESKTOP", r"C:\docs\readme.txt", 
                               "Summary text", "Tag1; tag2; tag3")
PackageResult 示例 2(独立脚本)

以下 Python 脚本演示了如何通过 Python 窗口或具有自定义工具 Result 对象的脚本使用 PackageResult 函数。

import arcpy

# Import toolbox with custom model inside
arcpy.ImportToolbox("c:/gisworkflows/ParcelTools.tbx")

# Run the tool and assign to a result variable
parcelUpdate = arcpy.ParcelUpdater_ParcelTools("c:/data/parcels.gdb/ward3", "UPDATE")

arcpy.management.PackageResult(parcelUpdate.resultID, "c:/gpks/parcelgpk.gpkx", 
                               "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", 
                               "ALL", "DESKTOP", "#", "Summary text", "Tag1")

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题