Itérer les champs (ModelBuilder)

Résumé

Itère les champs d’une table.

En savoir plus sur le fonctionnement de l’outil Itérer les champs dans ModelBuilder

Utilisation

• Cet outil est prévu uniquement 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) de l’outil utilisera le premier champ de la table. Si les champs apparaissent dans le paramètre Field Names (Noms de champs), la sortie Value (Valeur) de l’outil 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).

Syntaxe

IterateFields(in_table, {field_type}, {wildcard}, {input_fields})

Paramètre	Explication	Type de données
in_table	Table en entrée avec champs à itérer.	Table View; Feature Layer; Raster Layer
field_type [field_type,...] (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. BLOB —Les champs BLOB seront itérés. DATE —Les champs de date seront itérés. DOUBLE —Les champs doubles seront itérés. FLOAT —Les champs de nombres réels simples seront itérés. GUID —Les champs GUID seront itérés. LONG —Les champs d’entiers longs seront itérés. RASTER —Les champs de type raster seront itérés. SHORT —Les champs d’entiers courts seront itérés. TEXT —Les champs de texte seront itérés.	String
wildcard (Facultatif)	Caractère générique utilisé pour limiter 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. Un astérisque permet d’interroger l’ensemble des champs. Si aucun caractère générique n’est spécifié, toutes les entrées sont renvoyées. 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).	String
input_fields [input_fields,...] (Facultatif)	Liste des champs concernés par l’itération.	Field

Sortie dérivée

Nom	Explication	Type de données
output_field	Champ renvoyé par chaque itération.	Champ
output_count	Nombre total de champs pour toutes les itérations.	Longue

Environnements

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

Informations de licence

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