ファイルの反復 (Iterate Files) (ModelBuilder)

概要

フォルダー内のファイルを反復処理します。

ModelBuilder での [ファイルの反復 (Iterate Files)] ツールの詳細

使用法

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

  • [ファイル拡張子] オプションを使用すると、指定した拡張子を持つファイルだけを反復処理できます。たとえば、拡張子が「.log」のファイルだけを反復処理する場合は、[ファイル拡張子] パラメーターに「log」を設定します。

  • ファイルが [カタログ] ウィンドウでデータセットとして表示される場合、[ファイルの反復 (Iterate Files)] はそのファイルをスキップします。最も一般的な例は、シェープ ファイル、*.dbf ファイル、ラスター ファイル (*.jpg、*.tif、*.img、*.png、*.bmp)、CAD ファイル (*.dxf、*.dwg)、およびマップ ファイル (*.mxd、*.aprx) です。

  • ツールの出力は、[出力ファイル][名前] の 2 つです。[名前] は、他のツールでインライン変数(たとえば、%名前%) として使用できます。

  • txt、pdf、zip などの拡張子に対して、オプションのパラメーターにファイル拡張子を指定します。たとえば、ツールがテキスト ファイルに対して反復処理を行い、その出力が [ASCII → ラスター (ASCII to Raster)] などのツールで使用される場合、オプションのファイル拡張子パラメーターに txt を指定します。

  • ほとんどのツールは、[ファイルの反復 (Iterate Files)] ツールから出力ファイル形式を取得しますが、[コピー (Copy)] などの一部のツールでは、出力名でファイル拡張子を定義する必要があります。たとえば、[ファイルの反復 (Iterate Files)] ツールを使用して「zip」ファイルを反復処理し、[コピー (Copy)] ツールの入力として使用する場合は、出力名に Name.zip または %名前%.zip のように拡張子を含める必要があります。

構文

arcpy.mb.IterateFiles(in_folder, {wildcard}, {extension}, {recursive})
パラメーター説明データ タイプ
in_folder

入力ファイルが保存されているフォルダー。

Folder
wildcard
(オプション)

結果を制限するために使用する、* (アスタリスク) と文字の組み合わせ。アスタリスクは「すべて」と同じ意味です。ワイルドカードを指定しない場合は、すべての値が返されます。たとえば、ワイルドカードを使用すると、名前が特定の文字や語句で始まる入力だけを反復処理できます (A*Ari*Land* など)。

String
extension
(オプション)

TXT や ZIP などのファイル拡張子。指定した拡張子を持つファイルだけが反復処理されます。ファイル拡張子の前には、ピリオドを付けません。

String
recursive
(オプション)

メイン フォルダー内のすべてのサブフォルダーを再帰的に反復処理するかどうかを決定します。

  • オン - すべてのサブフォルダーを反復処理します。
  • オフ - すべてのサブフォルダーを反復処理しません。
Boolean

派生した出力

名前説明データ タイプ
file

ファイルの絶対パス。

ファイル
name

データセットの名前。

文字列

環境

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

ライセンス情報

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