Empaquetar resultado (Administración de datos)

Resumen

Empaqueta uno o varios resultados de geoprocesamiento, incluidas todas las herramientas y los datasets de entrada y salida, en un único archivo comprimido (.gpkx).

Uso

  • Cuando se ejecuta una herramienta, se agrega un elemento del historial de geoprocesamiento a la sección Historial de geoprocesamiento del panel Catálogo. Utilice este elemento como entrada para la herramienta Empaquetar resultado.

    Cuando una herramienta se ejecuta desde Python, se devuelve un objeto Result de la ejecución de la herramienta. La propiedad resultID del objeto Result se puede utilizar como entrada de esta herramienta. En la sección Muestra de código, el segundo ejemplo muestra cómo utilizar una propiedad resultID del objeto Result.

  • Cuando Compatible con ArcGIS Runtime está activado (arcgisruntime="RUNTIME" en Python), el paquete de geoprocesamiento creado puede utilizarse en el entorno de ArcGIS Runtime SDK. Para admitir el entorno del tiempo de ejecución, se produce lo siguiente:

    • Todas las fuentes de datos que no sean de geodatabase se convertirán a una geodatabase de archivos.
    • Se crea una copia de la herramienta que se está empaquetando en una nueva caja de herramientas que se configura para publicar.

    Nota:

    A partir de ArcGIS Pro 2.1, se pueden crear paquetes de geoprocesamiento que admitan ArcGIS Runtime.

  • Cuando la opción Convertir datos a geodatabase de archivos está activada (convert_data='CONVERT' en Python), ocurre lo siguiente:

    • Cada fuente de datos única tendrá una geodatabase de archivos creada en la carpeta o paquete consolidado.
    • Los formatos ráster y vectoriales comprimidos se convertirán a una geodatabase de archivos, y se perderá la compresión.
    • Los datos de la geodatabase corporativa no se consolidarán. Para convertir los datos de la geodatabase corporativa a una geodatabase de archivos, active Incluir datos de geodatabase corporativa en vez de hacer referencia a los datos.

  • Cuando la opción Convertir datos a geodatabase de archivos no está activada (convert_data='PRESERVE' en Python), ocurre lo siguiente:

    • Se conservará el formato de la fuente de datos de las capas de entrada siempre que sea posible.
    • Los formatos ráster ADRG, CADRG/ECRG, CIB y RPF siempre se convertirán a rásteres de geodatabase de archivos. ArcGIS no puede escribir estos formatos de forma nativa. Siempre se convertirán a rásteres de geodatabase de archivos para mejorar el rendimiento.
    • En la estructura de carpeta de salida, las geodatabases de archivos se consolidarán en una carpeta específica de cada versión, y los demás formatos se consolidarán en la carpeta commonData.
    • Los formatos ráster y vectoriales comprimidos no se recortarán aunque se especifique una extensión en el parámetro Extensión.

  • Para las capas que contienen una unión o que participan en una clase de relación, todas las fuentes de datos unidas o relacionadas se consolidarán en la carpeta de salida. De manera predeterminada, las fuentes de datos unidas o relacionadas se consolidarán en su totalidad o en función del parámetro Seleccionar filas relacionadas, según la extensión especificada con el parámetro Extensión.

  • En las capas de entidades, se utiliza el parámetro Extensión para seleccionar las entidades que se consolidarán. Para las capas ráster, el parámetro Extensión se utiliza para recortar los datasets ráster.

  • Algunos datasets hacen referencia a otros datasets. Por ejemplo, puede tener un dataset de topología que haga referencia a cuatro clases de entidad. Las redes geométricas, las redes y los localizadores son otros ejemplos de datasets que hacen referencia a otros datasets. Al consolidar o empaquetar una capa en base a estos tipos de datasets, los datasets participantes también se consolidarán o empaquetarán.

  • Si el parámetro Solo esquema está activado, únicamente el esquema de las fuentes de datos de entrada y salida se consolidarán o empaquetarán. Un esquema es la estructura o el diseño de una clase de entidad o una tabla integrada por definiciones de campo y de tabla, propiedades del sistema de coordenadas, simbología, consultas de definición, etc. Los datos o registros no se consolidarán o empaquetarán.

  • Las fuentes de datos que no admiten solo el esquema no se consolidarán ni empaquetarán. Si el parámetro Solo esquema está activado y la herramienta encuentra una capa que no es compatible con este parámetro, aparece un mensaje de advertencia y esa capa se omitirá. Si la única capa especificada no es compatible con Solo esquema, la herramienta fallará.

  • Para desempaquetar un paquete de geoprocesamiento, utilice la herramienta Extraer paquete para extraer el contenido en una carpeta. A continuación, puede desplazarse al directorio y explorar la herramienta y los datos. También puede hacer clic con el botón derecho del ratón en el paquete desde una carpeta del panel Catálogo y extraerlo en el mapa actual. Se podrá acceder a la herramienta desde la sección Historial de geoprocesamiento.

    De forma predeterminada, al extraer un paquete desde el panel Catálogo, el contenido se extraerá a su perfil de usuario.

Sintaxis

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})
ParámetroExplicaciónTipo de datos
in_result
[in_result,...]

El resultado que se empaquetará.

La entrada puede ser un resultado del historial de su proyecto actual o una propiedad resultID del objeto Result cuando se usa la herramienta en un script de Python.

File; String
output_file

Nombre y ubicación del archivo del paquete de salida (.gpkx).

File
convert_data
(Opcional)

Especifica si las capas de entrada se convertirán en una geodatabase de archivos o conservarán el formato original.

  • CONVERT Los datos se convertirán en una geodatabase de archivos. Esta opción no se aplica a las fuentes de datos de la geodatabase corporativa. Para convertir los datos de la geodatabase corporativa establezca convert_arcsde_data='CONVERT_ARCSDE'.
  • PRESERVELos formatos de datos se conservarán cuando siempre que sea posible. Esta es la opción predeterminada.
Boolean
convert_arcsde_data
(Opcional)

Especifica si las capas de geodatabase corporativa de entrada se convertirán en una geodatabase de archivos o conservarán el formato original.

  • CONVERT_ARCSDE Los datos de la geodatabase corporativa se convertirán en una geodatabase de archivos y se incluirán en la carpeta o el paquete consolidado. Esta es la opción predeterminada.
  • PRESERVE_ARCSDE Los datos de la geodatabase corporativa se conservarán y se hará referencia a ellos en la carpeta o el paquete consolidado.
Boolean
extent
(Opcional)

Especifica la extensión al introducir manualmente las coordenadas en el parámetro de extensión con el formato X-Mín Y-Mín X-Máx Y-Máx. Para utilizar la extensión de una capa específica, especifique el nombre de la capa.

  • MAXOFSe utilizará la combinación de entradas.
  • MINOFSe utilizará la intersección de entradas.
  • DISPLAYSe utilizará la misma extensión que la visualización actual.
  • <Layer>Se utilizará la misma extensión que la capa especificada.
Extent
apply_extent_to_arcsde
(Opcional)

Especifica si la extensión especificada se aplicará a todas las capas o solo a las capas de la geodatabase corporativa.

  • ALL La extensión especificada se aplicará a todas las capas. Esta es la opción predeterminada.
  • ARCSDE_ONLYLa extensión especificada se aplicará solo a las capas de la geodatabase corporativa.
Boolean
schema_only
(Opcional)

Especifica si solo se consolidará o empaquetará el esquema de los datasets de entrada y de salida.

  • ALL Se consolidarán o empaquetarán todos los registros de los datasets de entrada y de salida. Esta es la opción predeterminada.
  • SCHEMA_ONLY Solo se consolidará o empaquetará el esquema de los datasets de entrada y de salida.
Boolean
arcgisruntime
(Opcional)

Especifica si el paquete será compatible con ArcGIS Runtime. Para que sea compatible con ArcGIS Runtime, todas las fuentes de datos se convertirán a una geodatabase de archivos.

  • DESKTOPEl paquete de salida no será compatible con ArcGIS Runtime. Esta es la opción predeterminada.
  • RUNTIME El paquete de salida será compatible con ArcGIS Runtime.
Boolean
additional_files
[additional_files,...]
(Opcional)

Agrega archivos adicionales a un paquete. Archivos adicionales, tales como .doc, .txt, .pdf, etc. se utilizan para proporcionar más información sobre el contenido y el propósito del paquete.

File
summary
(Opcional)

Agrega información de resumen a las propiedades del paquete.

String
tags
(Opcional)

Agrega información de las etiquetas a las propiedades del paquete. Se pueden agregar varias etiquetas separadas por una coma o un punto y coma.

String
version
[version,...]
(Opcional)

Especifica la versión de las geodatabases que se crearán en el paquete resultante. Especificar una versión permite compartir los paquetes con versiones anteriores de ArcGIS y admite la compatibilidad con versiones anteriores.

Nota:

Los paquetes guardados en una versión anterior pueden perder las propiedades que solo estén disponibles en la versión más reciente.

  • ALL El paquete contendrá geodatabases y mapas compatibles con todas las versiones (ArcGIS Pro 2.1 y posteriores).
  • CURRENT El paquete contendrá geodatabases y mapas compatibles con la versión actual.
  • 2.1El paquete contendrá geodatabases y mapas compatibles con la versión 2.1.
  • 2.2 El paquete contendrá geodatabases y mapas compatibles con la versión 2.2.
  • 2.3El paquete contendrá geodatabases y mapas compatibles con la versión 2.3.
  • 2.4El paquete contendrá geodatabases y mapas compatibles con la versión 2.4.
  • 2.5El paquete contendrá geodatabases y mapas compatibles con la versión 2.5.
  • 2.6El paquete contendrá geodatabases y mapas compatibles con la versión 2.5.
String
select_related_rows
(Opcional)

Determina si la extensión especificada se aplicará a fuentes de datos relacionadas.

  • KEEP_ONLY_RELATED_ROWSSolo se consolidarán los datos relacionados que correspondan a registros dentro de la extensión especificada.
  • KEEP_ALL_RELATED_ROWSLas fuentes de datos relacionadas se consolidarán en su totalidad. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de PackageResult (ventana de Python)

El siguiente script de Python muestra cómo usar la herramienta PackageResult en la ventana de Python.

import arcpy
arcpy.env.workspace = "C:/ResultFiles" 
arcpy.PackageResult_management('Parcel.rlt', 'Parcel.gpk', "PRESERVE", 
                               "CONVERT_ARCSDE", "#", "ALL", "ALL", 
                               "DESKTOP", r"C:\docs\readme.txt", 
                               "Summary text", "Tag1; tag2; tag3")
Ejemplo 2 de PackageResult (script independiente)

En la siguiente secuencia de comandos de Python se muestra cómo utilizar la herramienta PackageResult desde la ventana de Python o desde una secuencia de comandos con el objeto Result de una herramienta personalizada.

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.PackageResult_management(parcelUpdate.resultID, "c:/gpks/parcelgpk.gpkx", 
                               "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", 
                               "ALL", "DESKTOP", "#", "Summary text", "Tag1")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados