Itérer sur les champs (Outils de modèle)

Résumé

Itère sur les champs d’une table

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

Utilisation

• Cet outil n’est disponible qu’à partir de 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ère générique) peuvent être utilisés en tant que filtres pour limiter les champs sur lesquels effectuer l’itération.

• Si le paramètre Field Names (Noms de champ) n’est pas défini, l’outil itère sur les champs qui respectent les filtres, le cas échéant.

• La duplication des champs dans le paramètre Field Names (Noms de champ) est ignorée.

• 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, %Value%) dans d’autres outils. La sortie Value (Valeur) est un type de champ et peut être utilisée avec d’autres outils qui acceptent une valeur de type de champ. La sortie Count (Total) correspond au nombre total de champs sur lesquels l’outil procède à l’itération.

• 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 via le paramètre Field Names (Noms de champ).

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

• Enregistrez les tables en mode de mise à jour pour mettre à jour les champs du paramètre Field Names (Noms de champ).

• Cet outil accepte des entrées avec des tables jointes. Les tables jointes génèrent 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 issues d’une connexion à une base de données.

• Un message apparaît en regard du paramètre Field Names (Noms de champ) dans les cas suivants :

  • Un champ n’existe pas dans une table.

  • Un champ ne correspond pas à un filtre Data Type (Type de données) spécifié.

  • Un champ ne correspond pas à un filtre Wildcard (Caractère générique) spécifié.

  Ces messages s’affichent en tant qu’avertissements dans la boîte de dialogue de l’outil Itérer sur les champs et en tant qu’erreurs dans la boîte de dialogue de la variable Field Names (Noms de champ).

Paramètres

• Dialog

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Table en entrée contenant les champs à renvoyer.	Table View; Raster Layer; Mosaic Layer
Type de champ (Facultatif)	Indique le type de champ utilisé pour filtrer les champs. Si le type de champ n’est pas spécifié, tous les champs des types de champs pris en charge sont renvoyés. Entier très grand—Les champs Big Integer (Entier très grand) sont renvoyés. BLOB—Les champs BLOB sont renvoyés. Date—Les champs Date sont renvoyés. Date Only (Date uniquement)—Les champs Date Only (Date uniquement) sont renvoyés. Double—Les champs Double sont renvoyés. Flottant—Les champs Float (Flottant) sont renvoyés. GlobalID—Les champs GlobalID sont renvoyés. GUID—Les champs GUID sont renvoyés. Long—Les champs Long integer (Entier long) sont renvoyés. Raster—Les champs Raster sont renvoyés. Court—Les champs Short integer (Entier court) sont renvoyés. Texte—Les champs Text (Texte) sont renvoyés. Time Only (Heure uniquement)—Les champs Time Only (Heure uniquement) sont renvoyés. Timestamp Offset (Décalage de l’horodatage)—Les champs Timestamp Offset (Décalage de l’horodatage) sont renvoyés. XML—Les champs XML sont renvoyés.	String
Caractère générique (Facultatif)	Restreint les champs renvoyés. Le caractère générique fonctionne à la fois sur les noms de champs et les alias de champ ; il combine * et d’autres caractères. Ce paramètre peut, par exemple, être utilisé pour restreindre l’itération sur les noms ou les alias de champ en entrée commençant par un caractère ou un mot spécifique (par exemple, A* ou Ari* ou Land*, etc.). Un astérisque équivaut à rechercher tous les 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 renvoyés.	Field

Sortie dérivée

Etiqueter	Explication	Type de données
Valeur	Champ renvoyé par chaque itération.	Field
Effectif	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