Empaquetar proyecto (Administración de datos)

Resumen

Consolida y empaqueta un archivo de proyecto (.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.

  • Los paquetes de proyecto se crean para uso interno de forma predeterminada. 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. La creación de un paquete interno donde solo se hace referencia a los datos se abrirá con enlaces rotos si se comparte fuera de su entorno o con colegas que no tienen acceso a la geodatabase corporativa ni a los recursos compartidos de datos 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 las plantillas de proyectos

  • 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 identificados detienen el proceso de consolidación. Debe corregir los errores o eliminar 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 procesar 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 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 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Proyecto de entrada

El proyecto (archivo .aprx) que se va a empaquetar.

File
Archivo de salida

El paquete de proyecto de salida (archivo .ppkx).

File
Compartir fuera de la organización
(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.

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.

  • Desactivado: las fuentes de datos corporativas, como las geodatabases corporativas y los datos de una ruta UNC, no se copiarán en la carpeta local. Esta es la opción predeterminada.
  • Activado: los formatos de datos se copiarán y conservarán cuando sea posible.
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.

  • Desactivado: se creará un paquete de proyecto. Esta es la opción predeterminada.
  • Activado: se creará una plantilla de proyecto.

Boolean
Extensión
(Opcional)

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

  • Valor predeterminado: la extensión se basará en la extensión máxima de todas las entradas participantes. Esta es la opción predeterminada.
  • Combinación de entradas: la extensión se basará en la extensión máxima de todas las entradas.
  • Intersección de entradas: la extensión se basará en el área mínima en común de todas las entradas.
  • Extensión de visualización actual: la extensión es igual a la visualización actual. La opción no está disponible cuando no hay ningún mapa activo.
  • Como se especifica en la parte inferior: la extensión se basará en los valores mínimo y máximo de extensión que se especifiquen.
  • Examinar: la extensión se basará en un dataset existente.
Extent
Aplicar extensión sólo 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.

  • Desactivado: la extensión especificada se aplicará a todas las capas. Esta es la opción predeterminada.
  • Activado: la extensión se aplicará solo a las capas de una geodatabase corporativa.

Boolean
Archivos adicionales
(Opcional)

Agrega archivos 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
Resumen
(Opcional)

Agrega información de resumen a las propiedades del paquete.

String
Etiquetas
(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
Versión del paquete
(Opcional)

Especifica la versión de las geodatabases que se crearán en el paquete resultante. La especificación de 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 posterior.

  • Todas las versionesEl paquete contendrá geodatabases y mapas compatibles con todas las versiones (ArcGIS Pro 2.1 y posteriores).
  • Versión actualEl paquete contendrá geodatabases y mapas compatibles con la versión actual.
  • 2.1
  • 2.2El paquete contendrá geodatabases y mapas compatibles con la versión 2.2.
  • 2.3El paquete contendrá geodatabases y mapas compatibles con la versión 2.3.
  • 2.4El paquete contendrá geodatabases y mapas compatibles con la versión 2.4.
  • 2.5El paquete contendrá geodatabases y mapas compatibles con la versión 2.5.
  • 2.6El paquete contendrá geodatabases y mapas compatibles con la versión 2.6.
  • 2.7El paquete contendrá geodatabases y mapas compatibles con la versión 2.7.
  • 2.8El paquete contendrá geodatabases y mapas compatibles con la versión 2.8.
  • 2.9El paquete contendrá geodatabases y mapas compatibles con la versión 2.9.
  • 3,0El paquete contendrá geodatabases y mapas compatibles con la versión 3.0.
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 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. Las cajas de herramientas de carpetas conectadas no se consideran cajas de herramientas del proyecto y no se ven afectadas por esta configuración.

  • Activado: las cajas de herramientas del proyecto se incluirán en el paquete de salida. Esta es la opción predeterminada.
  • Desactivado: las cajas de herramientas del proyecto no se incluirán en el paquete de salida.
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.

  • Los elementos de historial se incluiránLos elementos de historial se incluirán en el paquete de salida. Esta es la opción predeterminada.
  • Los elementos de historial no se incluiránLos elementos de historial no se incluirán en el paquete de salida.
  • Solamente se incluirán los elementos de historial válidosSolamente se incluirán en el paquete de salida los elementos de historial válidos. Los elementos de historial no son válidos si no se encuentra alguna de las capas de entrada originales o alguna de las herramientas.
String
Paquete de solo lectura
(Opcional)

Especifica si el proyecto será de solo lectura. Los proyectos de solo lectura no pueden modificarse ni guardarse.

  • Activado: el proyecto será de solo lectura.
  • Desactivado: se podrá escribir en el proyecto. Esta es la opción predeterminada.
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.

  • 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
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. Este parámetro invalida el parámetro Convertir datos a geodatabase de archivos cuando los datos de entrada son una geodatabase móvil. Si los datos de entrada corresponden a un dataset de red de geodatabase móvil, la salida siempre será una geodatabase móvil.

  • Desactivado: los datos de geodatabase móvil se convertirán al formato de geodatabase de archivos. Esta es la opción predeterminada.
  • Activado: los datos de geodatabase móvil se mantendrán como geodatabase móvil en el paquete del proyecto.
Boolean

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})
NombreExplicaciónTipo 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.

  • INTERNALLas fuentes de datos corporativas, como las geodatabases corporativas y los datos de una ruta UNC, no se copiarán en la carpeta local. Esta es la opción predeterminada.
  • EXTERNALLos formatos de datos se copiarán y conservarán cuando sea posible.
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. 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 las plantillas de proyectos

  • PROJECT_PACKAGESe creará un paquete de proyecto. Esta es la opción predeterminada.
  • PROJECT_TEMPLATESe creará una plantilla de proyecto.
Boolean
extent
(Opcional)

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

  • MAXOF: se utilizará la extensión máxima de todas las entradas.
  • MINOF: se utilizará el área mínima en común de todas las entradas.
  • DISPLAY: la extensión es igual a la visualización actual.
  • 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.
  • ENTERPRISE_ONLYLa extensión especificada se aplicará solo a las capas de la geodatabase corporativa.
Boolean
additional_files
[additional_files,...]
(Opcional)

Agrega archivos 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. La especificación de 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 posterior.

  • ALLEl paquete contendrá geodatabases y mapas compatibles con todas las versiones (ArcGIS Pro 2.1 y posteriores).
  • CURRENTEl paquete contendrá geodatabases y mapas compatibles con la versión actual.
  • 2.2El paquete contendrá geodatabases y mapas compatibles con la versión 2.2.
  • 2.3El paquete contendrá geodatabases y mapas compatibles con la versión 2.3.
  • 2.4El paquete contendrá geodatabases y mapas compatibles con la versión 2.4.
  • 2.5El paquete contendrá geodatabases y mapas compatibles con la versión 2.5.
  • 2.6El paquete contendrá geodatabases y mapas compatibles con la versión 2.6.
  • 2.7El paquete contendrá geodatabases y mapas compatibles con la versión 2.7.
  • 2.8El paquete contendrá geodatabases y mapas compatibles con la versión 2.8.
  • 2.9El paquete contendrá geodatabases y mapas compatibles con la versión 2.9.
  • 3.0El paquete contendrá geodatabases y mapas compatibles con la versión 3.0.
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.

  • TOOLBOXESLas cajas de herramientas del proyecto se incluirán en el paquete de salida. Esta es la opción predeterminada.
  • NO_TOOLBOXESLas cajas de herramientas del proyecto no se incluirán en el paquete de salida.
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.

  • HISTORY_ITEMSLos elementos de historial se incluirán en el paquete de salida. Esta es la opción predeterminada.
  • NO_HISTORY_ITEMSLos elementos de historial no se incluirán en el paquete de salida.
  • VALID_HISTORY_ITEMS_ONLYSolamente se incluirán en el paquete de salida los elementos de historial válidos. Los elementos de historial no son válidos si no se encuentra alguna de las capas de entrada originales o alguna de las herramientas.
String
read_only
(Opcional)

Especifica si el proyecto será de solo lectura. Los proyectos de solo lectura no pueden modificarse ni guardarse.

  • READ_ONLYEl proyecto será de solo lectura.
  • READ_WRITESe podrá escribir en el proyecto. Esta es la opción predeterminada.
Boolean
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
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. Este parámetro invalida el parámetro convert_data cuando los datos de entrada son una geodatabase móvil. Si los datos de entrada corresponden a un dataset de red de geodatabase móvil, la salida siempre será una geodatabase móvil.

  • PRESERVE_SQLITELos datos de geodatabase móvil se convertirán al formato de geodatabase de archivos.
  • CONVERT_SQLITELos datos de geodatabase móvil se mantendrán como geodatabase móvil en el paquete del proyecto. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de PackageProject (ventana de Python)

El siguiente script de Python demuestra cómo utilizar la función PackageProject desde la ventana de Python.

import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.management.PackageProject(p.filePath, 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline.ppkx', 'INTERNAL')
Ejemplo 2 de PackageProject (secuencia de comandos independiente)

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.management.PackageProject(project, outputFile, "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í

Temas relacionados