Add toolboxes in 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(

Server toolboxes

Geoprocessing services can also be added to the scripting environment using ImportToolbox. Whether adding the geoprocessing service from a local or Internet server, the server and toolbox name are semicolon delimited.

Sample syntax for adding a geoprocessing service

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

Sample syntax for adding a local geoprocessing service

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