Etiqueta | Explicación | Tipo de datos |
Proyecto de entrada | Proyecto (archivo .aprx) que se empaquetará. | File |
Archivo de salida | El paquete de proyecto de salida (archivo .ppkx). | File |
Compartir fuera de la organización (Opcional) | Especifica si el proyecto y todos los datos se consolidarán, convertirán o copiarán en el paquete (para compartirlos fuera de su organización) o se referenciarán tal cual sin convertirlos ni incluirlos en el paquete (para compartirlos dentro de su organización). Nota:Los datos y mapas se consolidarán y empaquetarán si en el proyecto se hace referencia a ellos desde una ruta local, como c:\gisdata\landrecords.gdb\, independientemente del valor de este parámetro.
| Boolean |
Empaquetar como plantilla (Opcional) | Indica si se creará una plantilla de proyecto o un paquete de proyecto. Las plantillas de proyecto pueden incluir mapas, diseños, conexiones a bases de datos y servidores, etcétera. Una plantilla de proyecto se puede utilizar para estandarizar una serie de mapas para distintos proyectos y garantizar así que las capas correctas estén disponibles de inmediato para que cualquier usuario pueda utilizarlas en sus mapas.
| Boolean |
Extent (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
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.
| Boolean |
Archivos adicionales (Opcional) | Archivos adicionales que se incluirán en el paquete. | File |
Resumen (Opcional) | La información del resumen que se agregará a las propiedades del paquete. | String |
Etiquetas (Opcional) | Las etiquetas que se agregará a las propiedades del paquete. Separe varias etiquetas con 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.
| String |
Incluir cajas de herramientas (Opcional) | Especifica si las cajas de herramientas del proyecto y los datos a los que se hace referencia en las herramientas de dichas cajas de herramientas se consolidarán e incluirán en el paquete de salida. Todos los proyectos requieren una caja de herramientas predeterminada, que se incluirá en el paquete de salida independientemente de esta configuración. Las cajas de herramientas de carpetas conectadas no se consideran cajas de herramientas del proyecto y no se ven afectadas por esta configuración.
| Boolean |
Incluir elementos del historial (Opcional) | Especifica si los elementos de historial de geoprocesamiento se consolidarán e incluirán en el paquete de salida. Los elementos de historial incluidos consolidarán los datos requeridos para procesar de nuevo el elemento de historial.
| String |
Paquete de solo lectura (Opcional) | Especifica si el proyecto será de solo lectura. Los proyectos de solo lectura no pueden modificarse ni guardarse.
| Boolean |
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.
| Boolean |
Conservar geodatabase móvil (Opcional) | Especifica si los datos de geodatabase móvil de entrada se conservarán en la salida o si se escribirán en formato de geodatabase de archivos. Si los datos de entrada corresponden a un dataset de red de geodatabase móvil, la salida será una geodatabase móvil.
| Boolean |
Resumen
Consolida y empaqueta un proyecto ArcGIS Pro (.aprx) y su contenido (mapas y datos) en un archivo de proyecto empaquetado (.ppkx).
Uso
Los datos y elementos del proyecto se consolidarán en el paquete de proyecto (.ppkx), incluidos los mapas y vistas 3D, los datos y las capas de los mapas, las cajas de herramientas, los elementos del historial de geoprocesamiento, los estilos, los diseños y las carpetas o conexiones (servidor, flujo de trabajo, etc.), si procede.
El parámetro Compartir fuera de la organización le permite controlar si un paquete se va a crear para uso interno (dentro de la red de su organización) o externo. Cuando la opción Compartir fuera de la organización está marcada, las capas de la geodatabase corporativa, los servicios de entidades y los datos referenciados a través de recursos compartidos de red (ruta UNC) se copiarán (o convertirán) y se incluirán en el paquete del proyecto. Los datos almacenados en el equipo local también se consolidarán y empaquetarán.
Nota:
La creación de un paquete interno que contenga datos referenciados se abrirá con enlaces rotos si se comparte con colegas que no tengan acceso a recursos en red (geodatabase corporativa, servicio de entidades y datos referenciados a través de discos compartidos [rutas UNC]).
Se pueden crear plantillas con el parámetro Empaquetar como plantilla. Se puede utilizar una plantilla de proyecto (archivo .aptx) para crear un proyecto al definir capas, mapas, datos y las conexiones necesarias.
Más información sobre la creación de una plantilla de proyecto
Utilice las herramientas Analyze Tools for Pro y Analyze Toolbox for Version para analizar cajas de herramientas que forman parte de un proyecto antes de realizar el proceso de consolidación. Los errores detectados pueden detener el proceso de consolidación. Corrija los errores o elimine la herramienta del proyecto. Es posible excluir las cajas de herramientas del paquete de proyecto de salida, desactivando para ello el parámetro Incluir cajas de herramientas.
De forma similar a las cajas de herramientas del proyecto, el historial de geoprocesamiento (la información resultado de ejecutar una herramienta de geoprocesamiento) se incluirá en el paquete. Los datos necesarios para procesar el elemento del historial se incluirán en el paquete de salida, independientemente de si están en un mapa o en una escena. El proceso de empaquetamiento se detendrá si los elementos del historial no son válidos (con errores durante el procesamiento) o en el caso de que no se encuentren datos. Deberá quitar o corregir el elemento del historial en cuestión. Es posible excluir los elementos de historial de un paquete de proyecto, desactivando para ello el parámetro Incluir elementos del historial.
Las conexiones –tales como a carpetas, servidores, base de datos y flujo de trabajo– solo se incluirán en un paquete interno. Estos elementos se eliminarán si el paquete se crea con el parámetro Compartir fuera de la organización activado.
En las capas de entidades, utilice el parámetro Extensión para seleccionar las entidades que se consolidarán. En las capas ráster, utilice el parámetro Extensión para recortar los datasets ráster.
Se pueden incluir archivos adicionales en el paquete. Es posible incluir imágenes, archivos PDF, documentos Word y archivos .zip en el paquete mediante el parámetro Archivos adicionales.
Precaución:
Los paquetes de proyecto (archivos .ppkx) solo se pueden crear y abrir con ArcGIS Pro.
Parámetros
arcpy.management.PackageProject(in_project, output_file, {sharing_internal}, {package_as_template}, {extent}, {apply_extent_to_arcsde}, {additional_files}, {summary}, {tags}, {version}, {include_toolboxes}, {include_history_items}, {read_only}, {select_related_rows}, {preserve_sqlite})
Nombre | Explicación | Tipo de datos |
in_project | Proyecto (archivo .aprx) que se empaquetará. | File |
output_file | El paquete de proyecto de salida (archivo .ppkx). | File |
sharing_internal (Opcional) | Especifica si el proyecto y todos los datos se consolidarán, convertirán o copiarán en el paquete (para compartirlos fuera de su organización) o se referenciarán tal cual sin convertirlos ni incluirlos en el paquete (para compartirlos dentro de su organización).
| Boolean |
package_as_template (Opcional) | Indica si se creará una plantilla de proyecto o un paquete de proyecto. Las plantillas de proyecto pueden incluir mapas, diseños, conexiones a bases de datos y servidores, etcétera. Una plantilla de proyecto se puede utilizar para estandarizar una serie de mapas para distintos proyectos y garantizar así que las capas correctas estén disponibles de inmediato para que cualquier usuario pueda utilizarlas en sus mapas. Más información sobre la creación de una plantilla de proyecto
| Boolean |
extent (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
| 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.
| Boolean |
additional_files [additional_files,...] (Opcional) | Archivos adicionales que se incluirán en el paquete. | File |
summary (Opcional) | La información del resumen que se agregará a las propiedades del paquete. | String |
tags (Opcional) | Las etiquetas que se agregará a las propiedades del paquete. Separe varias etiquetas con 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.
| String |
include_toolboxes (Opcional) | Especifica si las cajas de herramientas del proyecto se consolidarán e incluirán en el paquete de salida. Todos los proyectos requieren una caja de herramientas predeterminada, que se incluirá en el paquete de salida independientemente de esta configuración.
| Boolean |
include_history_items (Opcional) | Especifica si los elementos de historial de geoprocesamiento se consolidarán e incluirán en el paquete de salida. Los elementos de historial incluidos consolidarán los datos requeridos para procesar de nuevo el elemento de historial.
| String |
read_only (Opcional) | Especifica si el proyecto será de solo lectura. Los proyectos de solo lectura no pueden modificarse ni guardarse.
| Boolean |
select_related_rows (Opcional) | Determina si la extensión especificada se aplicará a fuentes de datos relacionadas.
| Boolean |
preserve_sqlite (Opcional) | Especifica si los datos de geodatabase móvil se conservarán en la salida o si se escribirán en formato de geodatabase de archivos. Si los datos de entrada corresponden a un dataset de red de geodatabase móvil, la salida será una geodatabase móvil.
| Boolean |
Muestra de código
El siguiente script de Python muestra cómo utilizar la función PackageProject desde la ventana de Python.
import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.management.PackageProject(p.filePath, f'E:\gisShare\projects\Pipelines\SE_Pipeline.ppkx', 'INTERNAL')
La siguiente secuencia de comandos de Python convierte todos los proyectos de un directorio, con la palabra oil en el nombre de archivo, en un paquete de proyecto (.ppkx).
import os
import arcpy
enterpriseProjectDir = r"\\centralFileServer\gisData\ArcGISProProjects"
sharedProjectDir = r"c:\publicFiles\sharedProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for filename in filenames:
if "oil" in filename.lower():
project = os.path.join(dirpath, filename)
out_ppkx = os.path.join(sharedProjectDir, os.path.splitext(os.path.basename(project))[0] + ".ppkx")
print(f"Packaging: {project} to {out_ppkx}")
arcpy.management.PackageProject(project, out_ppkx, "EXTERNAL")
Entornos
Casos especiales
- Factor de procesamiento en paralelo
Si no se especifica el entorno, la herramienta usará la mitad de los núcleos disponibles.
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí