Résumé
Itère les lignes d'une table.
Pour en savoir plus sur le fonctionnement de l'outil Itérer la sélection de ligne dans ModelBuilder
Utilisation
Cet outil est prévu uniquement pour une utilisation dans ModelBuilder et non dans des scripts Python.
L'outil Itérer la sélection de ligne appelle l'outil Générer une vue tabulaire pour sélectionner un enregistrement de table et génère deux sorties : les lignes sélectionnées et une valeur. Les lignes sélectionnées en sortie apparaissent en tant que vue tabulaire et peuvent être utilisées en tant qu'entrées pour d'autres outils de géotraitement qui prennent en charge les vues tabulaires en entrée dans ModelBuilder.
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 correspond à la combinaison de champs de regroupement donnée. Si plusieurs champs de regroupement sont choisis, les valeurs sont concaténées < valeur de champ 2 > _ < valeur de champ 2 > dans le nom de la variable en ligne en sortie. L'exemple ci-dessous comporte deux champs de regroupement : le type d'appel et la 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 choisi, la valeur en sortie est regroupée selon le champ ObjectID, et la sélection se compose d'un enregistrement par sélection.
L'outil génère deux sorties : les lignes sélectionnées en sortie et la valeur de regroupement du champ ObjectID pour les entités sélectionnées, qui peut être utilisée en tant que variable en ligne %Valeur% 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/modèle dans le modèle/modèle imbriqué qui contient uniquement l'itérateur et ajoutez-le comme un outil de modèle au modèle principal.
Syntaxe
arcpy.mb.IterateRowSelection(in_table, {fields}, {skip_nulls})| Paramètre | Explication | Type de données |
in_table | Table en entrée qui contient des enregistrements à itérer. | Table View |
fields [[Field, Null Value],...] (Facultatif) | Champ en entrée utilisé pour regrouper les enregistrements pour la sélection. Vous pouvez spécifier le nombre de champs que vous voulez. La sélection s'effectue alors sur la combinaison unique des champs. Définit la valeur Null pour le champ. Par défaut, les valeurs Null sont comprises dans la sélection, sauf si vous l'avez spécifié autrement ou si l'option permettant de les ignorer a été activée. La valeur par défaut est "" pour les chaînes et "0" pour les nombres. | Value Table |
skip_nulls (Facultatif) | Détermine si les valeurs Null dans les champs de regroupement doivent être ignorées pendant la sélection.
| Boolean |
Environnements
Cet outil n'utilise pas d’environnement de géotraitement.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui