Itérer les champs (ModelBuilder)

Synthèse

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 n’est disponible qu’à partir du ruban ModelBuilder et s’utilise dans les modèles. L’outil n’est pas disponible via la fenêtre Geoprocessing (Géotraitement) ou via 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

Boîte de dialogue

Étiquette	Explication	Type 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. 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. Flottant—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. Entier court—Les champs d’entiers courts seront itérés. objet Texte—Les 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

Étiquette	Explication	Type 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