概要
テーブルの行を反復処理します。
使用法
このツールは、ModelBuilder で使用するためのツールで、Python スクリプトでは使用できません。
[行選択の反復 (Iterate Row Selection)] は [テーブル ビューの作成 (Make Table View)] を呼び出してテーブルのレコードを選択し、「選択行」と「値」の 2 つの出力を作成します。出力の「選択行」はテーブル ビューであり、ModelBuilder でテーブル ビューを入力として受け取る他のジオプロセシング ツールの入力として使用できます。
選択には、複数のグループ化フィールドを使用できます。複数のグループ化フィールドを選択した場合、反復処理の回数は、グループ化フィールドの一意の組み合わせの数によって決まります。各反復処理では、指定したグループ化フィールドの組み合わせに一致するレコード数によって、選択される出力フィーチャ レイヤーが決まります。複数のグループ化フィールドを選択した場合は、値が出力インライン変数名で <フィールド値 1>_<フィールド値 2> のように連結されます。次の例では、「犯罪タイプ」と「発生時間帯」の 2 つのグループ フィールドが使用されています。出力の「値」は、「破壊活動_午前」のようになります。
グループ化フィールドを選択しない場合、出力値は ObjectID フィールドでグループ化され、1 つの選択ごとに 1 つのレコードが使用されます。
ツールの出力は、「出力選択行」と、選択された行の [ObjectID] フィールドに含まれるグループの「値」の 2 つです。「値」は、他のツールでインライン変数(%値%) として使用できます。
反復子をモデルに追加すると、モデル内のすべてのツールが反復子の各値に対して反復処理されます。各反復値に対してモデル内の各ツールを実行したくない場合は、反復子だけを含むサブモデル (モデル内のモデル、またはネストされたモデル)を作成し、メイン モデルにモデル ツールとして追加します。
構文
IterateRowSelection(in_table, {fields}, {skip_nulls})
パラメーター | 説明 | データ タイプ |
in_table | 反復処理するレコードを含む入力テーブル。 | Table View |
fields [[Field, Null Value],...] (オプション) | 選択するレコードをグループ化するための入力フィールド。任意の数の入力フィールドを定義できます。フィールドの一意の組み合わせに基づいて、選択が行われます。 フィールドの Null 値を定義します。指定されていない場合、または Null 値をすべてスキップするオプションがオンになっていない場合、Null 値はデフォルトで選択に含まれます。デフォルト値は、文字列の場合は「""」、数値の場合は「0」です。 | Value Table |
skip_nulls (オプション) | グループ フィールドが Null 値であった場合に、選択中にフィールドをスキップするかどうかを決定します。
| Boolean |
環境
このツールは、ジオプロセシング環境を使用しません。
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい