Itérer les champs (ModelBuilder)

Utilisation

  • Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts Python.

  • Les paramètres Data Type (Type de données) et Wildcard (Caractères génériques) peuvent servir comme filtres pour limiter les champs à itérer.

  • Si le paramètre Field Names (Noms de champs) n’est pas défini, l’outil itérera les champs respectant les filtres, s’ils sont spécifiés.

  • Les champs en double dans le paramètre Field Names (Noms de champs) seront ignorés à l’exécution de l’outil.

  • Cet outil génère deux sorties, Value (Valeur) et Count (Total), qui peuvent être utilisées en tant que variables en ligne (par exemple, %Valeur%) dans d’autres outils. La sortie Value (Valeur) est un type de champ et peut être utilisée avec d’autres outils acceptant une valeur de type de champ. La sortie Count (Total) est le nombre total de champs que l’outil itère.

  • Les champs de géométrie ne sont pas répertoriés dans le paramètre Data Type (Type de données), mais sont accessibles à l’aide du paramètre Field Names (Noms de champs).

  • Si un champ ne figure pas dans le paramètre Field Names (Noms de champs), la sortie Value (Valeur) utilisera le premier champ de la table. Si les champs apparaissent dans le paramètre Field Names (Noms de champs), la sortie Value (Valeur) utilisera le premier champ du paramètre Field Names (Noms de champs). Dans les deux cas, si le premier champ est le champ de géométrie, il sera ignoré.

  • Enregistrez les tables en mode de mise à jour pour actualiser les champs dans le paramètre Field Names (Noms de champs).

  • Cet outil accepte les entrées dans les tables jointes. Les tables jointes généreront les noms de champ qui respectent l’environnement Maintain fully qualified field names (Gérer les noms de champs complets).

  • Cet outil accepte les entrées provenant d’une connexion à une base de données.

  • Un message s’affichera à côté du paramètre Field Names (Noms de champs) si l’une des situations suivantes se produit :

    • Un champ n’existe pas dans la table.
    • Un champ ne correspond pas au filtre de type de données (Data Type) spécifié.
    • Un champ ne correspond pas au filtre de caractère générique (Wildcard) spécifié.
    Ces messages apparaissent sous forme d’avertissements dans la boîte de dialogue de l’outil Iterate Fields (Itérer les champs) et sous forme d’erreurs dans la boîte de dialogue de la variable Field Names (Noms de champs).

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

Table en entrée avec champs à itérer.

Table View; Raster Layer; Mosaic Layer
Type de champ
(Facultatif)

Spécifie le type de champ utilisé pour filtrer les champs. Si aucun type de champ n’est spécifié, tous les champs des types de champ prise en charge seront itérés.

  • BLOBLes champs BLOB seront itérés.
  • DateLes champs de date seront itérés.
  • DoubleLes champs doubles seront itérés.
  • FlottantLes champs de nombres réels simples seront itérés.
  • GUIDLes champs GUID seront itérés.
  • LongLes champs d’entiers longs seront itérés.
  • RasterLes champs de type raster seront itérés.
  • Entier courtLes champs d’entiers courts seront itérés.
  • objet TexteLes champs de texte seront itérés.
String
Caractère générique
(Facultatif)

Limite les champs qui seront itérés. Le caractère générique fonctionne sur les noms de champs et les alias de champs et constitue une combinaison d’astérisques (*) et d’autres caractères. Par exemple, ce paramètre permet de restreindre l’itération de noms de champs en entrée ou des alias de champ commencent par un caractère ou un mot donné (par exemple, A*, Ari* ou Land* et ainsi de suite). Un astérisque permet de rechercher l’ensemble des champs. Si aucun caractère générique n’est spécifié, toutes les entrées sont renvoyées.

String
Noms de champs
(Facultatif)

Liste des champs concernés par l’itération.

Field

Sortie obtenue

ÉtiquetteExplicationType de données
Valeur

Champ renvoyé par chaque itération.

Terrain
Décompte

Nombre total de champs pour toutes les itérations.

Long

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui