Consolider une boîte à outils (Gestion des données)

Synthèse

Consolide une ou plusieurs boîtes à outils dans un dossier en sortie spécifié.

Utilisation

  • Il se peut que des outils et des paramètres aient été ajoutés, supprimés ou modifiés entre la version d’ArcGIS AllSource installée et la version spécifiée pour le paramètre Version. Pour consolider une boîte à outils dans une version antérieure lorsque des fonctions uniquement disponibles dans la version plus récente sont incluses, l’outil génère des messages d’avertissement ou d’erreur après avoir comparé la compatibilité des versions de l’outil ou des outils inclus dans le paquetage.

Paramètres

ÉtiquetteExplicationType de données
Boîte à outils

Boîtes à outils à consolider.

Toolbox
Dossier en sortie

Dossier en sortie destiné à contenir la boîte à outils consolidée.

Si le dossier spécifié n’existe pas, un dossier est créé.

Folder
Version
(Facultatif)

Spécifie la version de la boîte à outils consolidée. Lorsqu’une version est indiquée, les boîtes à outils peuvent être partagées avec les versions précédentes d’ArcGIS et la rétrocompatibilité est assurée.

  • Version actuelleLe dossier consolidé contient des outils compatibles avec la version actuelle. Il s’agit de l’option par défaut.
  • 2.2Le dossier consolidé contient des outils compatibles avec la version 2.2.
  • 2.3Le dossier consolidé contient des outils compatibles avec la version 2.3.
  • 2.4Le dossier consolidé contient des outils compatibles avec la version 2.4.
  • 2.5Le dossier consolidé contient des outils compatibles avec la version 2.5.
  • 2.6Le dossier consolidé contient des outils compatibles avec la version 2.6.
  • 2.7Le dossier consolidé contient des outils compatibles avec la version 2.7.
  • 2.8Le dossier consolidé contient des outils compatibles avec la version 2.8.
  • 2.9Le dossier consolidé contient des outils compatibles avec la version 2.9.
  • 3.0Le dossier consolidé contient des outils compatibles avec la version 3.0.
  • 3.1Le dossier consolidé contient des outils compatibles avec la version 3.1.
  • 3.2Le dossier consolidé contient des outils compatibles avec la version 3.2.
String

arcpy.management.ConsolidateToolbox(in_toolbox, output_folder, {version})
NomExplicationType de données
in_toolbox
[in_toolbox,...]

Boîtes à outils à consolider.

Toolbox
output_folder

Dossier en sortie destiné à contenir la boîte à outils consolidée.

Si le dossier spécifié n’existe pas, un dossier est créé.

Folder
version
(Facultatif)

Spécifie la version de la boîte à outils consolidée. Lorsqu’une version est indiquée, les boîtes à outils peuvent être partagées avec les versions précédentes d’ArcGIS et la rétrocompatibilité est assurée.

  • CURRENTLe dossier consolidé contient des outils compatibles avec la version actuelle. Il s’agit de l’option par défaut.
  • 2.2Le dossier consolidé contient des outils compatibles avec la version 2.2.
  • 2.3Le dossier consolidé contient des outils compatibles avec la version 2.3.
  • 2.4Le dossier consolidé contient des outils compatibles avec la version 2.4.
  • 2.5Le dossier consolidé contient des outils compatibles avec la version 2.5.
  • 2.6Le dossier consolidé contient des outils compatibles avec la version 2.6.
  • 2.7Le dossier consolidé contient des outils compatibles avec la version 2.7.
  • 2.8Le dossier consolidé contient des outils compatibles avec la version 2.8.
  • 2.9Le dossier consolidé contient des outils compatibles avec la version 2.9.
  • 3.0Le dossier consolidé contient des outils compatibles avec la version 3.0.
  • 3.1Le dossier consolidé contient des outils compatibles avec la version 3.1.
  • 3.2Le dossier consolidé contient des outils compatibles avec la version 3.2.
String

Exemple de code

Exemple 1 d’utilisation de la fonction ConsolidateToolbox (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction ConsolidateToolbox dans la fenêtre Python.

import arcpy
arcpy.management.ConsolidateToolbox(r'C:\data\BufferPoints.tbx', 
                                    r'C:\project\Buffer_Pnts', "CURRENT")
Exemple 2 d’utilisation de la fonction ConsolidateToolbox (script autonome)

Rechercher et créer des dossiers consolidés individuels pour toutes les boîtes à outils qui se trouvent dans un dossier spécifié.

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

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.