チュートリアル: Azure Logic Apps を使用して、スケジュールに基づいて実行される自動化ワークフローを作成する

[アーティクル]
01/04/2024

適用対象: Azure Logic Apps (従量課金)

このチュートリアルでは、定期的なスケジュールで実行されるロジックアプリワークフローの例を作成する方法について紹介します。具体的には、このワークフロー例を使用して、交通量を含めた 2 地点間の移動時間をチェックします。これがすべての平日の朝に実行されます。時間が特定の上限を超えると、ワークフローにより、移動時間と目的地到着までに必要な追加時間が記載されたメールが送信されます。このワークフローには、さまざまな手順を含めます。スケジュールベースのトリガーで開始し、Bing 地図アクション、データ操作アクション、制御フローアクション、メール通知アクションが続きます。

このチュートリアルでは、以下の内容を学習します。

空のロジックアプリとワークフローを作成します。
ワークフローの実行スケジュールを指定する繰り返しトリガーを追加します。
ルートの移動時間を取得する Bing 地図アクションを追加します。
変数を作成して移動時間を秒から分に変換し、その結果を変数に保存するアクションを追加します。
指定した上限に照らして移動時間を比較する条件を追加します。
移動時間が上限を超えた場合にメールを送信するアクションを追加します。

完了したワークフローは、以下の大まかな例のようになります。

ロジックアプリのワークフロー例の概要を示すスクリーンショット。

前提条件

Azure アカウントとサブスクリプション。サブスクリプションをお持ちでない場合には、無料の Azure アカウントにサインアップしてください。
Azure Logic Apps でサポートされるメールプロバイダー (Office 365 Outlook、Outlook.com、Gmail など) のメールアカウント。その他のプロバイダーについては、こちらのコネクタ一覧を参照してください。このクイックスタートでは、職場または学校アカウントで Office 365 Outlook を使用します。別のメールアカウントを使う場合、おおよその手順は変わりませんが、UI がやや異なることがあります。

重要

Gmail コネクタの使用を希望する場合、ロジックアプリワークフローで制限なしにこのコネクタを使用できるのは、G-Suite ビジネスアカウントだけです。 Gmail コンシューマーアカウントを持っている場合は、Google によって承認された特定のサービスのみでこのコネクタを使用できるほか、認証に使用する Google クライアントアプリを Gmail コネクタで作成することができます。詳細については、「Azure Logic Apps での Google コネクタのデータセキュリティとプライバシーポリシー」を参照してください。
ルートの移動時間を取得するために Bing Maps API のアクセスキーが必要となります。このキーを取得するには、Bing 地図のキーを取得する方法に関するページの手順に従ってください。
ワークフローが特定の IP アドレスへのトラフィックを制限するファイアウォール経由で通信する必要がある場合、そのファイアウォールでは、ロジックアプリリソースが存在する Azure リージョン内の Azure Logic Apps によって使用される受信と送信 "両方" の IP アドレスに対してアクセスを許可する必要があります。また、ワークフローで Office 365 Outlook コネクタや SQL コネクタなどのマネージドコネクタが使用されている場合、またはカスタムコネクタが使用されている場合、そのファイアウォールでは、ロジックアプリリソースの Azure リージョン内にある "すべて" のマネージドコネクタ送信 IP アドレスに対するアクセスも許可する必要があります。

従量課金のロジックアプリワークフローを作成する

Azure portal で、Azure アカウントを使ってサインインします。
Azure ホームページで、 [リソースの作成] を選択します。
Azure Marketplace メニューで、 [統合]>[ロジックアプリ] を選択します。

[ロジックアプリの作成] ペインの [基本] タブで、ロジックアプリリソースに関する次の情報を入力します。

Azure portal、ロジックアプリの作成ペイン、新しいロジックアプリリソースの情報を示すスクリーンショット。

プロパティ	必須	値	説明
サブスクリプション	はい	<Azure サブスクリプション名>	Azure サブスクリプション名。この例では、従量課金制を使用します。
リソースグループ	はい	LA-TravelTime-RG	ロジックアプリリソースと関連リソースを作成する Azure リソースグループ。この名前は、リージョン間で一意である必要があり、文字、数字、ハイフン (`-`)、アンダースコア (`_`)、かっこ (`(`、`)`)、ピリオド (`.`) のみを含めることができます。
名前	はい	LA-TravelTime	ロジックアプリリソースの名前。リージョン間で一意である必要があり、文字、数字、ハイフン (`-`)、アンダースコア (`_`)、かっこ (`(`、`)`)、およびピリオド (`.`) のみを含めることができます。

選択を続ける前に、[プラン] セクションに移動します。 [プランの種類] として [従量課金] を選択すると、マルチテナント Azure Logic Apps で実行される従量課金ロジックアプリワークフローの設定のみが表示されます。

また、[プランの種類] プロパティでは、使用する課金モデルも指定します。

プランの種類	説明
Standard	このロジックアプリの種類は既定の選択であり、シングルテナント Azure Logic Apps で実行され、標準課金モデルを使います。
従量課金プラン	このロジックアプリの種類は、グローバルなマルチテナント Azure Logic Apps で実行され、従量課金モデルを使います。

以下の選択を続けます。

プロパティ	必須	値	説明
[リージョン]	はい	米国西部	アプリの情報を格納するための Azure データセンターリージョン。この例では、サンプルロジックアプリを Azure の米国西部リージョンにデプロイします。注: お使いのサブスクリプションが統合サービス環境に関連付けられている場合、この一覧にはこれらの環境が含まれます。
Log Analytics を有効にする	はい	いいえ	このオプションは、従量課金のロジックアプリの種類を選んだ場合にのみ表示されて適用されます。診断ログを有効にする場合にのみ、このオプションを変更します。このチュートリアルでは、既定の選択をそのまま使います。

完了したら、 [確認および作成] を選択します。 Azure によってロジックアプリリソースに関する情報が検証されたら、[作成] を選択します。
Azure によってアプリがデプロイされたら、 [リソースに移動] を選択します。

Azure によってワークフローのテンプレートの選択ペインが開き、紹介動画、一般的に使用されるトリガー、およびワークフローのテンプレートパターンが表示されます。
動画と一般的なトリガーのセクションの下にある [テンプレート] セクションまでスクロールし、 [空のロジックアプリ] を選択します。

次に、指定したスケジュールに基づいてワークフローが実行される繰り返しトリガーを追加します。すべてのワークフローは必ずトリガーから起動され、トリガーは、特定のイベントが発生するか、新しいデータが特定の条件を満たしたときに起動されます。詳細については、「マルチテナント Azure Logic Apps で従量課金ロジックアプリワークフローの例を作成する」をご覧ください。

繰り返しトリガーを追加する

ワークフローデザイナーの検索ボックスの下で、[組み込み] を選択します。
検索ボックスに「recurrence」と入力し、Recurrence という名前のトリガーを選択します。
[繰り返し] シェイプの省略記号 ( ... ) ボタンを選択し、 [名前の変更] を選択します。トリガーの名前をわかりやすく「Check travel time every weekday morning」に変更します。
トリガー内で、次のプロパティを以下の画面と説明に従って変更します。

プロパティ必須値説明

間隔はい 1 チェックの間隔 (単位数)

頻度はい Week 定期実行の時間の単位
[間隔] と [頻度] の下にある [新しいパラメーターの追加] ボックスの一覧を開き、次のプロパティを選択してトリガーに追加します。
- 設定曜日
- 設定時刻 (時間)
- 設定時刻 (分)

プロパティ	必須	値	説明
間隔	はい	1	チェックの間隔 (単位数)
頻度	はい	Week	定期実行の時間の単位

今度は、以下の図と説明に従って、追加したプロパティの値を設定します。

追加プロパティの値が次の表の説明に従って設定されているスクリーンショット。

プロパティ	値	説明
設定曜日	月曜日、火曜日、水曜日、木曜日、金曜日	この設定は、 [頻度] を [週] に設定した場合にのみ使用できます。
設定時刻 (時間)	7、8、9	この設定は、 [頻度] を [週] または [日] に設定した場合にのみ使用できます。この繰り返しには、時刻 (時間) を選択します。この例では、`7` 時、`8` 時、`9` 時に実行されます。
設定時刻 (分)	0、15、30、45	この設定は、 [頻度] を [週] または [日] に設定した場合にのみ使用できます。この繰り返しには、時刻 (分) を選択します。この例では、正時を起点として 15 分おきに実行されます。

このトリガーは、平日の毎朝午前 7 時 00 分から午前 9 時 45 分まで 15 分おきに起動します。定期実行のスケジュールは [プレビュー] ボックスに表示されます。詳細については、タスクとワークフローのスケジュールおよびワークフローのアクションとトリガーに関するページを参照してください。

ここでトリガーの詳細を非表示にするには、シェイプのタイトルバー内をクリックしてシェイプを折りたたみます。
ワークフローを保存します。デザイナーのツールバーで、 [保存] を選択します。

作成したロジックアプリワークフローが Azure portal に表示されるようになりましたが、これを実行しても、指定したスケジュールに基づいてトリガーされるだけです。そこで、トリガーが起動したときに反応するアクションを追加します。

ルートの移動時間を取得する

トリガーが完成したら、2 地点間の移動時間を取得するアクションを追加します。 Azure Logic Apps には Bing Maps API 用のコネクタが用意されているため、この情報を簡単に取得することができます。このタスクを開始する前に、このチュートリアルの前提条件で触れた Bing Maps API キーを用意しておいてください。

ワークフローデザイナーで、繰り返しトリガーの下の [新しいステップ] を選択します。
[操作を選択してください] で [標準] を選択します。検索ボックスに「bing maps」と入力し、「Get route」 (ルートを取得する) という名前のアクションを選択します。

Bing 地図の接続が存在しない場合、接続を作成するように求められます。以下の画面と説明に従って接続の詳細を指定し、 [作成] を選択します。

[Bing 地図] 接続ボックスに接続名と Bing 地図 API キーが指定されているスクリーンショット。

プロパティ	必須	値	説明
Connection Name	はい	BingMapsConnection	接続の名前を指定します。この例では、`BingMapsConnection` を使用します。
API キー	はい	<Bing-Maps-API-key>	あらかじめ取得しておいた Bing 地図 API キーを入力します。 Bing 地図のキーを所有していない場合は、キーの取得方法に関するページを参照してください。

アクションの名前を次の説明に変更します: Get route and travel time with traffic
このアクションで [新しいパラメーターの追加] の一覧を開き、次のプロパティを選択します。
- 最適化
- 距離単位
- Travel mode (移動手段)

ここで、プロパティの値を以下の画面と説明に従って入力します。

プロパティ	必須	値	説明
通過地点 1	はい	<start-location>	ルートの起点。この例では、出発地の住所の例を指定します。
通過地点 2	はい	<end-location>	ルートの目的地。この例では、目的地の住所の例を指定します。
最適化	いいえ	timeWithTraffic	ルートを最適化するためのパラメーター (距離、最新の交通量を加味した移動時間など) パラメーター値 timeWithTraffic を選択します。
距離単位	いいえ	<your-preference>	ルートの距離の単位。この例では、単位として [マイル] を使用します。
Travel mode (移動手段)	いいえ	Driving (車)	ルートの移動手段。 [車] モードを選択します。

これらのパラメーターと値の詳細については、ルートの計算に関する記事をご覧ください。

デザイナーのツールバーで、 [保存] を選択します。

次に、最新の移動時間を秒ではなく分に変換して格納するための変数を作成します。そうすることで、同じ変換処理を繰り返す手間が省け、以降の手順で値が利用しやすくなります。

移動時間を格納するための変数を作成する

ワークフロー内でデータに対する操作を実行し、その結果を後続のアクションで使うことが必要になる場合があります。これらの結果を再利用または参照しやすいよう保存するには、処理後に結果を格納する変数を作成します。変数は、ワークフローの最上位でのみ作成することができます。

既定では、Get route (ルートを取得) アクションにより、現在の移動時間 (秒単位) と交通量が Travel Duration Traffic (交通量を考慮した移動時間) プロパティから返されます。この値を "分" に変換して格納しておけば、後で同じ変換を繰り返さずに済み、再利用しやすくなります。

デザイナーの Get route (ルートを取得) アクションで、 [新しいステップ] を選択します。
[操作を選択してください] で [組み込み] を選択します。検索ボックスに「variables」と入力し、「Initialize variable」 (変数を初期化する) という名前のアクションを選択します。
このアクションの名前をわかりやすく「Create variable to store travel time」に変更します。

次の表と表の下の手順に従って次の情報を変数に入力します。

プロパティ	必須	値	説明
名前	はい	travelTime	変数の名前。この例では、`travelTime` を使用します。
Type	はい	Integer	変数のデータ型
Value	いいえ	現在の移動時間を秒から分に変換する式 (この表の下の手順を参照)。	変数の初期値

[値] プロパティの式を作成するには、ボックス内をクリックして動的コンテンツリストを表示します。必要に応じて、ブラウザーの幅を動的なリストが表示されるまで広げてください。動的なコンテンツリストで、 [式] を選択すると、式エディターが表示されます。

動的なコンテンツリストに以前のアクションの出力が表示され、ワークフローの後続のアクションへの入力として選択できます。動的なコンテンツリストには式エディターが含まれており、式の演算を実行する関数を選択するために使用できます。この式エディターは、動的なコンテンツリスト内でのみ使用できます。
式エディターに、「div(,60)」という式を入力します。
式の左かっこ ( ( ) とコンマ ( , ) の間にカーソルを置き、 [動的なコンテンツ] を選択します。
動的なコンテンツリストで、プロパティ値、Travel Duration Traffic (移動時間の交通量) の順に選択します。
式の中でプロパティの値が解決されたら [OK] を選択します。

[値] プロパティが次のように表示されます。

ワークフローを保存します。デザイナーのツールバーで、 [保存] を選択します。

次に、最新の移動時間が特定の上限を超えたかどうかをチェックする条件を追加します。

移動時間と上限を比較する

Create variable to store travel time (移動時間を格納する変数を作成する) アクションで、 [新しいステップ] を選択します。
[操作を選択してください] で [組み込み] を選択します。検索ボックスに「condition」と入力します。また、[アクション] 一覧で、Condition (条件) という名前のアクションを選択します。
条件の名前をわかりやすく「If travel time exceeds limit」に変更します。
travelTime プロパティの値が特定の上限を超えているかどうかを調べる条件を次の説明に従って作成します。
1. 条件内で、条件の左側にある [値の選択] ボックス内をクリックします。
2. 動的なコンテンツリストが表示されるので、 [変数] の travelTime という名前のプロパティを選択します。
3. 中央の比較ボックスで、 is greater than(次の値より大きい) という演算子を選択します。
4. 条件の右側にある [値の選択] ボックスで、上限として「15」を入力します。
  
  完成した条件は次の例のようになります。
ワークフローを保存します。デザイナーのツールバーで、 [保存] を選択します。

次に、移動時間が上限を超えたときに実行するアクションを追加します。

上限を超えたときにメールを送信する

次に、移動時間が上限を超えたときにメールを送信するアクションを追加します。このメールには、指定されたルートで移動するために必要な最新の移動時間と超過時間が記載されます。

条件の [真] 分岐で、 [アクションの追加] を選択します。
[操作を選択してください] で [標準] を選択します。検索ボックスに、「send email」と入力します。一覧には多くの結果が返されるため、一覧をフィルター処理できるように、最初に必要な電子メールコネクタを選択します。

たとえば、Outlook の電子メールアカウントをお持ちの場合は、ご自分のアカウントの種類に対応するコネクタを選択します。
- Azure の職場または学校アカウントには、Office 365 Outlook を選択します。
- 個人用 Microsoft アカウントには、Outlook.com を選択します。
この例では、Office 365 Outlook を選択して続行します。
コネクタのアクションが表示されるので、次のように、電子メールを送信するアクションを選択します。
まだ接続していない場合は、サインインし、メッセージが表示されたら電子メールアカウントへのアクセスを認証します。

Azure Logic Apps によって、ご自分のメールアカウントへの接続が作成されます。
アクションの名前をわかりやすく「Send email with travel time」に変更します。
[宛先] プロパティに、受信者のメールアドレスを入力します。テスト目的のために、ご自身の電子メールアドレスを使用できます。
[件名] プロパティに、メールの件名を指定し、travelTime 変数を次の手順に従って追加します。
1. 「Current travel time (minutes):」というテキストを入力します。末尾にスペースを 1 つ追加してください。動的なコンテンツリストが開いたままになるように、 [件名] ボックスの中にカーソルを置いたままにします。
2. 動的なコンテンツリストの [変数] 見出しで、 [詳細表示] を選択して travelTime という名前の変数が表示されるようにします。
  
  Note
  
  動的なコンテンツリストで、travelTime 変数は自動的には表示されません。これは、 [件名] プロパティが文字列値であると想定されるのに対し、travelTime が整数値であるためです。
[本文] プロパティで、次の手順に従って、電子メールの本文の内容を指定します。
1. 「Add extra travel time (minutes):」というテキストを入力します。末尾にスペースを 1 つ追加してください。動的なコンテンツリストが開いたままになるように、 [本文] ボックスの中にカーソルを置いたままにします。
2. 動的なコンテンツリストで、 [式] を選択すると、式エディターが表示されます。
3. 式エディターに、上限の超過時間 (分) を計算できるように「sub(,15)」と入力します。
4. 式の左かっこ ( ( ) とコンマ ( , ) の間にカーソルを置き、 [動的なコンテンツ] を選択します。
5. [変数] で [travelTime] を選択します。
6. 式の中でプロパティが解決されたら [OK] を選択します。
  
  [本文] プロパティが次のように表示されます。
ワークフローを保存します。デザイナーのツールバーで、 [保存] を選択します。

次に、作成したワークフローをテストして実行します。この時点で、次のようになっています。

完成したロジックアプリワークフローの例を示すスクリーンショット

ワークフローを実行する

ワークフローを手動で開始するには、デザイナーのツールバーの [トリガーの実行]>[実行] を選択します。

最新の移動時間が指定した上限を下回っている限り、このワークフローは何も実行せず、次の間隔が経過するのを待って再びチェックを実行します。
最新の移動時間が指定の上限を超えた場合、最新の移動時間と上限を基準とした超過分の時間 (分) とがメールで通知されます。以下に示したのは、このワークフローから送信されるメールの例です。

ヒント

メールが届かない場合は、迷惑メールフォルダーを確認してください。この種のメールは、迷惑メールフィルターによってリダイレクトされる場合があります。また、ワークフローが正しく動作しているかどうかわからない場合は、ワークフローのトラブルシューティングに関するページを参照してください。

お疲れさまでした。スケジュールに基づいて定期実行されるワークフローを作成し、実行することができました。

[繰り返し] トリガーを使って作成できるワークフローは他にもあります。次のテンプレートが用意されていますので、新しいロジックアプリリソースの作成後にぜひご覧ください。

毎日リマインダーを受け取る。
古くなった Azure BLOB を削除する。
Azure Storage キューにメッセージを追加する。

リソースをクリーンアップする

ワークフローは、ロジックアプリリソースを無効にするか削除するまで実行され続けます。このサンプルワークフローが不要になったら、ロジックアプリリソースと関連リソースが含まれるリソースグループを削除しましょう。

Azure portal の検索ボックスに、作成したリソースグループの名前を入力します。結果の [リソースグループ] で、そのリソースグループを選択します。

この例では、LA-TravelTime-RG という名前の新しいリソースグループを作成しました。

ヒント

Azure のホームページの [最近のリソース] にリソースグループが表示されている場合は、ホームページからそのグループを選択できます。
リソースグループのメニューで、 [概要] が選択されていることを確認します。 [概要] ペインのツールバーで、 [リソースグループの削除] を選択します。
確認ペインが表示されたら、リソースグループ名を入力して、 [削除] を選択します。

次の手順

このチュートリアルでは、指定したスケジュール (平日朝毎日) に基づいて交通量をチェックし、移動時間が指定した上限を超えたときにアクションを行う (メールを送信する) ロジックアプリワークフローを作成しました。次は、Azure サービスや Microsoft サービスなど、各種 Software-as-a-Service (SaaS) アプリを統合して、メーリングリストの承認申請を送信するワークフローの作成方法について詳しく見ていきましょう。

メーリングリストの登録申請の管理