Iterar selección de filas (ModelBuilder)

Uso

  • La herramienta está pensada para utilizarse en ModelBuilder y no en scripts de Python.

  • 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. A continuación, se muestra un ejemplo en el que se utilizan dos campos de grupo: CALL_TYPE y Crime_Peri (periodo de criminalidad). La salida Valor es Vandalism_Morning, y así sucesivamente con el resto de valores.

    Iterar selección de filas

  • 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.

  • La herramienta tiene dos salidas: Filas seleccionadas y Valor de grupo del campo ObjectID de las entidades seleccionadas, que podría usarse como variable en línea %Value% en otras herramientas.

  • Si se agrega un iterador a un modelo, todas las herramientas del modelo se iteran 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.IterateRowSelection(in_table, {fields}, {skip_nulls})
ParámetroExplicaciónTipo de datos
in_table

La tabla que contiene los registros que se desea iterar.

Table View
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 de los campos de agrupación se omiten durante la selección.

  • Activado: omite todos los valores nulos en los campos de agrupación durante la selección.
  • Desactivado: se incluyen todos los valores nulos de los campos de agrupación durante la selección. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
selection

Una vista de tabla que se puede utilizar en otras herramientas de geoprocesamiento que acepten una vista de tabla en ModelBuilder.

Vista de tabla
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

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí