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 en ModelBuilder y no en scripts de Python.
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 (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 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 solo el iterador y agréguelo al modelo principal como una herramienta de modelo.
Sintaxis
arcpy.mb.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í