Résumé
Itère les lignes d'une table.
Utilisation
Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts 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 sélectionnés, les valeurs sont concaténées sous la forme <valeur de champ1>_<valeur de champ2> dans le nom de la variable en ligne en sortie. L'exemple ci-dessous comporte deux champs de regroupement : 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 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 : Selected Rows (Enregistrements sélectionnés) et Value (Valeur) de regroupement du champ de l’identifiant d’objet des entités sélectionnées, qui peuvent être utilisées en tant que 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, modèle dans le modèle ou modèle imbriqué qui contient uniquement l’itérateur et ajoutez-le comme 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 qui contient des enregistrements à itérer. | Table View |
fields [fields,...] (Facultatif) | Un ou plusieurs champs en entrée permettant de regrouper les entités pour leur 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. | Value Table |
skip_nulls (Facultatif) | Spécifie si les valeurs nulles dans les champs de regroupement doivent être ignorées pendant la sélection.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
selection | Vue tabulaire utilisable dans d’autres outils de géotraitement qui acceptent une vue tabulaire dans ModelBuilder. | Vue tabulaire |
value | Valeurs de champ renvoyées par chaque itération. Si plusieurs champs de regroupement sont sélectionnés, les valeurs sont concaténées sous la forme <valeur de champ1>_<valeur de champ2>. | Variante |
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Vous avez un commentaire à formuler concernant cette rubrique ?