Itérer dans une sélection d'entités (Outils de modèle)
Résumé
Itère des entités dans une classe d'entités.
En savoir plus sur le fonctionnement de l’outil Itérer sur une sélection 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 classes d'entités complexes telles que les annotations et les dimensions ne sont pas prises en charge par cet outil.
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 : le nom (NAME) et la catégorie (Category) de l’ouragan. La valeur en sortie est Katrina_H5, 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. Si la table n’a pas de champ Object ID (ID d’objet), un tableau Excel par exemple, la valeur est vide.
L’outil génère deux sorties, Selected Features (Entités sélectionnées) et Value (Valeur) de regroupement du champ des entités sélectionnées, qui peuvent être utilisées comme variable en ligne dans d’autres outils.
La couche d’entités temporaire peut être enregistrée en tant que fichier de couche à l’aide de l’outil Enregistrer dans un fichier de couche ou enregistrée en tant que nouvelle classe d’entités à l’aide de l’outil Copier des entités.
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
| Etiqueter | Explication | Type de données |
|---|---|---|
|
Entités en entrée |
Classe d’entités ou couche en entrée qui contient les entités à itérer. |
Feature Layer |
|
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 :
|
Value Table |
|
Ignorer les valeurs NULL (Facultatif) |
Indique si les valeurs NULL (nulles) dans le ou les champs de regroupement doivent être ignorées pendant la sélection.
|
Boolean |
Sortie dérivée
| Etiqueter | Explication | Type de données |
|---|---|---|
|
Entités sélectionnées |
Couche d’entités pouvant être utilisée dans d’autres outils de géotraitement qui acceptent une couche d’entité dans ModelBuilder. |
Feature Layer |
|
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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui