Crear una herramienta de script

Una herramienta de script es una herramienta de geoprocesamiento que ejecuta un script o archivo ejecutable. Las herramientas de script ejecutan estos scripts mediante una herramienta de geoprocesamiento como interfaz para su script. Cuando crea una herramienta de script, tiene que especificar los parámetros que necesita el script para ejecutarlo. Los parámetros más comunes son datasets de entrada y salida, nombres de campo y cadenas elegidas de una lista. Cuando se ejecuta la herramienta de script, los valores de los parámetros pasan al script y los utiliza dicho script.

Numerosas herramientas de script ejecutan un script de Python (.py) que utiliza ArcPy, un paquete de sitio de Python que se instala con ArcGIS. ArcPy proporciona acceso a las herramientas de geoprocesamiento así como a las funciones adicionales, las clases y los módulos que le permiten crear flujos de trabajo simples o complejos. A través de ArcPy, el script puede acceder al entorno de geoprocesamiento de ArcGIS; de ese modo ofrece ventajas como la proyección al vuelo, la admisión de un conjunto de selección, la validación de entradas, el envío de mensajes de error y el registro del historial.

Las herramientas de secuencias de comandos se crean en una caja de herramientas. Para crear una herramienta de script, haga clic con el botón derecho del ratón en una caja de herramientas del panel Catálogo y seleccione Nuevo > Script.

Propiedades

Al crear una herramienta de script, aparece el cuadro de diálogo de propiedades de esa herramienta de script con las siguientes pestañas laterales:

  • General
  • Parámetros
  • Ejecución
  • Validación

General

La pestaña General incluye propiedades como el nombre, la etiqueta y la descripción de la herramienta.

Nota:

Si su caja de herramientas es una caja de herramientas heredada (.tbx), también existe una propiedad para almacenar la ruta del script de ejecución de la herramienta en relación con el archivo de caja de herramientas. Si su caja de herramientas es una caja de herramientas de ArcGIS (.atbx), este comportamiento se administra de forma diferente. Si el script se encuentra en el mismo directorio que el archivo .atbx o se encuentra en una carpeta secundaria desde donde se almacena .atbx, se mantiene una ruta relativa. Si el script y el archivo .atbx son completamente independientes, se mantiene una ruta absoluta.

Parámetros

La pestaña Parámetros presenta una tabla de propiedades de parámetros, donde cada fila es un parámetro. La tabla estará vacía de forma predeterminada. Para cada parámetro, se definen diversas propiedades como la etiqueta que aparece para ese parámetro en la interfaz de usuario, el tipo de datos que acepta el parámetro y si el parámetro es opcional u obligatorio. Como mínimo, debe establecer las propiedades Etiqueta, Nombre, Tipo de datos, Tipo y Dirección del parámetro.

PropiedadDescripción

Etiqueta

El nombre del parámetro se muestra en la herramienta.

Nombre

Nombre del parámetro cuando se llama a la herramienta de script como una función desde un script de Python diferente.

Tipo de datos

Tipo de datos que acepta el parámetro. Esto determina el control que se usa en la herramienta. Por ejemplo, si selecciona Capa de entidades, puede seleccionar una capa en un mapa activo o ir a una clase de entidad.

Tipo

Los parámetros pueden ser obligatorios u opcionales. Si el parámetro es obligatorio, debe tener un valor o la herramienta no se podrá ejecutar. Si el parámetro es opcional, la herramienta se puede ejecutar sin especificar un valor.

Dirección

Los parámetros pueden ser de entrada o de salida. Los parámetros de entrada representan los datos existentes que se deben procesar o los valores que se deben usar en el procesamiento. Los parámetros de salida representan los datos que la herramienta crea o los valores calculados.

Categoría

Al introducir el nombre de una categoría, el parámetro se incluye en un grupo desplegable en el cuadro de diálogo de la herramienta.

Filtro

Los filtros permiten especificar determinados tipos de un dataset, archivo o campo, valores específicos o valores de un rango son entradas aceptables para una herramienta. Por ejemplo, puede filtrar un parámetro de clase de entidad de forma que solo las clases de entidades de puntos sean aceptables o puede filtrar un parámetro numérico para que solo sean aceptables los valores comprendidos entre 1 y 10.

Dependencia

Puede hacer que un parámetro dependa de otro parámetro. Por ejemplo, un parámetro de campo depende de un parámetro de dataset. Al definir esta dependencia, se hace de forma que se puede seleccionar un campo del dataset dependiente.

Predeterminado

Valor definido automáticamente para el parámetro cuando aparece el cuadro de diálogo de la herramienta.

Medio ambiente

Un parámetro puede derivar su valor predeterminado de un entorno de geoprocesamiento. De este modo, si se ha definido un entorno de geoprocesamiento especificado, el valor se utilizará como valor predeterminado para el parámetro proporcionado cuando aparece el cuadro de diálogo de la herramienta.

Simbología

Ruta de un archivo de capa que define la simbología del parámetro. Por ejemplo, puede hacer que un parámetro del dataset de salida tenga la misma simbología del archivo de capa cuando la salida se cree y se agregue al mapa.

Ejecución

La pestaña Ejecución incluye propiedades relacionadas con el código de ejecución de la herramienta de script, o la ruta a un Python o archivo de script R. La página también incluye opciones para integrar y proteger con contraseña el código de ejecución de la herramienta de script, o exportar el código de ejecución a un nuevo archivo.

Puede elegir integrar el código de ejecución dentro de la caja de herramientas, o vincular a un archivo de script externo. Independientemente de la ubicación del código de ejecución, la página incluye un editor de código que puede utilizar para modificar el código de ejecución, o hacer clic en el botón Abrir en Editor de script para abrir el código de ejecución en un editor de scripts. Puede especificar su editor de scripts preferido en las opciones de geoprocesamiento.

Validación

La página Validación muestra el código de validación de la herramienta de script. La validación permite personalizar el modo en el que los parámetros de la herramienta responden a los valores y a otros parámetros de la herramienta de script e interaccionan con ellos. El código de validación está escrito en Python.

El bloque de código ToolValidator de Python proporciona un control del aspecto, los comportamientos y los mensajes de la herramienta de script. Puede editar el código de Validación directamente en un editor de código o hacer clic en el botón Abrir en Editor de script para abrir el código de validación en el editor de script preferido, que se habrá definido en las opciones de Geoprocesamiento.

Temas relacionados