Resumen
Itera las entidades de una clase de entidad.
Más información acerca del funcionamiento de Iterar selección de entidades en ModelBuilder
Uso
La herramienta está pensada para utilizarse solo en ModelBuilder y no en scripts de Python.
Esta herramienta no admite clases de entidad complejas, como por ejemplo, anotación y dimensiones.
Para la selección puede utilizar más de un grupo por campo. Si se seleccionan uno o varios grupos por campo, el número de iteraciones se determina por el número de combinaciones únicas del grupo por campos. Para cada iteración, la selección de la capa de entidades de salida está determinada por el número de registros que coinciden con la combinación determinada del grupo por campos. 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 (NAME) y su categoría (Category). 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 se agrupará por el campo ObjectID, y la selección será un registro por selección. Si la tabla no contiene ningún campo ObjectID, por ejemplo, una tabla Excel, el valor está en blanco.
La herramienta tiene dos salidas: las Entidades seleccionadas y Valor de grupo del campo para las entidades seleccionadas, que se puede utilizar como variable en línea en otras herramientas.
La capa de entidades temporal se puede guardar como archivo de capa utilizando la herramienta Guardar en archivo de capa o se puede guardar como una nueva clase de entidad utilizando la herramienta Copiar entidades.
Si se agrega un iterador a un modelo, todas las herramientas del modelo se iterará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 solo el iterador y agréguelo al modelo principal como una herramienta de modelo.
Sintaxis
IterateFeatureSelection(in_features, {fields}, {skip_nulls})| Parámetro | Explicación | Tipo de datos |
in_features | La clase o capa de entidades de entrada que contiene las entidades que se desea iterar. | Feature Layer |
fields [fields,...] (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 especifica ningún campo, se utiliza ObjectID para iterar las entidades. | Value Table |
skip_nulls (Opcional) | Especifica si los valores nulos del campo o los campos de agrupación se omiten durante la selección.
| Boolean |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| selection | Una capa de entidades que se puede utilizar en otras herramientas de geoprocesamiento que acepten una capa de entidades en ModelBuilder. | Capa de entidades |
| value | El valor de campo que devuelve cada iteración. Si se elige más de un grupo por campo, los valores se concatenan <field value1>_<field value2>. | Variante |
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí