Iterar selección de entidades (ModelBuilder)
Resumen
Itera las entidades de una clase de entidad.
Más información acerca del funcionamiento de Iterar selección de entidad en ModelBuilder
Uso
-
La herramienta esta pensada para utilizarse solo en ModelBuilder y no en secuencias de comandos de Python.
-
Iterar selección de entidades utiliza Crear capa de entidades para hacer una nueva selección y crea dos salidas: Entidades seleccionadas y Valor: Las Entidades seleccionadas de la salida son una capa de entidades y se puede utilizar en otras herramientas de geoprocesamiento que acepten una capa de entidades en ModelBuilder.
-
Esta herramienta no admite clases de entidad complejas, como por ejemplo, anotación y dimensiones.
-
Se puede utilizar más de un grupo por campo para la selección. Si se selecciona uno o más grupos por campos, el número de combinaciones únicas de cada grupo por campos determina el número de iteraciones. Para cada iteración, el número de registros que coinciden con la combinación determinada del grupo por campo determina la selección de la capa de entidades de salida. Si se selecciona más de un grupo por campo, los valores se concatenan <field value1>_<field value2> en el nombre de la variable en línea de salida. Consulte el siguiente ejemplo, en el que se utilizan dos campos de grupo: el nombre del huracán y su categoría. El valor de salida es 'Katrina_H5' y así sucesivamente para los demás valores.
-
Si no se selecciona ningún grupo por campo, el valor de salida será el grupo por campo ObjectID, y la selección será un registro por selección. Si la tabla no tiene un campo ObjectID (OID), como una tabla de Excel, el valor estará en blanco.
-
La herramienta tiene dos salidas: Las entidades seleccionadas de la salida y el valor de grupo del campo para las entidades seleccionadas, que se puede utilizar como variable en línea %Value% en otras herramientas.
-
La capa de entidades temporal se puede guardar como un archivo de capa mediante la herramienta Guardar en archivo de capa como una nueva clase de entidad o mediante la herramienta Copiar entidades.
-
Si se agrega un iterador a un modelo, todas las herramientas del modelo se repetirán para cada valor en el iterador. Si no desea ejecutar cada herramienta en el modelo para cada valor iterado, cree un submodelo/modelo dentro de un modelo o modelo anidado que contenga sólo el iterador y agréguelo al modelo principal como una herramienta de modelo.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_features |
Clase de entidad de entrada o capa que contiene entidades que se van a iterar. | Feature Layer |
fields [[Field, Null Value],...] (Opcional) |
El campo o campos de entrada utilizados para agrupar las entidades para la selección. Se puede definir cualquier número de campos de entrada, y su resultado será una selección basada en una combinación única de los campos. Si no se ha especificado ningún campo, se utiliza el OID para iterar las entidades. Defina el valor nulo para el campo. Por defecto, los valores nulos se incluyen en la selección a menos que se especifique lo contrario o esté marcada la opción de omitir todos los valores nulos. Los valores por defecto son "" para cadenas de caracteres y "0" para números. | Value Table |
skip_nulls (Opcional) |
Determina si se omiten los valores nulos en el campo o campos de agrupamiento durante la selección.
| Boolean |