Resumen
Consolida y empaqueta un proyecto (archivo .aprx) de mapas y datos a los que se hace referencia en un archivo de proyecto empaquetado (.ppkx).
Uso
Todos los elementos de un proyecto se consolidan 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.
De forma predeterminada, los paquetes de proyecto se crean para uso interno. 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. Al activar la opción Compartir fuera de la organización, las capas de la geodatabase corporativa y los datos a los que se hace referencia desde una ruta UNC se incluyen en el paquete del proyecto.
Nota:
Para crear un paquete interno en el que se sigue haciendo referencia a los datos, se debe hacer referencia a las fuentes de datos desde una geodatabase corporativa o desde una ruta de acceso a archivos UNC. Las rutas de acceso a datos locales siempre se consolidarán y empaquetarán. Cuando se crea un paquete interno en el que solo se hace referencia a los datos, este se abrirá con vínculos erróneos si se comparte fuera de su entorno o con compañeros que no tienen acceso a la geodatabase corporativa o a los recursos compartidos de UNC.
Se pueden crear plantillas con el parámetro Empaquetar como plantilla. Las plantillas de proyecto (archivo .aptx) pueden ayudarle a crear un proyecto nuevo, mediante la definición de capas, mapas, datos y las conexiones necesarias.
Las cajas de herramientas que forman parte de un proyecto se analizan con la herramienta Analyze Tools For Pro antes de ejecutar el proceso de consolidación. Los errores detectados detienen el proceso de consolidación. Deberá corregir estos errores o quitar la herramienta del proyecto. Se consolidarán los datos de entrada usados por las herramientas, independientemente de si estos forman parte o no de un mapa 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 ejecutar el elemento del historial se incluirán en el paquete de salida, independientemente de si se encuentran 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 la ejecución) 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 para compartirlo fuera de la organización.
Se hará referencia a elementos como adjuntos, estilos y tareas para paquetes internos si forman parte de un proyecto al que se accede desde una ruta UNC. Estos elementos se copiarán y empaquetarán en el resto de situaciones.
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.
Es posible incluir en el paquete archivos que documenten los mapas y datos o que proporcionen información adicional. Es posible incluir imágenes, archivos PDF, documentos de Word y archivos .zip en el paquete, haciendo referencia a ellos con el parámetro Archivos adicionales.
Precaución:
Los paquetes de proyecto (archivos .ppkx) solo se pueden crear y abrir con ArcGIS Pro.
Sintaxis
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})| Parámetro | Explicación | Tipo de datos |
in_project | El proyecto (archivo .aprx) que se va a empaquetar. | File |
output_file | El paquete de proyecto de salida (archivo .ppkx). | File |
sharing_internal (Opcional) | Indica si el proyecto se consolidará para su entorno interno o si se van a mover todos los elementos de datos para que se puedan compartir de forma externa.
| Boolean |
package_as_template (Opcional) | Indica si se creará una plantilla de proyecto o un paquete de proyecto. Las plantillas pueden incluir mapas, diseños, conexiones a bases de datos y servidores, etcétera. Con una plantilla de proyecto resulta más fácil estandarizar una serie de mapas para diferentes 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 las plantillas de proyectos
| Boolean |
extent (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
| 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 |
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.
| 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 y la caja de herramientas predeterminada se incluirá independientemente de este parámetro de 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 ejecutar de nuevo el elemento de historial en cuestión.
| 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 |
Muestra de código
El siguiente script de Python demuestra cómo utilizar la herramienta PackageProject desde la ventana de Python.
import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.PackageProject_management(p.filePath, 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline.ppkx', 'INTERNAL')El siguiente script 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 = "\\\\centralFileServer\\gisData\\ArcGISProProjects"
sharedProjectDir = "c:\\publicFiles\\sharedProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for filename in filenames:
if "OIL" in filename.upper():
project = os.path.join(dirpath, filename)
outputFile = os.path.join(sharedProjectDir, os.path.splitext(os.path.basename(project))[0] + ".ppkx")
print("Packaging: {0} to {1}".format(project, outputFile))
arcpy.PackageProject_management(project, outputFile, "EXTERNAL")Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí