Inicialmente, Python sólo reconoce las herramientas almacenadas en las cajas de herramientas del sistema de ArcGIS, como las herramientas de administración de datos, las herramientas de conversión y las cajas de herramientas de las herramientas de análisis. Se puede acceder a las herramientas personalizadas creadas por una persona, un tercero o una organización y almacenadas en una caja de herramientas personalizada en la ventana de Python como cualquier herramienta del sistema al importar la caja de herramientas personalizada en el paquete del sitio de ArcPy.
En el ejemplo que sigue, se utiliza la función ImportToolbox para permitir el acceso a las herramientas contenidas en una caja de herramientas personalizada en Python. Después de importar la caja de herramientas, se puede acceder a las herramientas personalizadas como arcpy.<nombre de la herramienta>_<alias>.
>>> arcpy.ImportToolbox("c:/mytools/geometrytools.tbx")
>>> arcpy.CreateRegularPolygons_geometry(
Cuando accede a una herramienta a través del paquete del sitio de ArcPy, se requiere el sufijo del alias de la caja de herramientas donde se encuentra la herramienta (arcpy.<nombre de la herramienta>_<alias>). Debido a que ArcPy depende de los alias de las cajas de herramientas para tener acceso y ejecutar la herramienta correcta, los alias son extremadamente importantes a la hora de importar las cajas de herramientas personalizadas. Se recomienda que siempre defina alias para las cajas de herramientas personalizadas. Sin embargo, si el alias de la caja de herramientas no está definido, se puede configurar un alias temporal como el segundo parámetro de la función ImportToolbox.
>>> arcpy.ImportToolbox("c:/mytools/geometrytools.tbx", "mytools")
>>> arcpy.CreateRegularPolygons_mytools(
Agregar y quitar cajas de herramientas de servidor
También se puede agregar servicios de geoprocesamiento al entorno de secuencias de comandos utilizando ImportToolbox. Ya se agregue el servicio de geoprocesamiento desde un servidor local o de Internet, el nombre del servidor y de la caja de herramientas se delimitan con punto y coma.
Ejemplo de sintaxis para agregar un servicio de geoprocesamiento
# 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")
Ejemplo de sintaxis para agregar un servicio de geoprocesamiento 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")