フィールド値の反復 (Iterate Field Values) (ModelBuilder)

概要

フィールド内の各値を反復処理します。

ModelBuilder での [フィールド値の反復 (Iterate Field Value)] の動作

使用法

• このツールは、ModelBuilder で使用するためのツールで、Python スクリプトでは使用できません。

• ツールの出力は「値」という名前の変数で、フィールドの値を含んでいます。この変数は、インライン変数置換 (%値%) で使用できます。

• [データ タイプ] パラメーターは、出力変数のデータ タイプを指定します。デフォルトのデータ タイプは文字列ですが、モデルでの出力の使用方法に応じて別のデータ タイプを指定できます。たとえば、フィールドにフィーチャクラスのパスが含まれている場合は、[データ タイプ] パラメーターを [フィーチャクラス] に設定して、フィーチャクラスを受け取るツールの入力として出力変数を使用できます。

• 反復子をモデルに追加すると、モデル内のすべてのツールが反復子の各値に対して反復処理されます。各反復値に対してモデル内の各ツールを実行したくない場合は、反復子だけを含むサブモデル (モデル内のモデル、またはネストされたモデル) を作成し、メイン モデルにモデル ツールとして追加します。

構文

arcpy.mb.IterateFieldValues(in_table, field, {data_type}, {unique_values}, {skip_nulls}, {null_value})

パラメーター	説明	データ タイプ
in_table	反復処理する入力テーブル。	Table View; Raster Layer
field	反復の対象となる入力フィールド。	Field
data_type (オプション)	出力値のデータ タイプを指定します。デフォルトのデータ タイプは文字列ですが、モデルでの出力の使用方法に応じて別のデータ タイプを指定できます。たとえば、フィールドにフィーチャクラスのパスが含まれている場合は、このパラメーターを [フィーチャクラス] に設定して、フィーチャクラスを受け取るツールの入力として出力変数を使用できます。 Address Locator —住所ロケーター Address Locator Style —住所ロケーターのスタイル Analysis Cell Size —セル サイズの解析 Annotation Layer —アノテーション レイヤー Any Value —任意の値 ArcMap Document —ArcMap ドキュメント Areal Unit —面積単位 BIM File Workspace —BIM ファイル ワークスペース Boolean —Boolean Building Discipline Layer —ビルディング分野レイヤー Building Discipline Scene Layer —ビルディング分野シーン レイヤー Building Layer —ビルディング レイヤー Building Scene Layer —ビルディング シーン レイヤー CAD Drawing Dataset —CAD ドローイング データセット Calculator Expression —演算式 Catalog Root —カタログ ルート Cell Size —セル サイズ Cell Size XY —セル サイズ XY Composite Layer —コンポジット レイヤー Compression —圧縮 Coordinate System —座標系 Coordinate Systems Folder —座標系フォルダー Coverage —カバレッジ Coverage Feature Class —カバレッジ フィーチャクラス Data Element —データ エレメント Data File —データ ファイル Database Connections —データベース コネクション Dataset —データセット Date —日付 dBASE Table —dBase テーブル Decimate —単純化 Diagram Layer —ダイアグラム レイヤー Dimension Layer —ディメンション レイヤー Disk Connection —ディスク接続 Double —Double Elevation Surface Layer —標高サーフェス レイヤー Encrypted String —暗号化された文字列 Envelope —エンベロープ Evaluation Scale —評価尺度 Extent —範囲 Extract Values —抽出値 Feature Class —フィーチャクラス Feature Dataset —フィーチャ データセット Feature Layer —フィーチャ レイヤー Feature Set —フィーチャ セット Field —フィールド Field Info —フィールド情報 Field Mappings —フィールド マッピング File —ファイル Folder —フォルダー Formulated Raster —構築されたラスター Fuzzy function —ファジー関数 GeoDataServer —GeoDataServer Geodataset —ジオデータセット Geometric Network —ジオメトリック ネットワーク Geostatistical Layer —Geostatistical レイヤー Geostatistical Search Neighborhood —Geostatistical Search Neighborhood Geostatistical Value Table —Geostatistical 値テーブル GlobeServer —GlobeServer GPServer —GPServer Graph —グラフ Graph Data Table —グラフ データ テーブル Group Layer —グループ レイヤー Horizontal Factor —水平方向ファクター Image Service —イメージ サービス Index —インデックス INFO Expression —INFO 式 INFO Item —INFO アイテム INFO Table —INFO テーブル Internet Tiled Layer —インターネット タイル レイヤー KML Layer —KML レイヤー LAS Dataset —LAS データセット LAS Dataset Layer —LAS データセット レイヤー Layer —レイヤー Layer File —レイヤー ファイル Layout —レイアウト Line —ライン Linear Unit —距離単位 Long —Long M Domain —M ドメイン Map —マップ Map Server Layer —マップ サービス レイヤー MapServer —MapServer Mosaic Dataset —モザイク データセット Mosaic Layer —モザイク レイヤー Neighborhood —近傍 Network Analyst Class FieldMap —Network Analyst クラス フィールド マップ Network Analyst Hierarchy Settings —Network Analyst 階層の設定 Network Analyst Layer —Network Analyst レイヤー Network Data Source —ネットワーク データ ソース Network Dataset —ネットワーク データセット Network Dataset Layer —ネットワーク データセット レイヤー Network Travel Mode —ネットワーク移動モード Parcel Fabric —パーセル ファブリック Parcel Fabric for ArcMap —ArcMap のパーセル ファブリック Parcel Fabric Layer for ArcMap —ArcMap のパーセル ファブリック レイヤー Parcel Layer —パーセル レイヤー Point —ポイント Polygon —ポリゴン Projection File —投影情報ファイル Pyramid —ピラミッド Radius —半径 Random Number Generator —乱数ジェネレーター Raster Band —ラスター バンド Raster Calculator Expression —ラスター演算式 Raster Catalog —ラスター カタログ Raster Catalog Layer —ラスター カタログ レイヤー Raster Data Layer —ラスター データ レイヤー Raster Dataset —ラスター データセット Raster Layer —ラスター レイヤー Raster Statistics —ラスターの統計情報 Raster Type —ラスター タイプ Record Set —レコード セット Relationship Class —リレーションシップ クラス Remap —リマップ Report —レポート Route Measure Event Properties —ルート メジャー イベント プロパティ Scene Layer —シーン レイヤー Semivariogram —セミバリオグラム ServerConnection —サーバー コネクション Shapefile —シェープファイル Spatial Reference —空間参照 SQL Expression —SQL 式 String —String String Hidden —文字列非表示 Table —テーブル Table View —テーブル ビュー Terrain Layer —テレイン レイヤー Text File —テキスト ファイル Tile Size —タイル サイズ Time configuration —時間設定 Time Unit —時間単位 TIN —TIN TIN Layer —TIN レイヤー Tool —ツール Toolbox —ツールボックス Topo Features —トポ フィーチャ Topology —トポロジ Topology Layer —トポロジ レイヤー Trace Network —トレース ネットワーク Trace Network Layer —トレース ネットワーク レイヤー Transformation function —変換関数 Utility Network —ユーティリティ ネットワーク Utility Network Layer —ユーティリティ ネットワーク レイヤー Variant —Variant Vector Tile Layer —ベクター タイル レイヤー Vertical Factor —垂直方向ファクター Voxel Layer —ボクセル レイヤー VPF Coverage —VPF カバレッジ VPF Table —VPF テーブル WCS Coverage —WCS カバレッジ Weighted Overlay Table —加重オーバーレイ テーブル Weighted Sum —加重合計 WMS Map —WMS マップ Workspace —ワークスペース XY Domain —XY ドメイン Z Domain —Z ドメイン	String
unique_values (オプション)	反復値を一意の値にするかどうかを指定します。 オン - 反復値は指定したフィールドの一意の値になります。 オフ - 入力テーブルの各レコードが反復処理されます。	Boolean
skip_nulls (オプション)	フィールドの Null 値をスキップするかどうかを指定します。 オン - 選択中にフィールド内の NULL 値をスキップします。 オフ - 選択中にフィールド内の NULL 値をスキップしません。	Boolean
null_value (オプション)	スキップする Null 値 (-9999、Null、-1 など)。デフォルト値は、文字列の場合は「""」、数値の場合は「0」です。	String

派生した出力

名前	説明	データ タイプ
value	各反復処理で返されるフィールド値。	任意の値

環境

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

ライセンス情報

• Basic: はい
• Standard: はい
• Advanced: はい