Layer iterieren (ModelBuilder)

Verwendung

  • Dieses Werkzeug ist nur für die Verwendung in ModelBuilder, nicht in Python-Skripten vorgesehen.

  • Wenn der Parameter Layer-Typ auf Tabellenansicht festgelegt wird, werden nur Standalone-Tabellen iteriert. Um mit Feature- oder Raster-Tabellen zu arbeiten, legen Sie den Parameter Layer-Typ jeweils auf Feature-Layer oder Raster-Layer fest.

  • Für jede Iteration gibt das Werkzeug die folgenden Ausgaben zurück:

    • Ausgabe-Layer: Der Layer der Karte basierend auf den Parameterfiltern, die festgelegt wurden. Dieser Layer schließt alle Auswahlen oder Verbindungen ein, die bereits für den Layer festgelegt wurden.
    • Name: Der Name des Layers. Der Name kann in der direkten Variablenersetzung verwendet werden.
    • Ausgabe-Layer-Typ: Typ des Layers. Dieser Wert entspricht den Layer-Typen, die mit dem Parameter Layer-Typ festgelegt wurden. Die Ausgabewerte sind Konstanten und werden nicht lokalisiert. Wenn mehrere Layer-Typen verwendet werden, kann der Typ für Verzweigungen in Modellen verwendet werden, wie nachfolgend gezeigt:
      Beispiel für das Verwenden der von einem Layer-Typ abgeleiteten Ausgabe
    • Workspace-Typ oder Formattyp: Workspace-Typ des Layers. Dieser Wert wird nur für Feature-Layer, Raster-Layer und Tabellenansichten zurückgegeben. Die Ausgabewerte sind Konstanten und werden nicht lokalisiert. Bei Raster-Layern, die im ordnerbasierten Workspace gespeichert werden, wird das Dateiformat zurückgegeben, z. B. TIFF, und dieser Wert kann für die Verzweigung eines Modells oder als Diagnose für die Auswertung des Layer-Typs, der iteriert wurde, verwendet werden.
      Beispiel für das Verwenden der von einem Workspace-Typ abgeleiteten Ausgabe

  • Das Werkzeug gibt Layer zurück, die dem Typ entsprechen, der mit dem Parameter Layer Typ festgelegt wurden, und den Filtern, die mit den Parametern Sichtbarkeit und Status festgelegt wurden. Beispiel: Wenn der Parameter Layer-Typ auf Feature-Layer und Raster-Layer, der Parameter Sichtbarkeit auf Nicht sichtbar und der Parameter Status auf Gültig festgelegt wird, gibt das Werkzeug Feature- und Raster-Layer zurück, die nicht sichtbar und gültig sind.

  • Wenn der Parameter Layer-Typ nicht festgelegt wurde oder wenn es keine Layer gibt, die den Parameterkriterien entsprechen, wird der Wert von Ausgabe-Layer auf OUTPUT_LAYER gesetzt, der Wert von Name und die Ausgaben von Ausgabe-Layer-Typ werden auf FEATURE_LAYER und die Ausgabe von Workspace-Typ oder Formattyp wird auf WORKSPACE gesetzt.

  • Der Parameter Layer-Typ kann auf mehrere Typen festgelegt werden, beispielsweise auf Feature-Layer, Raster-Layer und Tabellenansicht. Das Werkzeug kann jedoch mit Downstream-Werkzeugen wie Features kopieren, Raster kopieren oder Zeilen kopieren verbunden werden, die mit einigen Layer-Typen inkompatibel sein können. Um die Verwendung von mehreren Layer-Typen in diesem Szenario zu ermöglichen, muss der Parameter Layer-Typ auf einen einzigen bestimmten Layer-Typ festgelegt werden. Verbinden Sie dann die Ausgabe mit dem entsprechenden Werkzeug, das mit diesem bestimmten Datentyp funktioniert. Nachdem alle Downstream-Verbindungen erstellt wurden, können Sie den Parameter Layer-Typ auf alle drei Layer-Typen festlegen. Dieser Workflow ist notwendig, da die anfängliche Standardeinstellung für dieses Werkzeugs auf einen Feature-Layer-Typ festgelegt wird, der nicht mit den Werkzeugen kompatibel ist, die Raster als Eingabe verwenden. Nachdem alle Layer-Typen zum Modell hinzugefügt wurden, befinden sich die Werkzeuge nach der Validierung im gültigen Status.

Syntax

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

Die Eingabekarte mit den zu iterierenden Layern.

Map
wildcard
(optional)

Eine Kombination von * und Zeichen, die die Ergebnisse einschränken. Das Sternchen entspricht ALL. Wenn kein Platzhalter angegeben wird, werden alle Eingaben zurückgegeben. Dies kann z. B. verwendet werden, um die Iteration auf Eingabenamen einzuschränken, die mit einem bestimmten Zeichen oder Wort beginnen (z. B. A* oder Ari* oder Land* usw.).

String
layer_type
[layer_type,...]
(optional)

Gibt den Layer-Typ an, der zum Filtern der Layer verwendet wird. Wenn kein Layer-Typ angegeben wird, werden alle unterstützten Layer-Typen durchlaufen. Es können jeweils mehrere Layer-Typen zum Filtern der Layer verwendet werden.

  • AnnotationLayerAnnotations-Layer werden iteriert.
  • BuildingLayerGebäude-Layer werden iteriert.
  • BuildingSceneLayer Gebäude-Szenen-Layer werden iteriert.
  • DimensionLayerBemaßungs-Layer werden iteriert.
  • FeatureLayerFeature-Layer werden iteriert.
  • GALayerGeostatistical-Layer werden iteriert.
  • GroupLayerGruppen-Layer werden iteriert.
  • KMLLayerKML-Layer werden iteriert.
  • LASDatasetLayerLAS-Dataset-Layer werden iteriert.
  • MosaicLayerMosaik-Layer werden iteriert.
  • NALayerNetwork Analyst-Layer werden iteriert.
  • NetworkDatasetLayerNetzwerk-Dataset-Layer werden iteriert.
  • ParcelLayerFlurstück-Layer werden iteriert.
  • RasterLayerRaster-Layer werden iteriert.
  • SceneServiceLayerSzene-Service-Layer werden iteriert.
  • TableViewTabellenansichten werden iteriert.
  • TerrainLayerTerrain-Layer werden iteriert.
  • TinLayerTIN-Layer werden iteriert.
  • TopologyLayerTopologie-Layer werden iteriert.
  • TraceNetworkLayerVerfolgungsnetz-Layer werden iteriert.
  • UtilityNetworkLayerVersorgungsnetz-Layer werden iteriert.
  • VoxelLayerVoxel-Layer werden iteriert.
String
workspace_type
[workspace_type,...]

Gibt den Workspace-Typ an, der zum Filtern der Layer verwendet wird. Wenn kein Workspace-Typ angegeben wurde, werden alle Layer der unterstützten Workspace-Typen durchlaufen.

Der Parameter Workspace-Typ wird nur aktiviert, wenn der Parameter Layer-Typ auf Feature-Layer, Raster-Layer oder Tabellenansicht festgelegt wird.

  • BIG_DATA_CONNECTIONLayer in einem Big-Data-Verbindung-Workspace werden iteriert.
  • BIM_FILELayer in einem BIM-Datei-Workspace werden iteriert.
  • CADLayer in einem CAD-Workspace werden iteriert.
  • DELIMITED_TEXT_FILELayer in einem trennzeichengetrennten Textdatei-Workspace werden iteriert.
  • ENTERPRISE_GEODATABASELayer in einem Enterprise-Geodatabase-Workspace werden iteriert.
  • FEATURE_SERVICELayer in einem Feature-Service-Workspace werden iteriert.
  • FILE_GEODATABASELayer in einem File-Geodatabase-Workspace werden iteriert.
  • IN_MEMORY_DATABASELayer in einem In-Memory-Workspace werden iteriert.
  • MICROSOFT_EXCELLayer in einem Microsoft Excel-Workspace werden iteriert.
  • NETCDFLayer in einem NetCDF-Workspace werden iteriert.
  • OLEDBLayer in einem OLE-DB-Workspace werden iteriert.
  • RASTERLayer in einem Raster-Workspace werden iteriert.
  • SHAPEFILELayer in einem Shapefile-Workspace werden iteriert.
  • SQLITELayer in einem SQLite-Workspace werden iteriert.
  • SQL_QUERY_LAYERLayer in einem SQL-Abfrage-Layer-Workspace werden iteriert.
  • STREAM_SERVICELayer in einem Stream-Service-Workspace werden iteriert.
  • WEB_FEATURE_SERVICELayer in einem Web-Feature-Workspace werden iteriert.
String
feature_type
[feature_type,...]
(optional)

Gibt den Feature-Typ an, der zum Filtern der Layer verwendet wird. Wenn kein Feature-Typ angegeben wird, werden alle unterstützten Feature-Typen durchlaufen.

  • ANNOTATIONAnnotation-Feature-Classes werden iteriert.
  • DIMENSIONDimension-Feature-Classes werden iteriert.
  • SIMPLE_EDGEEinfache Edge-Feature-Classes werden iteriert.
  • COMPLEX_EDGEKomplexe Edge-Feature-Classes werden iteriert.
  • SIMPLE_JUNCTIONEinfache Junction-Feature-Classes werden iteriert.
  • COMPLEX_JUNCTIONKomplexe Junction-Feature-Classes werden iteriert.
  • LINELine-Feature-Classes werden iteriert.
  • POINTPoint-Feature-Classes werden iteriert.
  • POLYGONPolygon-Feature-Classes werden iteriert.
  • MULTIPATCHMultipatch-Feature-Classes werden iteriert.
String
raster_format_type
[raster_format_type,...]
(optional)

Der Rasterformattyp wird verwendet, um die Raster-Layer zu filtern, wenn der Parameter Workspace-Typ auf Raster gesetzt wird. Wenn kein Raster-Typ angegeben wurde, werden alle Layer der unterstützten Raster-Typen durchlaufen.

String
layer_visibility
(optional)

Gibt an, ob die Layer-Sichtbarkeit für das Filtern der Layer verwendet wird. Wird die Sichtbarkeit nicht angegeben, werden alle Layer iteriert.

  • VISIBLEDie Layer-Sichtbarkeit wird verwendet, um die Layer zu filtern, und die sichtbaren Layer werden iteriert.
  • NOT_VISIBLEDie Layer-Sichtbarkeit wird nicht verwendet, um die Layer zu filtern, und die nicht sichtbaren Layer werden iteriert.
String
layer_state
(optional)

Gibt den Layer-Status an, der zum Filtern der Layer verwendet wird. Layer mit ungültigen Quellpfad-Layern werden zurückgegeben, wenn der Parameter auf "ungültig" gesetzt wird. Wird ein Layer-Status nicht angegeben, werden alle Layer iteriert.

  • VALIDGültige Layer werden iteriert.
  • INVALIDUngültige Layer werden iteriert.
String
recursive
(optional)

Gibt an, ob der Iterator geschachtelte Gruppen-Layer iteriert.

  • Aktiviert: Geschachtelte Gruppen-Layer werden iteriert.
  • Nicht aktiviert: Geschachtelte Gruppen-Layer werden nicht iteriert.
Boolean

Abgeleitete Ausgabe

NameErklärungDatentyp
output_layer

Der Layer der Karte basierend auf den Parameterfiltern, die festgelegt wurden. Dieser Layer schließt alle Auswahlen oder Verbindungen ein, die bereits für den Layer festgelegt wurden.

Beliebiger Wert
output_name

Der Name des Layers.

Zeichenfolge
output_layer_type

Der Typ des Layers.

Zeichenfolge
output_workspace_type

Der Workspace-Typ des Layers.

Zeichenfolge

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja