Itérer les couches (ModelBuilder)

Résumé

Itère les couches dans une carte.

Pour en savoir plus sur le fonctionnement de l’outil Itérer les couches dans ModelBuilder

Utilisation

• Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts Python.

• Lorsque le paramètre Layer Type (Type de couche) est défini sur Table View (Vue tabulaire), seules les tables autonomes sont itérées. Pour utiliser des tables raster ou d’entités, définissez le paramètre Layer Type (Type de couche) sur Feature Layer (Couche d’entités) ou Raster Layer (Couche raster), respectivement.

• Pour chaque itération, l’outil renvoie les sorties suivantes :

  • Output Layer (Couche en sortie) : la couche de la carte en fonction des filtres de paramètre qui ont été définis. Cette couche inclut toutes les sélections ou jointures déjà définies dans la couche.
  • Name (Nom) : le nom de la couche. Le nom peut être utilisé dans la substitution de variable en ligne.
  • Output Layer Type (Type de couche en sortie) : le type de couche. Cette valeur correspond aux types de couches définis avec le paramètre Layer Type (Type de couche). Les valeurs en sortie sont constantes et non localisées. Si deux types de couches ou plus sont utilisés, le type peut servir à diviser un modèle comme suit :

    

  • Workspace or Format Type (Type d’espace de travail ou de format) : type d’espace de travail de la couche. Cette valeur est uniquement renvoyée pour les couches d’entités, les couches raster et les vues tabulaires. Les valeurs en sortie sont constantes et non localisées. Pour les couches raster qui sont stockées dans l’espace de travail basé sur des dossiers, le format de fichier est renvoyé (par exemple TIFF) et cette valeur peut servir à diviser un modèle ou comme diagnostic pour évaluer le type de couche qui a fait l’objet d’une itération.

    

• L’outil renvoie les couches qui correspondent au type défini avec le paramètre Layer Type (Type de couche) et aux filtres définis avec les paramètres Visibility (Visibilité) et State (États). Par exemple, si le paramètre Layer Type (Type de couche) est défini sur Feature Layer (Couche d’entités) et Raster Layer (Couche raster), le paramètre Visibilty (Visibilité) sur Not Visible (Non visible) et le paramètre State (État) sur Valid (Valide), l’outil renvoie les couches d’entités et raster qui sont à la fois invisibles et valides.

• Si le paramètre Layer Type (Type de couche) n’est pas défini ou si aucune couche ne correspond aux critères, la valeur du paramètre Output Layer (Couche en sortie) est définie sur OUTPUT_LAYER, la valeur du paramètre Name (Nom) et les sorties Output Layer Type (Type de couche en sortie) sont définies sur FEATURE_LAYER, et la sortie Workspace or Format Type (Type d’espace de travail ou de format) est définie sur WORKSPACE.

• Le paramètre Layer Type (Type de couche) peut être défini sur plusieurs types, par exemple Feature Layer (Couche d’entités), Raster Layer (Couche raster) et Table View (Vue tabulaire). Vous pouvez toutefois connecter l’outil à d’autres outils en aval tels que Copier des entités, Copy Raster (Copie raster) ou Copier des lignes qui peuvent être incompatibles avec certains types de couches. Pour prendre en charge plusieurs types de couches dans ce scénario, le paramètre Layer Type (Type de couche) doit être défini sur un type type de couche spécifique. Connectez ensuite la sortie à l’outil correspondant qui fonctionne avec ce type de couche précis. Une fois toutes les connexions en aval établies, vous pouvez définir le paramètre Layer Type (Type de couche) sur les trois types de couches. Ce processus est nécessaire car par défaut, l’outil commence avec un type de couche d’entités qui n’est pas compatible avec les outils qui utilisent les couches raster en entrée. Une fois tous les types de couches ajoutés au modèle, la validation laisse les outils dans leur état valide.

Syntaxe

arcpy.mb.IterateLayers(input_map, {wildcard}, {layer_type}, workspace_type, {feature_type}, {raster_format_type}, {layer_visibility}, {layer_state}, {recursive})

Paramètre	Explication	Type de données
input_map	La carte en entrée avec les couches à itérer.	Map
wildcard (Facultatif)	Combinaison de * et d’autres caractères pour limiter les résultats. L'astérisque revient au même que d'indiquer ALL. Si aucun caractère générique n'est spécifié, toutes les entrées sont renvoyées. Par exemple, il peut permettre de restreindre l’itération de noms en entrée qui commencent par un caractère ou un mot donné (par exemple, A* ou Ari* ou Land* et ainsi de suite).	String
layer_type [layer_type,...] (Facultatif)	Indique le type de couche utilisée pour filtrer les couches. Si aucun type de couche n’est spécifié, tous les types de couches pris en charge seront itérés. Plusieurs types de couches peuvent être utilisés pour filtrer les couches. AnnotationLayer —Les couches d’annotation seront itérées. BuildingLayer —Les couches de bâtiment seront itérées. BuildingSceneLayer — Les couches de scène de bâtiment seront itérées. DimensionLayer —Les couches de dimension seront itérées. FeatureLayer —Les couches d’entités seront itérées. GALayer —Les couches géostatistiques seront itérées. GroupLayer —Les groupes de couches seront itérés. KMLLayer —Les couches KML seront itérées. LASDatasetLayer —Les couches de jeu de données LAS seront itérées. MosaicLayer —Les couches de mosaïque seront itérées. NALayer —Les couches Network Analyst seront itérées. NetworkDatasetLayer —Les couches de jeux de données réseau seront itérées. ParcelLayer —Les couches de parcelle seront itérées. RasterLayer —Les couches raster seront itérées. SceneServiceLayer —Les couches de service de scène seront itérées. TableView —Les vues tabulaires seront itérées. TerrainLayer —Les couches de terrain seront itérées. TinLayer —Les couches TIN seront itérées. TopologyLayer —Les couches de topologie seront itérées. TraceNetworkLayer —Les couches de réseau de traces seront itérées. UtilityNetworkLayer —Les couches de réseau de distribution seront itérées. VoxelLayer —Les couches de voxel seront itérées.	String
workspace_type [workspace_type,...]	Indique le type d’espace de travail utilisé pour filtrer les couches. Si aucun type d’espace de travail n’est spécifié, toutes les couches des types d’espace de travail pris en charge seront itérées. Le paramètre Workspace Type (Type d’espace de travail) est actif uniquement lorsque le paramètre Layer Type (Type de couche) est défini sur Feature Layer (Couche d’entités), Raster Layer (Couche raster) ou Table View (Vue tabulaire). BIG_DATA_CONNECTION —Les couches dans un espace de travail de connexion Big Data seront itérées. BIM_FILE —Les couches dans un espace de travail de fichier BIM seront itérées. CAD —Les couches dans un espace de travail DAO seront itérées. DELIMITED_TEXT_FILE —Les couches dans un espace de travail de fichier texte délimité seront itérées. ENTERPRISE_GEODATABASE —Les couches dans un espace de travail de géodatabase d’entreprise seront itérées. FEATURE_SERVICE —Les couches dans un espace de travail de service d’entités seront itérées. FILE_GEODATABASE —Les couches dans un espace de travail de géodatabase fichier seront itérées. IN_MEMORY_DATABASE —Les couches dans un espace de travail de base de données en mémoire seront itérées. MICROSOFT_EXCEL —Les couches dans un espace de travail Microsoft Excel seront itérées. NETCDF —Les couches dans un espace de travail NetCDF seront itérées. OLEDB —Les couches dans un espace de travail OLE BD seront itérées. RASTER —Les couches dans un espace de travail raster seront itérées. SHAPEFILE —Les couches dans un espace de travail de shapefile seront itérées. SQLITE —Les couches dans un espace de travail SQLite seront itérées. SQL_QUERY_LAYER —Les couches dans un espace de travail de couche de requête SQL seront itérées. STREAM_SERVICE —Les couches dans un espace de travail de service en mode continu seront itérées. WEB_FEATURE_SERVICE —Les couches dans un espace de travail de service d’entités Web seront itérées.	String
feature_type [feature_type,...] (Facultatif)	Indique le type d’entité utilisé pour filtrer les couches. Si aucun type d’entité n’est spécifié, tous les types d’entités pris en charge seront itérés. ANNOTATION —Les classes d’entités annotations seront itérées. DIMENSION —Les classes d’entités de cotations seront itérées. SIMPLE_EDGE —Les classes d’entités à un seul tronçon seront itérées. COMPLEX_EDGE —Les classes d’entités à tronçon complexe seront itérées. SIMPLE_JUNCTION —Les classes d’entités à une seule jonction seront itérées. COMPLEX_JUNCTION —Les classes d’entités à jonction complexe seront itérées. LINE —Les classes d’entités linéaires seront itérées. POINT —Les classes d’entités ponctuelles seront itérées. POLYGON —Les classes d’entités surfaciques seront itérées. MULTIPATCH —Les classes d’entités multipatch seront itérées.	String
raster_format_type [raster_format_type,...] (Facultatif)	Le type de format raster utilisé pour filtrer les couches raster lorsque le paramètre Workspace Type (Type d’espace de travail) est défini sur Raster. Si aucun type raster n’est spécifié, toutes les couches des types raster prises en charge seront itérées.	String
layer_visibility (Facultatif)	Indique le type de couche utilisé pour filtrer les couches. Si la visibilité des couches n’est spécifiée, toutes les couches seront itérées. VISIBLE —La visibilité des couches sera utilisée pour filtrer les couches et les couches visibles seront itérées. NOT_VISIBLE —La visibilité des couches ne sera pas utilisée pour filtrer les couches et les couches non visibles seront itérées.	String
layer_state (Facultatif)	Indique l’état de la couche qui sera utilisé pour filtrer les couches. Les couches dont le chemin d’accès source est endommagé sont renvoyées si le paramètre est défini comme non valide. Si l’état des couches n’est spécifiée, toutes les couches seront itérées. VALID —Les couches valides seront itérées. INVALID —Les couches non valides seront itérées.	String
recursive (Facultatif)	Indique si l’itérateur va itérer les groupes de couches imbriqués. Activé : les groupes de couches imbriqués seront itérés. Désactivé : les groupes de couches imbriqués ne seront pas itérés.	Boolean

Sortie dérivée

Nom	Explication	Type de données
output_layer	La couche de la carte en fonction des filtres de paramètre qui ont été définis. Cette couche inclut toutes les sélections ou jointures déjà définies dans la couche.	Toute valeur
output_name	Le nom de la couche.	Chaîne
output_layer_type	Le type de la couche.	Chaîne
output_workspace_type	Le type d’espace de travail de la couche.	Chaîne

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui