Empaquetar resultado

Resumen

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

Uso

• Cuando se ejecuta una herramienta, la información sobre la ejecución se escribe como resultado en la ventana Resultados. Los resultados se pueden agregar como entrada directamente desde la ventana Resultados utilizando la opción de arrastrar y soltar o también se pueden agregar como entrada los resultados que se han guardado como un archivo de resultado (.rlt).

  Más información acerca de trabajar con resultados

• Cuando la opción Compatible con ArcGIS Runtime está activada (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

  • Todos los orígenes de datos que no sean de tipo geodatabase se convertirán en 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.
  • Se puede crear un archivo de Definición del servicio de mapas (.msd) y agregarlo al paquete. El archivo .msd se agregará si la salida de la herramienta original se puede visualizar y si se agregó un mapa y estas capas de salida a la ArcMap Tabla de contenido tras la ejecución.

• 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. Las excepciones son formatos como, por ejemplo, datos de geodatabase personal (.mdb), datos VPF y tablas basadas en hojas de cálculo Excel o conexiones OLEDB. Estos formatos no son compatibles en entornos 64x y, por lo tanto, siempre se convertirán a una geodatabase de archivos.
  • 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, mientras que todos los demás formatos se consolidarán en la carpeta commonData.
  • Los formatos ráster y vectoriales comprimidos no se recortarán, aun si se especifica 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.

• 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. Otros ejemplos de datasets que hacen referencia a otros datasets incluyen Redes geométricas, Redes y Localizadores. 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, solo consolidará o empaquetará el esquema de los orígenes de datos de entrada y de salida. 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 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 Solo esquema, se muestra un mensaje de advertencia, y esa capa se omitirá. Si la única capa especificada no es compatible con Solo esquema, la herramienta fallará.

• No puede crear un paquete de un resultado que falló. Sin embargo, puede utilizar la herramienta Consolidar resultado para crear una carpeta que incluya todos los datos y herramientas que se utilizaron en el resultado que falló.

• Para desempaquetar un paquete de geoprocesamiento, arrastre el archivo .gpk a ArcMap o haga clic con el botón derecho en el archivo .gpk y haga clic en Abrir paquete. También puede utilizar la herramienta Extraer paquete y especificar una carpeta de salida.

  Por defecto, los paquetes se extraerán en su perfil de usuario.

  Para cambiar la ubicación predeterminada donde se abrirán sus paquetes, abra Opciones de ArcMap en el menú Personalizar. En la pestaña Compartir busque la sección Empaquetar y marque Utilizar ubicación especificada por el usuario y vaya a la nueva ubicación de la carpeta.

Sintaxis

PackageResult_management (in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version})

Parámetro	Explicación	Tipo de datos
in_result [in_result,...]	El resultado que se empaquetará. La entrada puede ser un resultado que se agregó al arrastrarlo y soltarlo directamente de la ventana Resultados o que se buscó en un archivo de resultados (.rlt).	File; String
output_file	Nombre y ubicación del archivo del paquete de salida (.gpk).	File
convert_data (Opcional)	Especifica si las capas de entrada se convertirán a una geodatabase de archivos o conservarán el formato original. CONVERT — Los datos se convertirán a una geodatabase de archivos. Nota: Este parámetro 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'. PRESERVE —Los formatos de datos se conservarán cuando sea posible. Esta es la opción predeterminada. Nota: Las excepciones a esta regla son los formatos que no son compatibles con un entorno de 64x (datos de geodatabase personal .mdb, datos VPF y tablas basadas en hojas de cálculo de Excel o conexiones OLEDB), así como los formatos ráster que ArcGIS no puede escribir de forma nativa (ADRG, CADRG/ECRG, CIB y RPF).	Boolean
convert_arcsde_data (Opcional)	Especifica si las capas de geodatabase corporativa de entrada se convertirán a una geodatabase de archivos o conservarán el formato original. CONVERT_ARCSDE — Los datos de la geodatabase corporativa se convertirán a 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)	Especifique 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. MAXOF —Combinación de entradas MINOF —Intersección de entradas DISPLAY —La misma extensión de la visualización actual <Layer> —La misma extensión de la capa especificada	Extent
apply_extent_to_arcsde (Opcional)	Determina si la extensión especificada se aplicará a todas las capas o solo las capas de una geodatabase corporativa. ALL — La extensión especificada se aplica a todas las capas. Esta es la opción predeterminada. ARCSDE_ONLY —La extensión especificada se aplica solo a las capas de una 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. DESKTOP —El paquete de salida no será compatible con ArcGIS Runtime. 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 de geoprocesamiento solo se pueden crear para la versión actual. CURRENT — El paquete incluirá geodatabases y una caja de herramientas compatibles con la versión actual.	String

Muestra de código

Ejemplo 1 de PackageResult (ventana de Python)

En la siguiente secuencia de comandos de Python se muestra cómo utilizar 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 (secuencia de comandos de Python 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, "c:/gpks/parcelgpk.gpkx", 
                               "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", 
                               "ALL", "DESKTOP", "#", "Summary text", "Tag1")

Ejemplo 3 de PackageResult (secuencia de comandos independiente)

Busca y crea carpetas de geoprocesamiento individuales para todos los archivos de resultados que residen en una carpeta especificada.

# Name: PackageResultEx1.py
# Description:  Find all the result files that reside in a specified 
#               folder and create a geoprocessing package for each 
#               result file.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles" 
# Loop through the workspace, find all the result files (.rlt) and 
# create a geoprocessing package using the same name as the original 
# result file.
for rlt in arcpy.ListFiles("*.rlt"):
    print("Packaging " + rlt)
    arcpy.PackageResult_management(rlt, os.path.splitext(lyr)[0] + '.gpk', 
                                   "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", 
                                   "ALL", "DESKTOP", r"C:\docs\readme.txt", 
                                   "Summary text", "Tag1; tag2; tag3")

Ejemplo 4 de PackageResult (secuencia de comandos independiente)

Busca y crea un único paquete de geoprocesamiento para todos los archivos de resultados que residen en una carpeta especificada.

# Name: PackageResultEx2.py
# Description:  Find all the result files that reside in a specified 
#               folder and create a single geoprocessing package.
# import system modules
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles" 
# Find all the result files (.rlt) in a workspace and create a single 
# geoprocessing package.
rlts = arcpy.ListFiles("*.rlt")
arcpy.PackageResult_management(rlts, "all_layers.gpk", "PRESERVE", 
                               "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", 
                               r"C:\docs\readme.txt", "Summary text", 
                               "Tag1; tag2; tag3")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información sobre licencias

• ArcGIS Desktop Basic: Sí
• ArcGIS Desktop Standard: Sí
• ArcGIS Desktop Advanced: Sí