Resumen
Empaqueta un documento de mapa y todas las fuentes de datos de referencia para crear un único archivo .mpk comprimido.
Uso
Se emite una advertencia cuando esta herramienta encuentra un tipo de capa no admitido. La capa no permitida no se escribirá en la salida.
La capa de entrada debe tener una descripción para que se ejecute la herramienta. Para agregar una descripción, haga clic con el botón derecho en la capa, haga clic en Propiedades e introduzca una descripción.
Para desempaquetar un paquete de mapas, arrastre el archivo .mpk a ArcMap o haga clic con el botón derecho en el archivo .mpk y haga clic en Desempaquetar. 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.
- XP: C:\Documents and Settings\<username>\My Documents\ArcGIS\Packages
- Vista y Windows 7: C:\Users\<username>\Documents\ArcGIS\Packages
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, seleccione Utilizar ubicación especificada por el usuario y vaya a la ubicación de la nueva carpeta.
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 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, 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.
Si Compatibilidad con ArcGIS Runtime está activada (arcgisruntime='RUNTIME' en Python), el parámetro Versión se anulará y el paquete contendrá geodatabases y un mapa compatible únicamente con la versión actual.
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, (schema_only = 'SCHEMA_ONLY'en Python), solamente se consolidará o empaquetará el esquema de las fuentes de datos de entrada. 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á.
Sintaxis
arcpy.management.PackageMap(in_map, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {arcgisruntime}, {reference_all_data}, {version}, {additional_files}, {summary}, {tags})| Parámetro | Explicación | Tipo de datos |
in_map | Documento de mapa que se empaquetará. | ArcMap Document |
output_file | El paquete de mapas de salida (.mpk). | File |
convert_data (Opcional) | Especifica si las capas de entrada se convertirán en una geodatabase de archivos o conservarán el formato original.
| 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.
| 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.
| 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.
| 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 en una geodatabase de archivos y se creará un archivo .msd en el paquete de salida.
| Boolean |
reference_all_data (Opcional) | Al establecer esta opción en REFERENCED, se crea un paquete que hace referencia a los datos necesarios en lugar de copiar los datos. Esto es valioso cuando se intenta empaquetar datasets grandes que están disponibles en una ubicación central dentro de una organización.
| Boolean |
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.
| String |
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 |
Muestra de código
Ejemplo 1 de PackageMap (ventana de Python)
El siguiente script de Python demuestra cómo utilizar la herramienta PackageMap desde la ventana de Python:
import arcpy
arcpy.env.workspace = "C:/arcgis/ArcTutor/Editing"
arcpy.PackageMap_management('Exercise1.mxd', 'EditingExercise1.mpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL")
Ejemplo 2 de PackageMap (script independiente)
Busque y cree paquetes de mapa para todos los documentos de mapa que residen en una carpeta especificada.
# Name: PackageMap.py
# Description: Find all the map documents that reside in a specified folder and create map packages for each map document.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/arcgis/ArcTutor/Editing"
# Loop through the workspace, find all the mxds and create a map package using the same name as the mxd
for mxd in arcpy.ListFiles("*.mxd"):
print("Packaging: {0}".format(mxd))
arcpy.PackageMap_management(mxd, os.path.splitext(mxd)[0] + '.mpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí