Excel Controlled Loop

Excel Controlled Loop​ 要素を使用して、Excel テーブルのデータを読み取ることができます。これは、​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 (ヘッダーあり)]​ オプションを選択している場合、最初の行が列ヘッダーとして使用されます。

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