---
schema_version: "1"
id: 4b66835db0db86393a23a346eb1153f38aa62ead5d8cda7cf761235a78b6a7e3
title: File Controlled Loop
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/rpa-builder/6.4/toolbox-flow-control-file-controlled-loop.md
canonical_url: https://docs.mulesoft.com/jp/rpa-builder/6.4/toolbox-flow-control-file-controlled-loop
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 5e726da6fdf0a0a387ab976da862b3d2fa37ad743244b1ad05a046253e0a0497
description: MuleSoft Documentation Site
release: "6.4"
latest: false
---
# File Controlled Loop

この ​_File Controlled Loop_​ は、CSV ファイルからデータを読み取り、各列が 1 つの変数を表すように、データを変数として利用できるようにします。実行中、 ​_File Controlled Loop_​ は各データ行を反復処理し、すべてのコンテンツを行ごとに個別に実行します。

すべての行の列が選択されている区切り文字で区切られ、すべての行の列数が同じであり、有効で正しい形式の CSV ファイルを使用していることを確認してください。RPA Builder では、以前のバージョンで作成された既存のワークフローを変換する際に、区切り文字としてセミコロン ​`(;)`​ を選択します。ファイルの形式が正しくないと、​_File Controlled Loop_​ はファイルを読み込むことができません。

ファイルの最初の行はヘッダー行とみなされます。 _File Controlled Loop_​ は、これらのヘッダーを変数名として使用し、実際の変数値としては使用しません。

## [](#プロパティ)プロパティ

- **External File (外部ファイル)**
    
    - **Import Filename (インポートファイル名)**​
        
        インポートするファイルのフルパス。
    - **Relative to 3rd Party Folder (サードパーティフォルダーに対して相対的)**​
        
        読み込むファイルのパスが​_サードパーティ_​フォルダーへの相対パスであるかどうかを指定します。
    - **Separation character (区切り文字)**
        
        CSV ファイルを読み込む際に、列の区切り文字として使用する文字を指定します。
    - **Shuffle (入れ替え)**​
        
        実行中にデータ行を入れ替えます。
- **Miscellaneous (その他)**
    
    - **Iteration Count (反復回数)**​
        
        **\[Limit iterations (反復を制限)\]**​ が選択されている場合、このプロパティはループの 最大反復回数を指定します。ファイルが実行時にインポートされる場合のみ適用されます。
    - **Limit iterations (反復を制限)**​
        
        反復回数を制限するかどうかを決定します。

ファイルが実行時にインポートされる場合のみ適用されます。 **\* \*Separate File Path for Execution (実行用の別のファイルパス)**​

\+ **\[Use separate File Path for Execution (実行で別のファイルパスを使用)\]**​ が選択されている場合、​_File Controlled Loop_​ は ​**\[Import Filename (インポートファイル名)\]**​ で指定されたパスではなく、このパスからファイルを読み込みます。ファイルが実行時にインポートされる場合のみ適用されます。 **\* \*Use separate File Path for Execution (実行で別のファイルパスを使用)**​

\+ 実行中に異なるパスからファイルを読み込むには、この設定を選択します。ネットワークの場所からファイルを読み取る場合に役立ちます。ファイルが実行時にインポートされる場合のみ適用されます。 **\* \*Use type string only (文字列型のみを使用)**​

\+ 実行時にすべてのデータを String 型に変換します。ウィザードでは、データを列ごとに変換できます。

## [](#インバウンド変数)インバウンド変数

File Controlled Loop アクションステップにはインバウンド変数はありません。

## [](#アウトバウンド変数)アウトバウンド変数

_File Controlled Loop_​内のアクションステップは、各列のコンテンツを 変数として返します。

変数の名前は、​`<アクションステップ名>.<列名>`​ のパターンに従います。

## [](#ウィザード)ウィザード

ウィザードでは、ファイルを実行開始時と実行中のどちらのタイミングでインポートするかや、区切り文字、ドキュメントのエンコード (日本語対応のシフト JIS および EUC-JP を含む) を選択できます。

選択した読み取りモードによって、ウィザードが変わります。この 2 つのモードの主な違いは、設計時にファイルをインポートする場合、タイマー内で変数を使用でき、データが固定されることです。実行中にファイルをインポートする場合は、ネットワークを含むどの場所からでも ファイルを読み込むことができ、​_ワークフロー_​をまったく変更せずにデータを変更することができます (ただし、 タイマー名では変数を使用できません)。

2 つのモードを切り替える切り替えると、定義してある変数のマッピングがすべて失われます。

実行中にファイルをインポートすることで、列検索条件内で変数を使用できるように なります。ただし、モードを切り替えると、変数が含まれるすべての検索条件が削除されます。

### [](#設計時のファイルのインポート)設計時のファイルのインポート

**\[Read file now (今すぐファイルを読み込む)\]**​ を選択すると、ウィザードに以下の設定オプションが表示されます。

![「Read file now (今すぐファイルを読み込む)」 が選択され、ファイルプレビューが表示されている File Controlled Loop ウィザード](/mulesoft/current/ja-jp/rpa-builder/6.4/_images/file-controlled-loop-wizard-read-file-now.png)

**\[Import File (ファイルをインポート)\]**​ をクリックし、インポートするファイルを選択します。その後、RPA Builder でファイルが読み取られて分析され、ウィザードの ​**\[File Content Preview (ファイルコンテンツプレビュー)\]**​ セクションにコンテンツプレビューが表示されます。

**\[File Content Preview (ファイルコンテンツプレビュー)\]**​ セクションでは、​**\[Filter (検索条件)\]**​ ボタン (​![検索条件アイコン](/mulesoft/current/ja-jp/rpa-builder/6.4/_images/filter-icon.png)​) をクリックして、各列に検索条件を適用できます。​**\[Filter (検索条件)\]**​ 項目にテキストを入力すると、そのテキストを含まない行がプレビューから除外されます。

![File Controlled Loop アクションステップの検索条件ダイアログ](/mulesoft/current/ja-jp/rpa-builder/6.4/_images/file-controlled-loop-filter-dialog.png)

検索条件を適用する際にプレーンテキストの代わりに正規表現を使用するには、​**\[Use Regex (正規表現を使用)\]**​ を選択します。

各列名の横にあるドロップダウンメニューを使用して、列のコンテンツの型を変更できます。

### [](#実行中のファイルのインポート)実行中のファイルのインポート

**\[Read file dynamically during Workflow execution (ワークフロー実行中にファイルを動的に読み込む)\]**​ を選択すると、ウィザードに以下の設定オプションが表示されます。

![「Read file dynamically during Workflow execution (ワークフロー実行中にファイルを動的に読み込む)」 が選択され、ファイルプレビューが表示されている File Controlled Loop ウィザード](/mulesoft/current/ja-jp/rpa-builder/6.4/_images/file-controlled-loop-read-file-during-execution.png)

**\[File Name (ファイル名)\]**​ 項目の横にある ​**\[…​\]**​ をクリックして、ファイルパスを指定するか、ファイルを選択して​_サードパーティ_​フォルダーにコピーするか、または​_サードパーティ_​フォルダーを開きます。

**\[Use separate File Path during Script Execution (スクリプト実行時に別のファイルパスを使用)\]**​ を選択すると、ファイルを読み込むための絶対パスを指定できます。このオプションは、自動化を実行するシステムとワークフローをビルドするシステムでファイルの場所が異なる場合に使用します。

**\[Only read a maximum of <n> Records (最大 <n> 件のレコードのみを読み込む)\]**​ を選択すると、ファイルから読み込む最大行数を制限する数値を指定できます。

## [](#関連情報)関連情報

- [変数の使用](https://docs.mulesoft.com/jp/rpa-builder/6.4/advanced-concepts-using-variables)