Ajout de boîtes à outils dans Python

À l'origine, Python ne connaît que les outils stockés dans des boîtes à outils système ArcGIS telles que Outils de gestion des données, Outils de conversion et Outils d'analyse. La fenêtre Python permet d'accéder à des outils personnalisés créés par une personne, tierce partie ou organisation et stockés dans une boîte à outils personnalisée comme s'il s'agissait de n'importe quel outil système, par importation de cette boîte à outils dans le site-package ArcPy.

Dans l'exemple suivant, la fonction ImportToolbox est utilisée pour autoriser l'utilisateur à accéder, depuis Python, aux outils d'une boîte à outils personnalisée. Une fois la boîte à outils importée, vous pouvez accéder aux outils personnalisés par arcpy.<nomd'outil>_<alias>.

>>> arcpy.ImportToolbox("c:/mytools/geometrytools.tbx")
>>> arcpy.CreateRegularPolygons_geometry(

Lorsque l'utilisateur accède à un outil par le site-package ArcPy, l'alias de la boîte à outils dans lequel il se trouve est un suffixe obligatoire (arcpy.<nomd'outil>_<alias>). Du fait qu'ArcPy se base sur l'alias des boîtes à outils pour accéder à l'outil approprié et l'exécuter, les alias jouent un rôle majeur, lors de l'importation de boîtes à outils personnalisées. Il est recommandé de toujours définir l'alias d'une boîte à outils personnalisée. Toutefois, si vous ne définissez pas d'alias, vous pouvez spécifier un alias temporaire comme deuxième paramètre de la fonction ImportToolbox.

>>> arcpy.ImportToolbox("c:/mytools/geometrytools.tbx", "mytools")
>>> arcpy.CreateRegularPolygons_mytools(

Ajout et suppression des boîtes à outils de serveur

Les services de géotraitement peuvent également être ajoutés à l'environnement de script à l'aide de la fonction ImportToolbox. Indépendamment de l'ajout du service de géotraitement à partir d'un serveur local ou Internet, les noms de serveur et de boîte à outils sont séparés par des points-virgules.

Exemple de syntaxe pour l'ajout d'un service de géotraitement

# Import a geoprocessing service
#
import arcpy

# To add a toolbox from a Internet server, provide the url and toolbox name 
#   delimited by a semi-colon
#
arcpy.ImportToolbox("http://lab13/arcgis/services;BufferByVal")

Exemple de syntaxe pour l'ajout d'un service de géotraitement local

# Import a local geoprocessing service
#
import arcpy

# To add a toolbox from a local server, provide the server and toolbox name 
#   delimited by a semi-colon
#
arcpy.ImportToolbox("lab13;BufferByVal")