フィールドの反復 (Iterate Fields) (ModelBuilder)

サマリー

テーブルのフィールドを反復処理します。

ModelBuilder での [フィールドの反復 (Iterate Fields)] の動作の詳細

使用法

• このツールはモデルで使用する ModelBuilder リボンからのみ利用できます。 このツールは、[ジオプロセシング] ウィンドウまたは Python からは利用できません。

• [データ タイプ] および [ワイルドカード] パラメーターを使用して、反復処理を行うフィールドを制限することができます。

• [フィールド名] パラメーターが定義されていない場合、ツールはフィルター (指定されている場合) を考慮してフィールドを反復処理します。

• [フィールド名] パラメーターのフィールドが重複している場合は、ツールの実行時に無視されます。

• このツールの出力は、[値] と [個数] の 2 つです。他のツールでインライン変数 (たとえば、%値%) として使用できます。[値] 出力はフィールド タイプです。フィールド タイプの値を使用する他のツールで使用できます。[カウント] 出力は、ツールが反復処理するフィールドの合計数です。

• ジオメトリ フィールドは [データ タイプ] パラメーターのリストに含まれませんが、[フィールド名] パラメーターからフィールドにアクセスできます。

• [フィールド名] パラメーターのリストにフィールドがない場合、[値] 出力ではテーブルの最初のフィールドが使用されます。[フィールド名] パラメーターのリストにフィールドがない場合、[値] 出力では [フィールド名] パラメーターの最初のフィールドが使用されます。いずれも、最初のフィールドがジオメトリ フィールドの場合はスキップされます。

• [フィールド名] パラメーターのフィールドを更新するには、編集モードでテーブルを保存します。

• このツールは、結合テーブルの入力ができます。結合テーブルは、完全に修飾されたフィールド名を保持 する環境を考慮したフィールド名を生成します。

• このツールは、データベース接続からの入力ができます。

• 以下の問題が発生した場合は、[フィールド名] パラメーターの横にメッセージが表示されます。

  • フィールドがテーブルに存在しません。
  • フィールドが、指定した [データ タイプ] フィルターに一致しません。
  • フィールドが、指定した [ワールドカード] フィルターに一致しません。
  これらのメッセージは、[フィールドの反復 (Iterate Fields)] ツール ダイアログ ボックスには警告として、[フィールド名] 変数ダイアログ ボックスにはエラーとして表示されます。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力テーブル	反復処理するフィールドを含む入力テーブル。	Table View; Raster Layer; Mosaic Layer
フィールド タイプ (オプション)	フィールドのフィルタリングに使用するフィールド タイプを指定します。フィールド タイプが指定されていない場合は、サポートしているフィールド タイプのすべてのフィールドが反復処理されます。 Blob—BLOB フィールドが反復処理されます。 Date—日時フィールドが反復処理されます。 Double—数値 (double) フィールドが反復処理されます。 Float—数値 (float) フィールドが反復処理されます。 GUID—GUID フィールドが反復処理されます。 Long—数値 (long integer) フィールドが反復処理されます。 Raster—ラスター フィールドが反復処理されます。 Short—数値 (short integer) フィールドが反復処理されます。 Text—テキスト フィールドが反復処理されます。	String
ワイルドカード (オプション)	反復処理するフィールドを制限します。ワイルドカードは、フィールド名およびフィールドのエイリアスとして機能し、* およびその他の文字の組み合わせです。たとえば、このパラメーターを使用して、フィールドの名前やエイリアスが特定の文字や語句で始まる入力に限って反復処理することができます (A*、Ari*、Land* など)。アスタリスクを指定すると、すべてのフィールドが対象となります。ワイルドカードを指定しない場合は、すべての入力が返されます。	String
フィールド名 (オプション)	反復処理するフィールドのリスト。	Field

派生した出力

ラベル	説明	データ タイプ
値	各反復処理で返されるフィールド。	フィールド
個数	すべての反復処理の合計フィールド数。	Long

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes