---
schema_version: "1"
id: f5876f71d75274ab0c9c20900942e415be6cdd3edf32906737d3e07e6543179f
title: Excel Controlled Loop
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/rpa-builder/6.1/toolbox-excel-operations-excel-controlled-loop.md
canonical_url: https://docs.mulesoft.com/jp/rpa-builder/6.1/toolbox-excel-operations-excel-controlled-loop
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 0547cc329d6099c5359326558bd04dbb1f10580b1e6942ab441d26996448f915
description: MuleSoft Documentation Site
release: "6.1"
latest: false
---
# Excel Controlled Loop

_Excel Controlled Loop_​ 要素を使用して、Excel テーブルのデータを読み取ることができます。これは、​[File Controlled Loop](https://docs.mulesoft.com/jp/rpa-builder/6.1/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 (ループを終了)\]) を確認できます。

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

- **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 (ヘッダーあり)\]**​ オプションを選択している場合、最初の行が列ヘッダーとして使用されます。

各列のデータ型は自動的に識別されます。