使用法
このツールは、ModelBuilder で使用するためのツールで、Python スクリプトでは使用できません。
[レイヤー タイプ] パラメーターが [テーブル ビュー] に設定されていると、スタンドアロンのテーブルのみが反復処理されます。フィーチャ テーブルまたはラスター テーブルで作業するには、[レイヤー タイプ] パラメーターを [フィーチャ レイヤー] または [ラスター レイヤー] に設定します。
各反復処理では、ツールは次の出力を返します。
- 出力レイヤー - マップのレイヤーで、設定されているパラメーター フィルターに基づきます。このレイヤーには、レイヤーですでに設定されている選択内容と結合が含まれます。
- 名前 - レイヤーの名前。この名前は、インライン変数置換で使用できます。
- 出力レイヤー タイプ - レイヤーのタイプ。この値は、[レイヤー タイプ] パラメーターで設定されたレイヤーのタイプに合致します。出力値は定数で、ローカライズできません。2 つ以上のレイヤー タイプが使用される場合、タイプを使用して下に示すように、モデルを分割できます。
- [ワークスペースまたは形式タイプ] - レイヤーのワークスペース タイプ。この値は、フィーチャ レイヤー、ラスター レイヤー、テーブル ビューでのみ返されます。出力値は定数で、ローカライズできません。フォルダーベースのワークスペースに格納されたラスター レイヤーの場合、ファイル形式が解されます (たとえば TIFF )。この値を使用してモデルを分割したり、診断として使用して反復処理されたレイヤー タイプを評価することができます。
ツールは、[レイヤー タイプ] パラメーターで設定されたタイプと、[表示設定] パラメーターおよび [状態] パラメーターで設定されたフィルターと合致するレイヤーを返します。たとえば、[レイヤー タイプ] パラメーターが [フィーチャ レイヤー] と [ラスター レイヤー] に、[表示設定] パラメーターが [非表示] に、そして [状態] パラメーターが [有効] に設定されている場合、ツールは、表示されておらず有効でないフィーチャ レイヤーとラスター レイヤーを返します。
[レイヤー タイプ] パラメーターが設定されていない、またはパラメーター基準に合致するレイヤーがない場合、[出力レイヤー] は [OUTPUT_LAYER] に設定され、[名前] の値、[出力レイヤー タイプ] の出力は [FEATURE_LAYER] に設定され、そして、[ワークスペースまたは形式タイプ] の出力は [WORKSPACE] に設定されます。
[レイヤー タイプ] パラメーターは、複数のタイプに設定できます。たとえば、[フィーチャ レイヤー]、[ラスター レイヤー]、[テーブル ビュー] などです。ただし、ツールを [フィーチャのコピー (Copy Features)]、[ラスターのコピー (Copy Raster)]、[行のコピー (Copy Rows)] などの下流のツールに接続できます。複数のレイヤー タイプをこのシナリオでサポートするには、[レイヤー タイプ] パラメーターを 1 つの特定のレイヤー タイプに設定する必要があります。次に、出力を対応するツール (特定のデータ タイプで動作するもの) に接続します。すべての下流の接続を行った後、3 つすべてのレイヤー タイプに[レイヤー タイプ] パラメーターを設定できます。ツールの開始時のデフォルトはフィーチャ レイヤー タイプに設定されており、ラスターを入力として考慮するツールとは互換性がないため、このワークフローが必要です。すべてのレイヤー タイプがモデルに追加されたら、整合チェックにより、ツールは有効な状態になります。
構文
arcpy.mb.IterateLayers(input_map, {wildcard}, {layer_type}, workspace_type, {feature_type}, {raster_format_type}, {layer_visibility}, {layer_state}, {recursive})
パラメーター | 説明 | データ タイプ |
input_map | 反復処理するレイヤーを持つ入力マップ。 | Map |
wildcard (オプション) | 結果を制限するために使用する、* (アスタリスク) と文字の組み合わせ。アスタリスクは「すべて」と同じ意味です。ワイルドカードを指定しない場合は、すべての値が返されます。たとえば、ワイルドカードを使用すると、名前が特定の文字や語句で始まる入力だけを反復処理できます (A*、Ari*、Land* など)。 | String |
layer_type [layer_type,...] (オプション) | レイヤーのフィルタリングに使用するレイヤー タイプを指定します。レイヤー タイプが指定されていない場合は、サポートしているすべてのレイヤー タイプが反復処理されます。複数のレイヤー タイプ使用して、レイヤーをフィルタリングできます。
| String |
workspace_type [workspace_type,...] | レイヤーのフィルタリングに使用するワークスペース タイプを指定します。ワークスペース タイプが指定されていない場合は、サポートしているワークスペース タイプのすべてのレイヤーが反復処理されます。 [ワークスペース タイプ] パラメーターは、[レイヤー タイプ] パラメーターが [フィーチャ レイヤー]、[ラスター レイヤー] または [テーブル ビュー] に設定されている場合のみ有効です。
| String |
feature_type [feature_type,...] (オプション) | レイヤーのフィルタリングに使用するフィーチャ タイプを指定します。フィーチャ タイプが指定されていない場合は、サポートしているすべてのフィーチャ タイプが反復処理されます。
| String |
raster_format_type [raster_format_type,...] (オプション) | [ワークスペース タイプ] パラメーターが [ラスター] に設定されているときに、ラスター レイヤーのフィルタリングに使用されるラスター形式タイプ。ラスター タイプが指定されていない場合は、サポートしているラスター タイプのすべてのレイヤーが反復処理されます。 | String |
layer_visibility (オプション) | レイヤーのフィルタリングにレイヤー表示設定を使用するかどうかを指定します。レイヤーの表示設定が指定されていない場合は、すべてのレイヤーが反復処理されます。
| String |
layer_state (オプション) | レイヤーのフィルタリングに使用するレイヤー状態を指定します。パラメーターが無効に設定されていると、ソース パス レイヤーが分割されているレイヤーが返されます。レイヤーの状態が指定されていない場合は、すべてのレイヤーが反復処理されます。
| String |
recursive (オプション) | 反復子がネストされたグループ レイヤーを反復処理するかどうかを指定します。
| Boolean |
派生した出力
名前 | 説明 | データ タイプ |
output_layer | マップのレイヤーで、設定されているパラメーター フィルターに基づきます。このレイヤーには、レイヤーですでに設定されている選択内容と結合が含まれます。 | 任意の値 |
output_name | レイヤーの名前。 | 文字列 |
output_layer_type | レイヤーのタイプ。 | 文字列 |
output_workspace_type | レイヤーのワークスペース タイプ。 | 文字列 |
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい