Cualquier variable de modelo se puede definir como parámetro de modelo. Los siguientes son los dos motivos principales para definir una variable de modelo como parámetro:
- Las variables que se definen como parámetros de modelo se muestran como parámetros de la herramienta cuando el modelo se ejecuta como una herramienta de geoprocesamiento, lo que permite especificar datos o valores para procesar el modelo distintos de los que se especificaron al crear el modelo.
- Las variables de salida que se definen como parámetros de modelo y hacen referencia a un dataset se agregan al mapa cuando el modelo se ejecuta como una herramienta de geoprocesamiento. Además, si una variable de salida derivada está establecida como parámetro del modelo y dicha variable hace referencia a un dataset o espacio de trabajo actualizado por una herramienta, ese dataset o espacio de trabajo se actualizará automáticamente cuando la herramienta de modelo finalice su ejecución para que las actualizaciones sean visibles.
Definir parámetros de modelo
Para definir una variable de modelo como parámetro, se debe editar el modelo en ModelBuilder. En ModelBuilder, haga clic con el botón derecho en la variable y seleccione Parámetro. Al definir una variable como parámetro, aparece la letra P junto a la variable del modelo.
El nombre de la variable se utiliza como la etiqueta del parámetro de modelo. Puede cambiar el nombre de un parámetro de modelo cambiando el nombre de la variable de modelo en ModelBuilder. Haga clic con el botón derecho en la variable, seleccione Cambiar nombre e indique el nuevo nombre. Al abrir la herramienta del modelo en el panel Geoprocesamiento, el nombre del parámetro refleja el nombre nuevo. El valor de la variable se utiliza como el valor predeterminado del parámetro de modelo correspondiente. Si la variable no tiene ningún valor en ModelBuilder, el parámetro de modelo estará en blanco.
Para que la salida de una herramienta de modelo aparezca en el panel Historial, configure la salida como un parámetro del modelo. Por ejemplo, si una herramienta da salida a un archivo .html, configure el parámetro de salida como parámetro del modelo para abrir el archivo desde el panel Historial.
Propiedades del parámetro de modelo
Puede cambiar varias propiedades de los parámetros de modelo utilizando la ventana Propiedades del modelo. Estas propiedades afectan al modo en que aparecen los parámetros al abrir la herramienta del modelo en el panel Geoprocesamiento.
Haga clic con el botón derecho en la herramienta de modelo de una caja de herramientas y seleccione Propiedades o, si está editando el modelo en ModelBuilder, haga clic en el botón Propiedades en la pestaña ModelBuilder.
Orden
Si desea cambiar el orden de los parámetros, arrástrelos en el orden nuevo a la pestaña Parámetros de la ventana Propiedades de la herramienta.
Tipo
Esta propiedad designa el tipo de parámetro del modelo de la siguiente manera:
- Requerido: el parámetro debe tener un valor para que la herramienta se ejecute.
- Opcional: El parámetro no requiere un valor.
- Derivado: utilice parámetros derivados en los siguientes casos:
- La salida es igual que la entrada. Por ejemplo, la herramienta Calcular campo actualiza los valores de un campo en la tabla de entrada. No crea una tabla ni modifica el esquema de la entrada.
- La herramienta modifica el esquema de la entrada. Por ejemplo, la herramienta Agregar campo agrega un campo a la tabla de entrada.
- La herramienta genera un valor escalar como un número, una cadena de caracteres o un valor booleano. Por ejemplo, la herramienta Obtener conteo devuelve un valor entero derivado.
- La herramienta crea una salida a partir de los valores de otros parámetros. Por ejemplo, la herramienta Crear clase de entidad devuelve una ruta de clase de entidad derivada construida a partir de otros parámetros que tienen valores de ruta y nombre.
- La herramienta crea los datos en una ubicación conocida. Por ejemplo, tiene un script que crea una clase de entidad en un espacio de trabajo conocido. Ni la clase de entidad ni el espacio de trabajo son opciones de parámetro.
La designación de obligatorio, opcional o derivado se realiza automáticamente según cómo se use el parámetro en el modelo. Por ejemplo, si la variable se utiliza como la entrada de un parámetro obligatorio de una herramienta del modelo, dicho parámetro de modelo será obligatorio. Puede modificar los parámetros de modelo de opcionales a obligatorios para la herramienta de modelo, pero no puede cambiar los parámetros obligatorios a opcionales.
Para cambiar un parámetro opcional a un parámetro obligatorio, defina la opción Tipo como Obligatorio en la pestaña Parámetros de la ventana Propiedades de la herramienta.
Dirección
Esta propiedad define si el parámetro es una entrada de la herramienta o una salida de la herramienta.
Si el tipo de parámetro es Derivado, la dirección del parámetro se definirá automáticamente como Salida.
Todas las herramientas de script deben tener parámetros de salida para que se puedan utilizar en ModelBuilder. La idea fundamental de ModelBuilder es conectar la salida de las herramientas con las entradas de otras herramientas y, si la herramienta de script no tiene un parámetro de salida, no será muy útil en ModelBuilder. La salida puede ser un dataset proporcionado para un valor de parámetro, una salida derivada donde la ubicación o el nombre se determina en el script, o un valor derivado que se calcula o determina. Como mínimo, puede generar un valor booleano que contenga True si la herramienta finalizó correctamente, y False en caso contrario.
Descripción
Esta propiedad define una descripción para un parámetro que aparece en el cuadro de diálogo de la herramienta al pasar el cursor por encima del botón Información 
situado junto a la etiqueta del parámetro.
Como alternativa, proporcione ayuda para un parámetro en los metadatos del modelo. Haga clic con el botón derecho en el modelo dentro de una caja de herramientas y seleccione Editar metadatos. Agregue información para un parámetro de la herramienta de modelo en la sección Sintaxis.
Más información sobre cómo documentar una herramienta personalizada
Categoría
Se pueden asignar parámetros a una categoría. Los parámetros categorizados se muestran en una sección desplegable al abrir la herramienta en el panel Geoprocesamiento.
Filtro
Utilice un filtro de parámetro para limitar o restringir los valores o datos de entrada que se pueden especificar para un parámetro de la herramienta de modelo. Por ejemplo, el filtro Lista de valores requiere que solo se puedan especificar valores de una lista para el parámetro. Los valores introducidos en un parámetro que no coincidan con el filtro generarán un error, y no se puede ejecutar el modelo hasta que se introduzca un valor válido.
Están disponibles los siguientes filtros:
- Lista de valores: lista de palabras clave predefinidas. Puede definir un filtro de lista de valores para los parámetros numéricos y de cadena de caracteres del modelo.
- Rango: valor numérico mínimo y máximo. El rango es inclusivo, lo que significa que tanto el mínimo como el máximo son opciones válidas.
- Clase de entidad: lista de tipos de formas de entidad permitidos, incluidos: punto, multipunto, polilínea, polígono y multiparche.
- Archivo: lista de extensiones de archivos válidas, como .txt o .gpx.
Nota:
No incluya el punto para la extensión. Por ejemplo, escriba txt, no .txt. Separe los valores de la lista por un punto y coma (;). Por ejemplo, para permitir archivos .txt y .csv, escriba txt; csv.
- Campo: lista de tipos de campos permitidos, incluidos: corto, largo, único, doble, prueba, fecha, OID, geometría, BLOB, ráster, GUID, Id. global y XML.
- Espacio de trabajo: tipo de espacio de trabajo permitido, incluido: sistema de archivos, geodatabase local y geodatabase corporativa.
Dependencia
Puede hacer que un parámetro dependa de otro parámetro. El uso típico de esta opción consiste en hacer que un parámetro que admite un campo de atributo dependa de otro parámetro que sea una clase de entidad o tabla; el parámetro de campo incluirá una lista desplegable de campos de atributos del parámetro dependiente.
Simbología
Es posible guardar un archivo de capa con una simbología definida y utilizar ese archivo de capa como plantilla de cómo se simbolizarán las salidas del modelo cuando se agreguen a un mapa. Se puede lograr de las siguientes maneras:
- Establezca la opción Simbología de un parámetro de salida en una ruta a un archivo de capa, como C:\Data\LandUseOverlay\Symbolized.lyrx, en la pestaña Parámetros de la ventana Propiedades de la herramienta.
- Agregue la herramienta Aplicar simbología de capa al final del modelo y establezca el parámetro Capa de simbología en una ruta al archivo de capa.