Resumen
Consolida un proyecto (archivo .aprx), así como mapas y datos a los que se hace referencia, en una carpeta de salida especificada.
Uso
Todos los elementos de un proyecto se consolidan e incluyen en el archivo .aprx, incluidos los mapas, datos a los que se hace referencia en las capas, cajas de herramientas, estilos, diseños y conexiones, si procede.
El parámetro Compartir fuera de la organización controla si los datos se van a consolidar en la carpeta.
- Desactivado: se crearán paquetes para el entorno interno, lo que significa que no se consolidarán los datos. En el proyecto consolidado se seguirá haciendo referencia a las rutas UNC, así como a las capas de la geodatabase corporativa, los estilos y las conexiones. (En Python, establezca el parámetro sharing_interal en INTERNAL.)
- Activado: se copiarán todas las fuentes de datos necesarias para el paquete en la carpeta consolidada. (En Python, establezca el parámetro sharing_interal en EXTERNAL.) No se incluirán aquellos elementos que no van a estar disponibles fuera de la red, como conexiones a la geodatabase corporativa y las rutas a las carpetas UNC. Sin embargo, si los datos de estas fuentes están incluidos en un mapa o diseño del proyecto, se copiarán a la carpeta de salida.
Nota:
Los datos y mapas se consolidarán si en el proyecto se hace referencia a ellos desde una ruta local, como c:\gisdata\landrecords.gdb\, independientemente del valor del parámetro Compartir fuera de la organización.
Se pueden crear plantillas con el parámetro Consolidar como plantilla. Las plantillas de proyecto pueden ayudarle a crear un proyecto al definir 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 las rutinas de consolidación. Si se detectan errores, se detendrá el proceso de consolidación. Debe corregir estos errores o eliminar la herramienta del proyecto. Se consolidarán los datos de entrada que necesitan las herramientas, independientemente de si estos forman parte o no de un mapa del proyecto.
Las conexiones, tales como a carpetas, servidores, base de datos, flujo de trabajo y Data Reviewer, 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.
Para las capas de entidades, el parámetro Extensión se utiliza 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.
Sintaxis
arcpy.management.ConsolidateProject(in_project, output_folder, {sharing_internal}, {extent}, {apply_extent_to_enterprise_geo}, {package_as_template}, {preserve_sqlite}, {version}, {select_related_rows})| Parámetro | Explicación | Tipo de datos |
in_project | El proyecto (archivo .aprx) que se va a consolidar. | File |
output_folder | Carpeta de salida que contendrá el proyecto y los datos consolidados. Si la carpeta especificada no existe, se creará una nueva carpeta. | Folder |
sharing_internal (Opcional) | Especifica si el proyecto y todos los datos se consolidarán en la carpeta de salida para que se puedan compartir de forma externa.
| Boolean |
extent (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
| Extent |
apply_extent_to_enterprise_geo (Opcional) | Especifica si el parámetro extent se aplicará a todas las capas o tan solo a las capas de una geodatabase corporativa.
| Boolean |
package_as_template (Opcional) | Indica si el proyecto se consolida como plantilla o como proyecto normal. Las plantillas pueden incluir mapas, diseños, conexiones a bases de datos y servidores, etcétera. Una plantilla de proyecto le permite estandarizar una serie de mapas para su uso dentro de un proyecto 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 |
preserve_sqlite (Opcional) | Especifica si se conservarán las geodatabases de SQLite o si se convertirán en geodatabases de archivos. Nota:Este parámetro se aplica únicamente a los archivos .geodatabase, utilizados principalmente para flujos de trabajo sin conexión en aplicaciones de ArcGIS Runtime. Las bases de datos de SQLite con extensiones de archivo .sqlite o .gpkg se convierten en geodatabases de archivos.
| Boolean |
version (Opcional) | Especifica la versión de ArcGIS Pro tal y como se guardará el proyecto consolidado. Guardar como una versión anterior garantizará la compatibilidad con versiones anteriores de la herramienta. Si intenta consolidar una caja de herramientas con una versión anterior y se incluyen capacidades que solo están disponibles en la versión más reciente, se producirá un error. Es necesario eliminar las herramientas incompatibles con la versión anterior o especificar una versión compatible.
| String |
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 ConsolidateProject desde la ventana de Python.
import arcpy
arcpy.ConsolidateProject_management('c:\\projects\\SE_Pipelines\\PipeDevelopment.aprx', 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline', 'INTERNAL')El siguiente script toma un directorio de entrada en el cual los archivos de proyecto (.aprx) residen en un recurso compartido de UNC y consolida el proyecto en la unidad local. Se podrá seguir accediendo a los datos del ahora proyecto local siempre que se utilice la palabra clave INTERNAL.
import os
import arcpy
enterpriseProjectDir = "\\\\centralFileServer\\gisData\\ArcGISProProjects"
localProjectDir = "c:\\GISdata\\localProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for fname in filenames:
project = os.path.join(dirpath, fame)
outputFolder = os.path.join(localProjectDir, os.path.splitext(os.path.basename(project))[0])
print("Consolidating: {0} to {1}".format(project, outputFolder))
arcpy.ConsolidateProject_management(project, outputFolder, "INTERNAL")Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí