Python erkennt am Anfang nur Werkzeuge, die in ArcGIS-System-Toolboxes wie "Data Management Tools", "Conversion Tools" und "Analysis Tools" gespeichert sind. Im Python-Fenster können Sie auf benutzerdefinierte Werkzeuge, die von einer Einzelperson, einem Drittanbieter oder einer Organisation erstellt und in einer benutzerdefinierten Toolbox gespeichert wurden, genauso wie auf alle Systemwerkzeuge zugreifen, indem Sie die benutzerdefinierte Toolbox in das ArcPy-Site-Paket importieren.
Im folgenden Beispiel wird die Funktion ImportToolbox verwendet, um zuzulassen, dass in Python auf Werkzeuge zugegriffen werden kann, die in einer benutzerdefinierten Toolbox enthalten sind. Nach dem Importieren der Toolbox können Sie auf die benutzerdefinierten Werkzeuge wie folgt zugreifen: arcpy.<werkzeugname>_<aliasname>.
>>> arcpy.ImportToolbox("c:/mytools/geometrytools.tbx")
>>> arcpy.CreateRegularPolygons_geometry(
Wenn auf ein Werkzeug über das ArcPy-Site-Paket zugegriffen wird, ist der Aliasname der Toolbox, in der das Werkzeug enthalten ist, ein erforderliches Suffix (arcpy.<werkzeugname>_<aliasname>). Da ArcPy für den Zugriff und das Ausführen des richtigen Werkzeugs die Toolbox-Aliasnamen benötigt, sind Aliasnamen beim Importieren von benutzerdefinierten Toolboxes sehr wichtig. Es ist daher ratsam, für eine benutzerdefinierte Toolbox immer einen Aliasnamen zu definieren. Falls kein Toolbox-Aliasname definiert ist, kann als zweiter Parameter der Funktion "ImportToolbox" ein temporärer Aliasname festgelegt werden.
>>> arcpy.ImportToolbox("c:/mytools/geometrytools.tbx", "mytools")
>>> arcpy.CreateRegularPolygons_mytools(
Hinzufügen und Entfernen von Server-Toolboxes
Mit ImportToolbox können Sie der Scripting-Umgebung auch Geoverarbeitungs-Services hinzufügen. Der Servername und der Name der Toolbox müssen durch ein Semikolon getrennt werden. Dabei spielt es keine Rolle, ob Sie den Geoverarbeitungs-Service von einem lokalen Server oder von einem Server im Internet hinzufügen.
Beispielsyntax für das Hinzufügen eines Geoverarbeitungs-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")
Beispielsyntax für das Hinzufügen eines lokalen Geoverarbeitungs-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")