--- schema_version: "1" id: cbccc2b100256d617f3522fb6fa76d0e24e50a5d7b9c6651d01dec0018e38c6c title: Excel Controlled Loop collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/rpa-builder/6.3/toolbox-excel-operations-excel-controlled-loop.md canonical_url: https://docs.mulesoft.com/jp/rpa-builder/6.3/toolbox-excel-operations-excel-controlled-loop source_site: docs.mulesoft.com content_type: documentation content_hash: 2aa4ed1f5276c424f171d94fad42f3d0139f2e43aa8aa83a9bf34a487ee18f8b description: MuleSoft Documentation Site release: "6.3" latest: false --- # Excel Controlled Loop _Excel Controlled Loop_​ 要素を使用して、Excel テーブルのデータを読み取ることができます。これは、​[File Controlled Loop](https://docs.mulesoft.com/jp/rpa-builder/6.3/toolbox-flow-control-file-controlled-loop)​ と同様に動作し、他のアクションステップのフレームワークも形成します。このウィザードには、反復の開始 (\[Read mode (読み取りモード)\]) や終了 (\[Terminate loop (ループを終了)\]) を決定するための多数の設定オプションが用意されています。 _Excel Controlled Loop_​ アクションステップは、Excel session 内でのみ使用できます。Excel Session でソースファイルを入力します。 ## [](#プロパティ)プロパティ **Excel Operation Settings (Excel 操作設定)** - **Column (列)**​ この列から Excel シートが読み取られます。 - **Empty rows count for break (中断する空の行数)**​ 連続する空の行が指定された数に達した後にループを終了します。 - **End column (終了列)**​ この列までシートが読み取られます。 - **End row (終了行)**​ 指定した行までシートが読み取られます。 - **Has a header (ヘッダーあり)**​ オプションを選択したかどうかを示します。これを選択すると、ソースファイルの最初の行が列ヘッダーとして使用されます。 - **Maximum number of rows (最大行数)**​ 読み取る最大行数を指定します。 - **Only read a maximum number of rows (最大行数のみを読み取る)**​ これを選択すると、読み取られる行数を制限できます。 - **Read mode (読み取りモード)**​ 選択した読み取りモード。 - **Regex condition for break (中断の正規表現条件)**​ 反復が停止される正規表現を表示します。 - **Regex condition for first cell (最初のセルの正規表現条件)**​ Excel シートを読み取る正規表現を表示します。 - **Row (行)**​ Excel シートを読み取る行を指定します。 - **Sheet name (シート名)**​ スプレッドシートの名前。このプロパティでは、名前を直接指定することしかできませんが、ウィザードでは、スプレッドシートを直接選択することも、ピン変数を介して選択することもできます。 - **Stop (loop break) criterion (停止 (ループ中断) 条件)**​ 選択した終了条件 (Terminate Loop (ループを終了))。 **設定のトラブルシューティング**​ - **date 数式の計算の無効化**​ DateTime として書式設定されているセル値の再計算を無効にして、多数の連動関係が含まれる数式の計算を完了する際に RPA Builder が無応答になるのを防止します。 ## [](#インバウンド変数)インバウンド変数 - **Sheet name (シート名)**​ スプレッドシートの名前。このプロパティでは、名前を直接指定することしかできませんが、ウィザードでは、スプレッドシートを直接選択することも、ピン変数を介して選択することもできます。 - **Column (列)**​ この列から Excel シートが読み取られます。 - **Row (行)**​ Excel シートが読み取られる行を指定します。 - **Regex to match (照合する正規表現)** ## [](#アウトバウンド変数)アウトバウンド変数 各列のコンテンツは、​_Excel Controlled Loop アクションステップ_​内の変数として返されます。 **Iteration Count (反復数)**​ ループサイクルの数。 **RowNumber (行数)**​ 読み取られる行の数を表示します。 ## [](#ウィザード)ウィザード **\[Read mode (読み取りモード)\]**​ と ​**\[Terminate loop (ループを終了)\]**​ の 2 つの設定は特に重要です。 **\[Read mode (読み取りモード)\]**​ では、スプレッドシートのデータが読み取られる、読み取り領域が定義されます。この領域外のデータは読み取られず、分析されません。 次のオプションが用意されています。 - **Read entire sheet (シート全体を読み取る)**​ (デフォルト) スプレッドシート全体が読み取られます。 - **Start reading from row and column (行と列から読み取りを返し)**​ ここでは、読み取りが開始される列と行を指定します。 - **Read part of sheet (シートの一部を読み取る)**​ ここでは、読み取りの開始場所だけでなく、読み取りの終了場所も指定できます。 - **Read to row (行に読み取る)**​ ここでは、スプレッドシートがどの行に読み取られるのかを指定できます。 - **Read to column (列に読み取る)**​ ここでは、スプレッドシートをどの列に読み取られるのかを指定できます。 - **Start reading when condition matches (条件が一致したときに読み取りを開始)**​ ここでは、正規表現を使用して読み取り領域を動的に決定できます。 たとえば、「^PLZ」 (正規表現) と入力すると、コンテンツが PLZ で始まるセルのスプレッドシートがアクションステップで読み取られます。 **\[Terminate loop (ループを終了)\]**​ では、終了条件が定義されます。たとえば、ここには、読み取り操作を終了する追加のオプションがあります。 - **On reaching the end of sheet area (シート領域の最後に達した場合)**​ (デフォルト) Excel シートの最後で読み取り操作が自動的に終了します。 - **On reaching empty rows (空の行に達した場合)**​ 特定の数の連続する空の行に達するとすぐに操作が終了します。 - **On Regex match in the cell value (セル値で正規表現に一致した場合)**​ ここで正規表現を定義すると、終了が動的に決まります。この例では、セルのコンテンツが PLZ で始まるとすぐに読み取り領域が終了します。 - **Only read a maximum number of rows (最大行数のみを読み取る)**​ ここでは、読み取られる行の最大数を指定できます。 すでに ​**\[Read mode (読み取りモード)\]**​ で読み取り領域を指定していたり、​**\[Only read a maximum number of rows (最大行数のみを読み取る)\]**​ オプションを使用して行の最大数を規定していたり、​**\[Terminate loop (ループを終了)\]**​ で終了条件を同時に定義していたりする場合、最初に発生したイベントが実行されます。 他に何も選択していない場合、列ヘッダー (Column\_1、2、3 など) が自動的に生成されます。 ウィザードで ​**\[Has a header (ヘッダーあり)\]**​ オプションを選択している場合、最初の行が列ヘッダーとして使用されます。 各列のデータ型は自動的に識別されます。