Iterar campos (ModelBuilder)

Uso

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

  • Los parámetros Tipo de datos y Comodín pueden usarse como filtros para limitar los campos que se desea iterar.

  • Si el parámetro Nombres de campo no está definido, la herramienta itera los campos que respeten los filtros, si así se especifica.

  • Los campos duplicados del parámetro Nombres de campo se omiten al ejecutar la herramienta.

  • Esta herramienta tiene dos salidas, Valor y Recuento, que se pueden usar como variables en línea (por ejemplo, %Value%) en otras herramientas. La salida de Valor es un tipo de campo y puede utilizarse con otras herramientas que acepten un valor de tipo de campo. La salida de Recuento es el número total de campos que itera la herramienta.

  • Los campos de geometría no se enumeran en el parámetro Tipo de datos, pero están accesibles con el parámetro Nombres de campo.

  • Si un campo no aparece en el parámetro Nombres de campo, la salida Valor de la herramienta utilizará el primer campo de la tabla. Si los campos están enumerados en el parámetro Nombres de campo, la salida Valor de la herramienta utilizará el primer campo del parámetro Nombres de campo. En ambos casos, si el primer campo es el de geometría, se omitirá.

  • Guarde las tablas en el modo de edición para actualizar los campos del parámetro Nombres de campo.

  • Esta herramienta acepta entradas con tablas unidas. Las tablas unidas generan los nombres de campo que respeten el entorno Mantener los nombres de los campos totalmente calificados.

  • Esta herramienta acepta entradas de una conexión de base de datos.

  • Aparecerá un mensaje junto al parámetro Nombres de campo si se da cualquiera de los siguientes supuestos:

    • Un campo no existe en una tabla.
    • Un campo no coincide con un filtro de Tipo de datos especificado.
    • Un campo no coincide con un filtro de Comodín especificado.
    Estos mensajes aparecen como advertencias en el cuadro de diálogo de la herramienta Iterar campos y como errores en el cuadro de diálogo de la variable Nombres de campo.

Sintaxis

IterateFields(in_table, {field_type}, {wildcard}, {input_fields})
ParámetroExplicaciónTipo de datos
in_table

La tabla de entrada con campos que se desea iterar.

Table View; Feature Layer; Raster Layer
field_type
[field_type,...]
(Opcional)

Especifica el tipo de campo utilizado para filtrar los campos. Si no se especifica ningún tipo de campo, se iterarán todos los campos de los tipos de campos admitidos.

  • BLOBSe iteran los campos de BLOB.
  • DATESe iteran los campos de fecha.
  • DOUBLESe iteran los campos dobles.
  • FLOATSe iteran los campos flotantes.
  • GUIDSe iteran los campos de GUID.
  • LONGSe iteran los campos de tipo entero largo.
  • RASTERSe iteran los campos de ráster.
  • SHORTSe iteran los campos de tipo entero corto.
  • TEXTSe iteran los campos de texto.
String
wildcard
(Opcional)

Un comodín utilizado para limitar los campos que se iterarán. El comodín funciona tanto en el nombre de campo como en el alias de campo y es una combinación de * y otros caracteres. Un asterisco equivale a solicitar todos los campos. Si no se especifica ningún comodín, se devolverán todas las entradas. Por ejemplo, este parámetro se puede utilizar para restringir la iteración de los nombres de campo o alias de campo de entrada a los que comiencen por un carácter o una palabra determinados (p. ej., A* o Ari* o Land*, etc.).

String
input_fields
[input_fields,...]
(Opcional)

La lista de campos que se iterarán.

Field

Salida derivada

NombreExplicaciónTipo de datos
output_field

El campo devuelto por cada iteración.

Campo
output_count

El número total de campos para todas las iteraciones.

Largo

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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