自動で実行される Power Automate フローにスクリプトからデータを返す

[アーティクル]
04/13/2022

このチュートリアルでは、自動化された Power Automate ワークフローの一部として、Excel on the web 用の Office スクリプトから情報を返す方法について説明します。スケジュールを確認し、フローに従ってリマインダーメールを送信するスクリプトを作成します。このフローは定期的に実行され、ユーザーに代わってこれらのリマインダーを提供します。

ヒント

Office スクリプトを初めて使用する場合は、チュートリアルの「Excel on the web で Office スクリプトを記録、編集、作成する」から始めることをお勧めします。

Power Automate を初めて使用する場合は、チュートリアルの「手動 Power Automate フローからスクリプトを呼び出す」と「自動で実行される Power Automate フロー内で、データをスクリプトに渡す」から始めることを勧めします。

Office スクリプトは TypeScript を使用します。このチュートリアルは、JavaScript や TypeScript について初級から中級レベルの知識を持つユーザーを対象としています。 JavaScript を使い慣れていない場合は、「Mozilla の JavaScript チュートリアル」から始めることをお勧めします。

前提条件

このチュートリアルを開始するには、以下へのアクセスが必要です。

ブックを準備する

ブック on-call-rotation.xlsx を自分の OneDrive にダウンロードします。
Excel on the web で on-call-rotation.xlsx を開きます。
テーブルに行を追加して、自分の名前、メールアドレス、および現在の日付と重なるように開始日と終了日を入力します。

重要

これから作成するスクリプトは、テーブル内の最初に一致するエントリを使用するため、自分の名前が現在の週のどの行よりも上にあることを確認してください。

Office スクリプトを作成する

[オートメーション] タブに移動して [すべてのスクリプト] を選択します。
[新しいスクリプト] を選択します。
スクリプトに Get On-Call Person という名前を付けます。
これで空のスクリプトができました。スクリプトを使用して、スプレッドシートからメールアドレスを取得します。文字列が返されるように、main を次のように変更します。
```
function main(workbook: ExcelScript.Workbook) : string {
}
```

続いて、テーブルからすべてのデータを取得する必要があります。それにより、スクリプトを使用して各行を確認できます。 main 関数に次のコードを追加します。

// Get the H1 worksheet.
let worksheet = workbook.getWorksheet("H1");

// Get the first (and only) table in the worksheet.
let table = worksheet.getTables()[0];

// Get the data from the table.
let tableValues = table.getRangeBetweenHeaderAndTotal().getValues();

テーブル内の日付は、Excel の日付システムを使用して保存されます。これらの日付は、比較できるように JavaScript の日付に変換する必要があります。ヘルパー関数をスクリプトに追加します。 main 関数の外に次のコードを追加します。
```
// Convert the Excel date to a JavaScript Date object.
function convertDate(excelDateValue: number) {
    let javaScriptDate = new Date(Math.round((excelDateValue - 25569) * 86400 * 1000));
    return javaScriptDate;
}
```
次に、現在誰が呼び出し期間中かを把握する必要があります。それらの行では、開始日と終了日の間に現在の日付が含まれています。ここでは、一度に 1 人だけが呼び出し期間であると想定してスクリプトを作成します。スクリプトで配列を返して複数の値を処理することもできますが、現時点では、最初に一致するメールアドレスを返すようにします。次の関数を main 関数の最後に追加します。
```
// Look for the first row where today's date is between the row's start and end dates.
let currentDate = new Date();
for (let row = 0; row < tableValues.length; row++) {
    let startDate = convertDate(tableValues[row][2] as number);
    let endDate = convertDate(tableValues[row][3] as number);
    if (startDate <= currentDate && endDate >= currentDate) {
        // Return the first matching email address.
        return tableValues[row][1].toString();
    }
}
```

最終的なスクリプトは、次のようになります。

function main(workbook: ExcelScript.Workbook) : string {
    // Get the H1 worksheet.
    let worksheet = workbook.getWorksheet("H1");

    // Get the first (and only) table in the worksheet.
    let table = worksheet.getTables()[0];

    // Get the data from the table.
    let tableValues = table.getRangeBetweenHeaderAndTotal().getValues();

    // Look for the first row where today's date is between the row's start and end dates.
    let currentDate = new Date();
    for (let row = 0; row < tableValues.length; row++) {
        let startDate = convertDate(tableValues[row][2] as number);
        let endDate = convertDate(tableValues[row][3] as number);
        if (startDate <= currentDate && endDate >= currentDate) {
            // Return the first matching email address.
            return tableValues[row][1].toString();
        }
    }
}

// Convert the Excel date to a JavaScript Date object.
function convertDate(excelDateValue: number) {
    let javaScriptDate = new Date(Math.round((excelDateValue - 25569) * 86400 * 1000));
    return javaScriptDate;
}

Power Automate を使用して自動化されたワークフローを作成する

「Power Automate のサイト」にサインインします。
画面の左側に表示されるメニューで、[作成] を選択します。これにより、新しいワークフローを作成する方法の一覧を表示できます。
[空白から開始] セクションで [スケジュール済みクラウドフロー] を選択します。
続いて、このフローのスケジュールを設定します。使用しているスプレッドシートには、2022 年前半の毎週月曜日から始まる新しい呼び出し期間の割り当てが含まれています。月曜日の朝一番に実行するようにフローを設定します。次のオプションを使用して、毎週月曜日に実行するようにフローを構成します。
- フロー名: Notify On-Call Person
- 開始: 22/3/1 午前 1:00
- 繰り返し間隔: 1 週
- 設定曜日: 月
[作成] を選択します。
[新しい手順] を選択します。
[標準] タブを選択し、Excel Online (ビジネス) を選択します。
[アクション] で、[スクリプトの実行] を選択します。
次に、フローステップで使用するブックとスクリプトを選択します。自分の OneDrive で作成したブック on-call-rotation.xlsx を使用します。 スクリプトの実行 コネクタには、次の設定を指定します。
- 場所: OneDrive for Business
- ドキュメントライブラリ: OneDrive
- ファイル: on-call-rotation.xlsx (ファイルブラウザーを使用して選択されています)
- スクリプト: Get On-Call Person
[新しい手順] を選択します。
リマインダーメールを送信してフローを終了します。コネクタの検索バーを使用して、[メールの送信 (V2)] を選択します。スクリプトによって返されるメールアドレスを追加するために、動的なコンテンツの追加 コントロールを使用します。これは、result というラベル付きの Excel アイコンで示されます。件名、本文は自由に入力できます。

注意

このチュートリアルでは、Outlook を使用します。代わりに、お好きなメールサービスを自由に使用することもできますが、一部のオプションは異なる場合があります。
[保存] を選択します。

Power Automate でスクリプトをテストする

作成したフローは毎週月曜日に実行されます。画面の右上隅にある [テスト] ボタンを選択すると、スクリプトをテストできます。 [手動] を選択し、[テストの実行] を選択して直ちにフローを実行し、動作をテストします。続行するには、Excel と Outlook にアクセス許可を付与する必要がある場合があります。

Power Automate の [テスト] ボタン。

ヒント

フローでメールを送信できない場合は、スプレッドシートで、有効なメールが現在の日付範囲用としてテーブルの先頭にリストされていることを再確認してください。

次の手順

Office スクリプトを Power Automate に接続する方法に関する詳細については、「Power Automate で Office スクリプトを実行する」を参照してください。

「自動タスクリマインダーのサンプルシナリオ」では、Office スクリプトと Power Automate を Teams アダプティブカードと組み合わせる方法についても説明します。