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 se ejecuta una herramienta desde Python, se devuelve un objeto Result. La propiedad resultID del objeto Result se puede utilizar como entrada de esta herramienta. La segunda muestra de código a continuación muestra cómo utilizar la propiedad resultID del objeto Result.

  • Cuando Compatible con ArcGIS Maps SDKs está activado, el paquete de geoprocesamiento creado puede utilizarse en el entorno de ArcGIS Maps SDKs. Para admitir el entorno de ArcGIS Maps SDKs, se produce lo siguiente:

    • Todas las fuentes de datos que no sean de geodatabase se convierten 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 Maps SDKs.

  • Cuando el parámetro Convertir datos a geodatabase de archivos está activado, 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 el parámetro Incluir datos de geodatabase corporativa en vez de hacer referencia a los datos.

  • Cuando el parámetro Convertir datos a geodatabase de archivos no está activado, 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 se convertirán a rásteres de geodatabase de archivos. ArcGIS no puede escribir estos formatos de forma nativa. Se convertirán a rásteres de geodatabase de archivos para una mayor eficiencia.
    • 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 para 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 valor del parámetro Seleccionar filas relacionadas, según la extensión especificada para 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, un dataset de topología puede hacer referencia a cuatro clases de entidades. 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 y registros no se consolidarán ni empaquetarán.

  • Las fuentes de datos que no admiten el parámetro Solo 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 ir 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Resultado

El resultado que se empaquetará.

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

File; String
Archivo de salida

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

File
Convertir datos a geodatabase de archivos
(Opcional)

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

  • Activado: todos los datos se convertirán a una geodatabase de archivos. Esta opción no se aplica a las fuentes de datos de la geodatabase corporativa. Para incluir los datos de la geodatabase corporativa, active el parámetro Incluir datos de geodatabase corporativa en vez de hacer referencia a los datos.
  • Desactivado: los formatos de datos se conservarán cuando sea posible. Esta es la opción predeterminada.
Boolean
Se incluyen los datos de la geodatabase corporativa en lugar de hacer referencia a los datos
(Opcional)

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

  • Activado: todas las fuentes de datos de la geodatabase corporativa se convertirán a una geodatabase de archivos. Esta es la opción predeterminada.
  • Desactivado: todas las fuentes de datos de la geodatabase corporativa se conservarán y se hará referencia a ellas en el paquete resultante.
Boolean
Extent
(Opcional)

Especifica la extensión que se utilizará para seleccionar o recortar entidades.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa.
  • Extensión de dibujo Cuadrar y terminar: la extensión se basará en un rectángulo dibujado en el mapa o la escena.
  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Elija una capa disponible o utilice la opción Extensión de datos en todas las capas. Cada capa de mapas tiene las opciones siguientes:

    • Todas las entidades Selecciona todo: extensión de todas las entidades.
    • Entidades seleccionadas Área de entidades seleccionadas: extensión de las entidades seleccionadas.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles.

  • Examinar Examinar: la extensión se basará en un dataset.
  • Intersección de entradas Intersecar: la extensión será la extensión de intersección de todas las entradas.
  • Combinación de entradas Combinación: la extensión será la extensión combinada de todas las entradas.
  • Portapapeles Pegar: la extensión puede copiarse en y desde el portapapeles.
    • Copiar extensión Copiar: copia la extensión y el sistema de coordenadas en el portapapeles.
    • Pegar extensión Pegar: pega la extensión y el sistema de coordenadas desde el portapapeles. Si el portapapeles no incluye un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.
  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.

Cuando las coordenadas se proporcionan de forma manual, las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. El mapa podría utilizar unidades de visualización distintas de las coordenadas proporcionadas. Utilice un valor de signo negativo para las coordenadas sur y oeste.

Extent
Aplicar la extensión solo a las capas de geodatabase corporativa
(Opcional)

Indica si la extensión especificada se aplicará a todas las capas o a las capas de una geodatabase corporativa únicamente.

  • Opción desactivada: la extensión especificada se aplicará a todas las capas. Esta es la opción predeterminada.
  • Opción activada: la extensión especificada se aplicará solo a las capas de una geodatabase corporativa.
Boolean
Solo esquema
(Opcional)

Especifica si se consolidarán o empaquetarán todas las entidades y los registros de los datasets de entrada y salida o solamente el esquema de los datasets de entrada y salida.

  • Desactivado: las entidades y los registros de los datasets de entrada y de salida se incluirán en la carpeta o el paquete consolidado. Esta es la opción predeterminada.
  • Activado: Solo se consolidará o empaquetará el esquema de los datasets de entrada y de salida. No se consolidarán ni empaquetarán entidades o registros en la carpeta de salida.
Boolean
Compatibilidad con ArcGIS Maps SDKs
(Opcional)

Especifica si el paquete será compatible con ArcGIS Maps SDKs. Para admitir ArcGIS Maps SDKs, todas las fuentes de datos se convertirán a una geodatabase de archivos y se creará una herramienta compatible con el servidor en el paquete.

  • Desactivado: el paquete de salida no será compatible con ArcGIS Maps SDKs. Esta es la opción predeterminada.
  • Activado: el paquete de salida será compatible con ArcGIS Maps SDKs.
Boolean
Archivos adicionales
(Opcional)

Archivos adicionales que se incluirán en el paquete.

File
Resumen
(Opcional)

Texto que se utilizará como propiedad de resumen del paquete de salida.

String
Etiquetas
(Opcional)

La información de etiqueta que se agregará a las propiedades del paquete. Se pueden agregar varias etiquetas separadas por una coma o un punto y coma.

String
Versión del paquete
(Opcional)

Especifica la versión de ArcGIS Pro con la que determinados objetos, como proyectos, mapas y capas, serán compatibles y a la que se mantendrán. Guardar en una versión anterior puede ser útil si el proyecto se va a utilizar con software más antiguo.

Precaución:

Un paquete guardado en una versión anterior puede perder funcionalidades o propiedades no admitidas en la versión anterior.

  • Todas las versionesEl contenido del paquete será compatible con todas las versiones (ArcGIS Pro 2.1 y posteriores).
  • Versión actualEl contenido del paquete será compatible con la versión actual de ArcGIS Pro.
  • ArcGIS Pro 2.2El contenido del paquete será compatible con ArcGIS Pro versión 2.2.
  • ArcGIS Pro 2.3El contenido del paquete será compatible con ArcGIS Pro versión 2.3.
  • ArcGIS Pro 2.4El contenido del paquete será compatible con ArcGIS Pro versión 2.4.
  • ArcGIS Pro 2.5El contenido del paquete será compatible con ArcGIS Pro versión 2.5.
  • ArcGIS Pro 2.6El contenido del paquete será compatible con ArcGIS Pro versión 2.6.
  • ArcGIS Pro 2.7El contenido del paquete será compatible con ArcGIS Pro versión 2.7.
  • ArcGIS Pro 2.8El contenido del paquete será compatible con ArcGIS Pro versión 2.8.
  • ArcGIS Pro 2.9El contenido del paquete será compatible con ArcGIS Pro versión 2.9.
  • ArcGIS Pro 3.0El contenido del paquete será compatible con ArcGIS Pro versión 3.0.
  • ArcGIS Pro 3.1El contenido del paquete será compatible con ArcGIS Pro versión 3.1.
  • ArcGIS Pro 3.2El contenido del paquete será compatible con ArcGIS Pro versión 3.2.
  • ArcGIS Pro 3.3El contenido del paquete será compatible con ArcGIS Pro versión 3.3.
  • ArcGIS Pro 3.4El contenido del paquete será compatible con ArcGIS Pro versión 3.4.
String
Conservar solo las filas relacionadas con las entidades dentro de la extensión
(Opcional)

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

  • Desactivado: las fuentes de datos relacionadas se consolidarán en su totalidad. Esta es la opción predeterminada.
  • Activado: solo se consolidarán los datos relacionados que correspondan a registros dentro de la extensión especificada.
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})
NombreExplicaciónTipo de datos
in_result
[in_result,...]

El resultado que se empaquetará.

La entrada puede ser un resultado del historial del 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.

  • CONVERTLos 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 datos de geodatabases corporativas, establezca el parámetro convert_arcsde_data en CONVERT_ARCSDE.
  • PRESERVELos formatos de datos se conservarán cuando 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_ARCSDELos 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_ARCSDELos 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 que se utilizará para seleccionar o recortar entidades.

  • MAXOF: se usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent
apply_extent_to_arcsde
(Opcional)

Indica si la extensión especificada se aplicará a todas las capas o a las capas de una geodatabase corporativa únicamente.

  • ALLLa 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 se consolidarán o empaquetarán todos los registros de los datasets de entrada y salida o solamente el esquema de los datasets de entrada y salida.

  • ALLSe consolidarán o empaquetarán todos los registros de los datasets de entrada y de salida. Esta es la opción predeterminada.
  • SCHEMA_ONLYSolo 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 Maps SDKs. Para admitir ArcGIS Maps SDKs, todas las fuentes de datos se convertirán a una geodatabase de archivos.

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

Archivos adicionales que se incluirán en el paquete.

File
summary
(Opcional)

Texto que se utilizará como propiedad de resumen del paquete de salida.

String
tags
(Opcional)

La información de etiqueta que se agregará 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 ArcGIS Pro con la que determinados objetos, como proyectos, mapas y capas, serán compatibles y a la que se mantendrán. Guardar en una versión anterior puede ser útil si el proyecto se va a utilizar con software más antiguo.

Precaución:

Un paquete guardado en una versión anterior puede perder funcionalidades o propiedades no admitidas en la versión anterior.

  • ALLEl contenido del paquete será compatible con todas las versiones (ArcGIS Pro 2.1 y posteriores).
  • CURRENTEl contenido del paquete será compatible con la versión actual de ArcGIS Pro.
  • 2.2El contenido del paquete será compatible con ArcGIS Pro versión 2.2.
  • 2.3El contenido del paquete será compatible con ArcGIS Pro versión 2.3.
  • 2.4El contenido del paquete será compatible con ArcGIS Pro versión 2.4.
  • 2.5El contenido del paquete será compatible con ArcGIS Pro versión 2.5.
  • 2.6El contenido del paquete será compatible con ArcGIS Pro versión 2.6.
  • 2.7El contenido del paquete será compatible con ArcGIS Pro versión 2.7.
  • 2.8El contenido del paquete será compatible con ArcGIS Pro versión 2.8.
  • 2.9El contenido del paquete será compatible con ArcGIS Pro versión 2.9.
  • 3.0El contenido del paquete será compatible con ArcGIS Pro versión 3.0.
  • 3.1El contenido del paquete será compatible con ArcGIS Pro versión 3.1.
  • 3.2El contenido del paquete será compatible con ArcGIS Pro versión 3.2.
  • 3.3El contenido del paquete será compatible con ArcGIS Pro versión 3.3.
  • 3.4El contenido del paquete será compatible con ArcGIS Pro versión 3.4.
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)

La siguiente secuencia de comandos de Python muestra cómo utilizar la función PackageResult en la ventana de Python.


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")
Ejemplo 2 de PackageResult (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función PackageResult desde la ventana de Python o desde un script 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.management.PackageResult(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