Consolidate Project (Data Management)

Summary

Consolidates a project (an .aprx file) and referenced maps and data to a specified output folder.

Usage

  • All elements of a project will be consolidated and included in the .aprx file, including maps, the data referenced by the layers, toolboxes, styles, layouts, and connections when appropriate.

  • The Share outside of organization parameter controls whether the data will be consolidated to the folder.

    • Unchecked—Packages will be created for your internal environment, meaning the data will not be consolidated. UNC paths and enterprise geodatabase layers, styles, and connections will remain referenced in the consolidated project.
    • Checked—All required data sources for the package will be copied to the consolidated folder. Items that would not be available outside your network, such as enterprise geodatabase connections and paths to UNC folders, will not be included. However, if data from these sources is included in a map or layout in the project, it will be copied to the output folder.

    Note:

    Data and maps will be consolidated if the project references them from a local path, such as c:\gisdata\landrecords.gdb\, regardless of the Share outside of organization parameter setting.

  • Templates can be created using the Consolidate as template parameter. A project template can help you create a project by defining layers, maps, and data as well as required connections.

    Learn more about project templates

  • Toolboxes that are part of a project are analyzed using the Analyze Tools For Pro tool before the consolidation routines are performed. Errors that are identified will stop the consolidation process. You must either fix these errors or remove the tool from the project. Input data that the tools require will be consolidated regardless of whether the data is part of a map in the project.

  • Connections such as folder, server, database, workflow, and data reviewer will only be included in an internal package. These items are removed if the package is created to be shared outside your organization.

  • Items such as attachments, styles, and tasks will be referenced for internal packages if they were part of the project from a UNC path. These items will be copied and packaged in all other situations.

  • For feature layers, the Extent parameter is used to select the features that will be consolidated. For raster layers, the Extent parameter is used to clip the raster datasets.

Parameters

LabelExplanationData Type
Input Project

The project (.aprx file) to be consolidated.

File
Output Folder

The output folder that will contain the consolidated project and data. If the specified folder does not exist, a folder will be created.

Folder
Share outside of organization
(Optional)

Specifies whether the project and all data will be consolidated into a single folder (for sharing outside your organization) or referenced (for sharing inside your organization). Data paths referenced from enterprise geodatabases or a UNC file system can be shared internally. If your project was not built with data paths like this, the data will be consolidated into the project package.

Note:

Data and maps will be consolidated and packaged if the project references them from a local path, such as c:\gisdata\landrecords.gdb\ regardless of this parameter's setting.

  • Unchecked—The project and its data sources will not be consolidated to the output folder. This is the default. This parameter applies to enterprise geodatabase data sources, including enterprise geodatabases and folders referenced via a UNC path.
  • Checked—The project and its data sources will be copied and preserved when possible.
Boolean
Extent
(Optional)

Specifies the extent that will be used to select or clip features.

  • Default—The extent will be based on the maximum extent of all participating inputs. This is the default.
  • Union of Inputs—The extent will be based on the maximum extent of all inputs.
  • Intersection of Inputs—The extent will be based on the minimum area common to all inputs.
  • Current Display Extent—The extent is equal to the visible display. The option is not available when there is no active map.
  • As Specified Below—The extent will be based on the minimum and maximum extent values specified.
  • Browse—The extent will be based on an existing dataset.
Extent
Apply Extent only to enterprise geodatabase layers
(Optional)

Specifies whether the Extent parameter will be applied to all layers or to enterprise geodatabase layers only.

  • Unchecked—The extent will be applied to all layers. This is the default.
  • Checked—The extent will be applied to enterprise geodatabase layers only.

Boolean
Consolidate as template
(Optional)

Specifies whether the project will be consolidated as a template or a regular project. Templates can include maps, layouts, connections to databases and servers, and so on. A project template allows you to standardize a series of maps for use in a project and ensure that the correct layers are immediately available for use.

  • Unchecked—The project will be consolidated as a project into a folder. This is the default.
  • Checked—The project will be consolidated as a template into a folder.

Boolean
Preserve SQLite Geodatabase
(Optional)

Specifies whether SQLite geodatabases will be preserved or converted to file geodatabases.

Note:

This parameter applies only to .geodatabase files, used primarily for offline workflows in ArcGIS Runtime apps. SQLite databases with .sqlite or .gpkg file extensions will be converted to file geodatabases.

  • Unchecked—SQLite geodatabases will be converted to file geodatabases. This is the default.
  • Checked—SQLite geodatabases will be preserved.

Boolean
Version
(Optional)

Specifies the ArcGIS Pro version that the consolidated project will be saved as. Saving to an earlier version will ensure tool backward compatibility. If you attempt to consolidate a toolbox to an earlier version and capabilities that are only available in the newer version are included, an error will occur. You must remove tools that are incompatible with the earlier version, or specify a compatible version.

  • Current version The consolidated folder will contain geodatabases and maps compatible with the version of the current release.
  • 2.1The consolidated folder will contain geodatabases and maps compatible with version 2.1.
  • 2.2 The consolidated folder will contain geodatabases and maps compatible with version 2.2.
  • 2.3The consolidated folder will contain geodatabases and maps compatible with version 2.3.
  • 2.4The consolidated folder will contain geodatabases and maps compatible with version 2.4.
  • 2.5The consolidated folder will contain geodatabases and maps compatible with version 2.5.
  • 2.6The consolidated folder will contain geodatabases and maps compatible with version 2.6.
  • 2.7The consolidated folder will contain geodatabases and maps compatible with version 2.7.
  • 2.8The consolidated folder will contain geodatabases and maps compatible with version 2.8.
String
Keep only the rows which are related to features within the extent
(Optional)

Specifies whether the specified extent will be applied to related data sources.

  • Unchecked—Related data sources will be consolidated in their entirety. This is the default.
  • Checked—Only related data corresponding to records within the specified extent will be consolidated.
Boolean

arcpy.management.ConsolidateProject(in_project, output_folder, {sharing_internal}, {extent}, {apply_extent_to_enterprise_geo}, {package_as_template}, {preserve_sqlite}, {version}, {select_related_rows})
NameExplanationData Type
in_project

The project (.aprx file) to be consolidated.

File
output_folder

The output folder that will contain the consolidated project and data. If the specified folder does not exist, a folder will be created.

Folder
sharing_internal
(Optional)

Specifies whether the project and all data will be consolidated to the output folder so it can be shared externally.

  • INTERNAL The project and its data sources will not be consolidated to the output folder. This is the default.
    Note:

    This parameter applies to enterprise geodatabase data sources, including enterprise geodatabases and folders referenced via a UNC path.

  • EXTERNALThe project and its data sources will be consolidated (copied) to the output folder when possible.
Boolean
extent
(Optional)

Specifies the extent that will be used to select or clip features.

  • MAXOF—The maximum extent of all inputs will be used.
  • MINOF—The minimum area common to all inputs will be used.
  • DISPLAY—The extent is equal to the visible display.
  • Layer name—The extent of the specified layer will be used.
  • Extent object—The extent of the specified object will be used.
  • Space delimited string of coordinates—The extent of the specified string will be used. Coordinates are expressed in the order of x-min, y-min, x-max, y-max.
Extent
apply_extent_to_enterprise_geo
(Optional)

Specifies whether the extent parameter will be applied to all layers or to enterprise geodatabase layers only.

  • ALL The extent will be applied to all layers. This is the default.
  • ENTERPRISE_ONLYThe extent will be applied to enterprise geodatabase layers only.
Boolean
package_as_template
(Optional)

Specifies whether the project will be consolidated as a template or a regular project. Templates can include maps, layouts, connections to databases and servers, and so on. A project template allows you to standardize a series of maps for use in a project and ensure that the correct layers are immediately available for use.

Learn more about project templates

  • PROJECT_PACKAGEThe project will be consolidated as a project into a folder. This is the default.
  • PROJECT_TEMPLATEThe project will be consolidated as a template into a folder
Boolean
preserve_sqlite
(Optional)

Specifies whether SQLite geodatabases will be preserved or converted to file geodatabases.

Note:

This parameter applies only to .geodatabase files, used primarily for offline workflows in ArcGIS Runtime apps. SQLite databases with .sqlite or .gpkg file extensions will be converted to file geodatabases.

  • CONVERT_SQLITESQLite geodatabases will be converted to file geodatabases. This is the default.
  • PRESERVE_SQLITESQLite geodatabases will be preserved.
Boolean
version
(Optional)

Specifies the ArcGIS Pro version that the consolidated project will be saved as. Saving to an earlier version will ensure tool backward compatibility. If you attempt to consolidate a toolbox to an earlier version and capabilities that are only available in the newer version are included, an error will occur. You must remove tools that are incompatible with the earlier version, or specify a compatible version.

  • CURRENT The consolidated folder will contain geodatabases and maps compatible with the version of the current release.
  • 2.1The consolidated folder will contain geodatabases and maps compatible with version 2.1.
  • 2.2 The consolidated folder will contain geodatabases and maps compatible with version 2.2.
  • 2.3The consolidated folder will contain geodatabases and maps compatible with version 2.3.
  • 2.4The consolidated folder will contain geodatabases and maps compatible with version 2.4.
  • 2.5The consolidated folder will contain geodatabases and maps compatible with version 2.5.
  • 2.6The consolidated folder will contain geodatabases and maps compatible with version 2.6.
  • 2.7The consolidated folder will contain geodatabases and maps compatible with version 2.7.
  • 2.8The consolidated folder will contain geodatabases and maps compatible with version 2.8.
String
select_related_rows
(Optional)

Specifies whether the specified extent will be applied to related data sources.

  • KEEP_ONLY_RELATED_ROWSOnly related data corresponding to records within the specified extent will be consolidated.
  • KEEP_ALL_RELATED_ROWSRelated data sources will be consolidated in their entirety. This is the default.
Boolean

Code sample

ConsolidateProject example 1 (Python window)

The following Python script demonstrates how to use the ConsolidateProject function from the Python window.

import arcpy
arcpy.ConsolidateProject_management('c:\\projects\\SE_Pipelines\\PipeDevelopment.aprx', 
                                    'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline',
                                    'INTERNAL')
ConsolidateProject example 2 (stand-alone script)

The following script takes an input directory in which project files (.aprx) reside on a UNC share and consolidates the project onto a local drive. The data will still be accessible to the now local project, as the INTERNAL keyword is used.

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")

Environments

Parallel Processing Factor

If the environment is not specified, the tool will use one half of the available cores.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics