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