使用法
このツールは、ModelBuilder で使用するためのツールで、Python スクリプトでは使用できません。
アノテーションやディメンションなどの複雑なフィーチャクラスは、このツールではサポートされていません。
選択には、複数のグループ化フィールドを使用できます。複数のグループ化フィールドを選択した場合、反復処理の回数は、グループ化フィールドの一意の組み合わせの数によって決まります。各反復処理では、指定したグループ化フィールドの組み合わせに一致するレコード数によって、選択される出力フィーチャ レイヤーが決まります。複数のグループ化フィールドを選択した場合は、値が出力インライン変数名で <フィールド値 1>_<フィールド値 2> のように連結されます。次の例では、ハリケーンの名前 (「名前」) とカテゴリ (「カテゴリ」) の 2 つのグループ フィールドが使用されています。出力の「値」は、「Katrina_H5」のようになります。
グループ化フィールドを選択しない場合、出力値は Object ID フィールドでグループ化され、1 つの選択ごとに 1 つのレコードが使用されます。Excel のテーブルなど、テーブルに Object ID フィールドがない場合は、値が空になります。
ツールの出力は、[選択フィーチャ] と、選択されたフィーチャのフィールドに含まれるグループの [値] の 2 つです。[値] は、他のツールでインライン変数として使用できます。
テンポラリ フィーチャ レイヤーは、[レイヤー ファイルの保存 (Save To Layer File)] ツールを使用してレイヤー ファイルとして保存することも、あるいは [フィーチャのコピー (Copy Features)] ツールを使用して新しいフィーチャクラスとして保存することもできます。
反復子をモデルに追加すると、モデル内のすべてのツールが反復子の各値に対して反復処理されます。各反復値に対してモデル内の各ツールを実行したくない場合は、反復子だけを含むサブモデル (モデル内のモデル、またはネストされたモデル) を作成し、メイン モデルにモデル ツールとして追加します。
構文
arcpy.mb.IterateFeatureSelection(in_features, {fields}, {skip_nulls})| パラメーター | 説明 | データ タイプ |
in_features | 反復処理するフィーチャを含む入力フィーチャクラスまたはレイヤー。 | Feature Layer |
fields [fields,...] (オプション) | 選択するフィーチャをグループ化するための入力フィールド。任意の数の入力フィールドを定義できます。フィールドの一意の組み合わせに基づいて、選択が行われます。フィールドを指定しない場合は、Object ID を使用してフィーチャが反復処理されます。 | Value Table |
skip_nulls (オプション) | グループ フィールドの Null 値を選択中にスキップするかどうかを指定します。
| Boolean |
派生した出力
| 名前 | 説明 | データ タイプ |
| selection | ModelBuilder でフィーチャ レイヤーを処理できる他のジオプロセシング ツールの入力として使用できます。 | フィーチャ レイヤー |
| value | 各反復処理で返されるフィールド値。複数のグループ化フィールドを選択した場合、値は <フィールド値 1>_<フィールド値 2> のように連結されます。 | バリアント |
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい