Itérer dans une sélection d'enregistrements (Outils de modèle)

Résumé

Itère les lignes d'une table.

En savoir plus sur le fonctionnement de l’outil Itérer sur une sélection d’enregistrements 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.
La sélection peut se composer de plusieurs champs de regroupement. Si un ou plusieurs champs de regroupement sont sélectionnés, le nombre d’itérations est déterminé par le nombre de combinaisons uniques de champs de regroupement. Pour chaque itération, la sélection de la couche d'entités en sortie est déterminée par le nombre d'enregistrements qui correspondent à la combinaison de champs de regroupement donnée. Si plusieurs champs de regroupement sont spécifiés, les valeurs sont concaténées sous la forme <field value1>_<field value2> dans le nom de la variable en ligne de sortie. Dans l’exemple ci-dessous, deux champs de regroupement sont utilisés : CALL_TYPE et Crime_Peri (période d’infraction). La valeur en sortie est Vandalism_Morning, et ainsi de suite pour les autres valeurs.
Si aucun champ de regroupement n’est spécifié, la valeur en sortie est regroupée selon le champ ID d’objet, et la sélection se compose d’un enregistrement par sélection.
L’outil génère deux sorties : Selected Rows (Enregistrements sélectionnés) et Value (Valeur) de regroupement du champ de l’identifiant d’objet pour les entités sélectionnées, qui peuvent être utilisées comme variable en ligne (%Value%) dans d’autres outils.
Si un itérateur est ajouté à un modèle, tous les outils du modèle itèrent chaque valeur de l’itérateur. Si vous ne souhaitez pas exécuter chacun des outils que le modèle comprend pour chaque valeur itérée, créez un sous-modèle, un modèle dans un modèle ou un modèle imbriqué qui contient uniquement l’itérateur et ajoutez-le comme outil de modèle au modèle principal.

Paramètres

Dialog

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Table qui contient les enregistrements à itérer.	Table View
Champs de groupement (Facultatif)	Le ou les champs en entrée utilisés pour regrouper les entités pour sélection. Vous pouvez définir autant de champs en entrée que vous voulez. La sélection s’effectue alors sur la base d’une combinaison unique des champs. Si aucun champ n’est spécifié, l’identifiant de l’objet permet d’itérer les entités. Colonnes de la table de valeurs : Field—The fields that will be used to group the features for selection. Null Value—The value from the field that will be substituted for a null value.	Value Table
Ignorer les valeurs NULL (Facultatif)	Indique si les valeurs NULL (nulles) dans les champs de regroupement doivent être ignorées lors de la sélection. Checked—Indique que les valeurs NULL (nulles) dans les champs de regroupement sont ignorées lors de la sélection. Unchecked—Indique que les valeurs NULL (nulles) dans les champs de regroupement ne sont pas ignorées lors de la sélection. Il s’agit de l’option par défaut.	Boolean

Etiqueter

Explication

Type de données

Input Table (Table en entrée)

Table qui contient les enregistrements à itérer.

Table View

Champs de groupement

(Facultatif)

Le ou les champs en entrée utilisés pour regrouper les entités pour sélection. Vous pouvez définir autant de champs en entrée que vous voulez. La sélection s’effectue alors sur la base d’une combinaison unique des champs. Si aucun champ n’est spécifié, l’identifiant de l’objet permet d’itérer les entités.

Colonnes de la table de valeurs :

Field—The fields that will be used to group the features for selection.
Null Value—The value from the field that will be substituted for a null value.

Value Table

Ignorer les valeurs NULL

(Facultatif)

Indique si les valeurs NULL (nulles) dans les champs de regroupement doivent être ignorées lors de la sélection.

Checked—Indique que les valeurs NULL (nulles) dans les champs de regroupement sont ignorées lors de la sélection.
Unchecked—Indique que les valeurs NULL (nulles) dans les champs de regroupement ne sont pas ignorées lors de la sélection. Il s’agit de l’option par défaut.

Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Enregistrements sélectionnés	Vue tabulaire utilisable dans d’autres outils de géotraitement qui acceptent une vue tabulaire dans ModelBuilder.	Table View
Valeur	Valeurs de champ renvoyées par chaque itération. Si plusieurs champs de regroupement sont spécifiés, les valeurs sont concaténées sous la forme <field value1>_<field value2>.	Variant

Environnements

Espace de travail courant

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui