Consolidate Toolbox (Data Management)

Summary

Consolidates one or more toolboxes into a specified output folder.

Usage

• Tools and parameters may have been added, removed, or modified between the ArcGIS AllSource version installed and the version specified for the Version parameter. To consolidate a toolbox to an earlier version and capabilities that are only available in the newer version are included, the tool will produce warning or error messages based on a comparison of the version compatibility of the tool or tools included in the package.

Parameters

Dialog

Label	Explanation	Data Type
Toolbox	The toolboxes to be consolidated.	Toolbox
Output Folder	The output folder that will contain the consolidated toolbox. If the specified folder does not exist, a folder will be created.	Folder
Version (Optional)	Specifies the version of the consolidated toolbox. Specifying a version allows toolboxes to be shared with previous versions of ArcGIS and supports backward compatibility. Current version—The consolidated folder will contain tools compatible with the version of the current release. This is the default. ArcGIS AllSource 2.2— The consolidated folder will contain tools compatible with version 2.2. ArcGIS AllSource 2.3—The consolidated folder will contain tools compatible with version 2.3. ArcGIS AllSource 2.4—The consolidated folder will contain tools compatible with version 2.4. ArcGIS AllSource 2.5—The consolidated folder will contain tools compatible with version 2.5. ArcGIS AllSource 2.6—The consolidated folder will contain tools compatible with version 2.6. ArcGIS AllSource 2.7—The consolidated folder will contain tools compatible with version 2.7. ArcGIS AllSource 2.8—The consolidated folder will contain tools compatible with version 2.8. ArcGIS AllSource 2.9—The consolidated folder will contain tools compatible with version 2.9. ArcGIS AllSource 3.0—The consolidated folder will contain tools compatible with version 3.0. ArcGIS AllSource 3.1—The consolidated folder will contain tools compatible with version 3.1. ArcGIS AllSource 3.2—The consolidated folder will contain tools compatible with version 3.2. ArcGIS AllSource 3.3—The consolidated folder will contain tools compatible with version 3.3.	String

Python

arcpy.management.ConsolidateToolbox(in_toolbox, output_folder, {version})

Name	Explanation	Data Type
in_toolbox [in_toolbox,...]	The toolboxes to be consolidated.	Toolbox
output_folder	The output folder that will contain the consolidated toolbox. If the specified folder does not exist, a folder will be created.	Folder
version (Optional)	Specifies the version of the consolidated toolbox. Specifying a version allows toolboxes to be shared with previous versions of ArcGIS and supports backward compatibility. CURRENT—The consolidated folder will contain tools compatible with the version of the current release. This is the default. 2.2— The consolidated folder will contain tools compatible with version 2.2. 2.3—The consolidated folder will contain tools compatible with version 2.3. 2.4—The consolidated folder will contain tools compatible with version 2.4. 2.5—The consolidated folder will contain tools compatible with version 2.5. 2.6—The consolidated folder will contain tools compatible with version 2.6. 2.7—The consolidated folder will contain tools compatible with version 2.7. 2.8—The consolidated folder will contain tools compatible with version 2.8. 2.9—The consolidated folder will contain tools compatible with version 2.9. 3.0—The consolidated folder will contain tools compatible with version 3.0. 3.1—The consolidated folder will contain tools compatible with version 3.1. 3.2—The consolidated folder will contain tools compatible with version 3.2. 3.3—The consolidated folder will contain tools compatible with version 3.3.	String

Code sample

ConsolidateToolbox example 1 (Python window)

The following Python window script demonstrates how to use the ConsolidateToolbox function in the Python window.

import arcpy
arcpy.management.ConsolidateToolbox(r'C:\data\BufferPoints.tbx', 
                                    r'C:\project\Buffer_Pnts', "CURRENT")

ConsolidateToolbox example 2 (stand-alone script)

Find and create individual consolidated folders for all of the toolboxes that reside in a specified folder.

# Name: ConsolidateToolboxEx2.py
# Description: Find all the toolboxes that reside in a specified folder and 
#              create a consolidated folder for each.

# import system modules
import os
import arcpy

# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/Toolboxes"

# Loop through the workspace, find all the toolboxes (.tbx), and create a 
# consolidated folder for each toolbox found using the same name as the original 
# toolbox.
for tbx in arcpy.ListFiles("*.tbx"):
    print("Consolidating " +  tbx)
    arcpy.management.ConsolidateToolbox(tbx, os.path.splitext(tbx)[0], "CURRENT")

Environments

This tool does not use any geoprocessing environments.