Itérer la sélection d’entité (ModelBuilder)
Récapitulatif
Itère des entités dans une classe d'entités.
Pour en savoir plus sur le fonctionnement de l'outil Itérer la sélection d'entité 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 d'entité appelle l'outil Générer une couche pour effectuer une nouvelle sélection, puis crée deux sorties : les entités sélectionnées et une valeur. La sortie de l'outil Entités sélectionnées est une couche d'entités utilisable par d'autres outils de géotraitement qui prennent en charge les couches d'entités dans ModelBuilder.
-
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 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 nom de l'ouragan et la catégorie d'ouragan sont utilisés. La valeur en sortie est "Katrina_H5" 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. Si la table, telle qu'une table Excel, n'a pas de champ ObjectID (OID), la valeur est vierge.
-
L'outil génère deux sorties : les entités sélectionnées en sortie et la valeur de regroupement des champs pour les entités sélectionnées, qui peut être utilisée en tant que variable en ligne %Valeur% 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/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
| Paramètre | Explication | Type de données |
in_features |
Classe d'entités ou couche en entrée qui contient les entités à itérer. | Feature Layer |
fields [[Champ, Valeur Null],...] (Facultatif) |
Champ ou champs en entrée utilisés pour regrouper les entités 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. Si aucun champ n'est spécifié, l'OID permet d'itérer les entités. 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 le ou les champs de regroupement doivent être ignorées pendant la sélection.
| Boolean |