Azure Logic Apps でモック データを使用してワークフローをテストする (プレビュー)

適用対象: Azure Logic Apps (従量課金プラン + Standard)

注意

この機能はプレビュー段階にあり、「Microsoft Azure プレビューの追加使用条件」が適用されます。

稼働中のアプリ、データ、サービス、またはシステムを実際に呼び出したりアクセスしたりせずにワークフローをテストするには、アクションからモック値を設定して返すことができます。 たとえば、さまざまな条件に基づいて異なるアクション パスをテストしたり、強制的にエラーを発生させたり、特定のメッセージ応答本文を指定したり、一部のステップをスキップしたりすることができます。 アクションでモック データのテストを設定してもアクションは実行されず、代わりにモック データが返されます。

たとえば、Outlook 365 のメール送信アクションにモック データを設定した場合、Azure Logic Apps は、Outlook を呼び出してメールを送信するのではなく、提供したモック データだけを返します。

この記事では、Logic App (従量課金プラン) および Logic App (Standard) リソース タイプにおいて、ワークフロー内のアクションでモック データを設定する方法について説明します。 これらのモック データを使用した過去のワークフロー実行を検索し、既存のアクション出力をモック データとして再利用することができます。

前提条件

• Azure アカウントとサブスクリプション。 サブスクリプションをお持ちでない場合には、無料の Azure アカウントにサインアップしてください。

• モック データを設定するロジック アプリのリソースとワークフロー。 この記事では、Recurrence トリガーと HTTP アクションをワークフローの例として使用しています。

  ロジック アプリを初めて使用する場合は、「Azure Logic Apps とは」と、次のドキュメントをご覧ください:

  • マルチテナント Azure Logic Apps で従量課金ロジック アプリ ワークフローの例を作成する

  • シングルテナント Azure Logic Apps で Standard ロジック アプリ ワークフローの例を作成する

モック データの出力を有効にする

従量課金プラン

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。

2. モック データを返す先となるアクションで、以下の手順を実行します。

   1. アクションの右上隅にある省略記号 ( ... ) ボタンを選択してから、 [Testing](テスト) を選択します。例は以下のとおりです。

      

   2. [Testing](テスト) ペインで、 [静的な結果の有効化 (プレビュー)] を選択します。 アクションの必須 (*) プロパティが表示されたら、アクションの応答として返すモック出力値を指定します。

      プロパティは、選択したアクションの種類によって異なります。 たとえば、HTTP アクションに必須なプロパティは以下のとおりです。

      プロパティ	説明
      状態	返されるアクションの状態
      状態コード	出力として返される特定の状態コード
      ヘッダー	返されるヘッダーの内容

      

      ヒント

      JavaScript Object Notation (JSON) 形式で値を入力するには、[JSON モードに切り替える] () を選びます。

   3. 省略可能なプロパティについては、 [省略可能なフィールドを選択する] の一覧を開いて、モックするプロパティを選択します。

      

3. 準備ができたら、 [完了] を選択します。

   アクションの右上隅では、キャプション バーにテスト ビーカー アイコン () が表示されるようになり、静的な結果が有効になっていることを示します。

   

   モック データを使用するワークフローの実行を検索するには、このトピックで後述する静的な結果を使用した実行を見つける方法に関するセクションを参照してください。

Standard

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。

2. デザイナーで、アクションの詳細ペインが表示されるよう、モック データを返したいアクションを選択します。

3. アクションの詳細ペインが右側に表示されたら、 [Testing](テスト) を選択します。

   

4. [Testing](テスト) タブで、 [静的な結果の有効化 (プレビュー)] を選択します。 アクションの必須 (*) プロパティが表示されたら、アクションの応答として返すモック出力値を指定します。

   プロパティは、選択したアクションの種類によって異なります。 たとえば、HTTP アクションに必須なプロパティは以下のとおりです。

   プロパティ	説明
   状態	返されるアクションの状態
   状態コード	出力として返される特定の状態コード
   ヘッダー	返されるヘッダーの内容

   

   ヒント

   JavaScript Object Notation (JSON) 形式で値を入力するには、[JSON モードに切り替える] () を選びます。

5. 省略可能なプロパティについては、 [省略可能なフィールドを選択する] の一覧を開いて、モックするプロパティを選択します。

   

6. 準備ができたら、 [完了] を選択します。

   アクションの右下隅にテスト ビーカー アイコン () が表示されるようになり、静的な結果が有効になっていることを示します。

   

   モック データを使用するワークフローの実行を検索するには、このトピックで後述する静的な結果を使用した実行を見つける方法に関するセクションを参照してください。

モック データを使用する実行を検索する

従量課金プラン

アクションでモック データが使用されている以前のワークフローの実行を見つけるには、そのワークフローの実行履歴を確認します。

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。

2. ロジック アプリのリソース メニューで、 [概要] を選択します。

3. まだ選択されていない場合は、 [Essentials](要点) セクションの [実行の履歴] を選択します。

4. [実行の履歴] テーブルの下で [静的な結果] 列を見つけます。

   モック データの出力を伴ったアクションを含むどの実行でも、たとえば次のように、 [静的な結果] 列が [有効] に設定されています。

   

5. モック データを使用したアクションを実行内で表示するには、 [静的な結果] 列が [有効] に設定されている目的の実行を選択します。

   静的な結果を使用したアクションには、たとえば次のように、テスト ビーカー () アイコンが表示されます。

   

Standard

アクションでモック データが使用されている他のワークフローの実行を検索するには、各実行を確認する必要があります。

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。

2. ワークフロー メニューで、 [概要] を選択します。

3. まだ選択されていない場合は、 [Essentials](要点) セクションの [実行履歴] を選択します。

4. [実行履歴] テーブルで、確認する実行を選択します。

   

5. [実行の詳細] ペインで、テスト ビーカー () が表示されているアクションがあるかどうかを確認します。

   

前の出力をモック データとして再利用する

以前に実行したワークフローに出力がある場合、その実行から出力をコピーして貼り付けることで、その出力をモック データとして再利用することができます。

従量課金プラン

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。

2. ロジック アプリのリソース メニューで、 [概要] を選択します。

3. まだ選択されていない場合は、 [Essentials](要点) セクションの [実行の履歴] を選択します。 表示されるリストから、目的のワークフローの実行を選択します。

   

4. 実行の結果ペインが開いたら、目的の出力を含むアクションを展開します。

5. [出力] セクションで、 [未加工出力の表示] を選択します。

6. [出力] ペインに、完全な JavaScript Object Notation (JSON) オブジェクトか、出力セクションやヘッダー セクションなどの使用する特定のサブセクションのどちらかをコピーします。

7. アクションでモック アップ データを設定する方法に関する前述のセクションを確認し、手順に従ってアクションの [Testing](テスト) ペインを開きます。

8. [Testing](テスト) ペインが開いたら、次のどちらかの手順を選択します。

   • 完全な JSON オブジェクトを貼り付けるには、[Testing](テスト) ラベルの横にある [JSON モードに切り替える] () を選択します。

     

   • JSON のセクションだけを貼り付けるには、そのセクションのラベル (出力 や ヘッダー など) の横にある、JSON モードに切り替える を選択します。たとえば、以下のとおりです。

     

9. JSON エディターで、以前にコピーした JSON を貼り付けます。

   

10. 完了したら、 [完了] をクリックします。 または、デザイナーに戻るには、[エディター モードを切り替える] () を選択します。

Standard

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。

2. ワークフロー メニューで、 [概要] を選択します。

3. まだ選択されていない場合は、 [Essentials](要点) セクションの [実行履歴] を選択します。

4. [実行履歴] テーブルで、確認する実行を選択します。

   

5. 実行の結果ペインが開いたら、目的の出力を含むアクションを選択します。

6. [出力] セクションで、 [未加工出力の表示] を選択します。

7. [出力] ペインに、完全な JavaScript Object Notation (JSON) オブジェクトか、出力セクションやヘッダー セクションなどの使用する特定のサブセクションのどちらかをコピーします。

8. アクションでモック アップ データを設定する方法に関する前述のセクションを確認し、手順に従ってアクションの [Testing](テスト) タブを開きます。

9. [Testing](テスト) タブが開いたら、次のどちらかの手順を選択します。

   • 完全な JSON オブジェクトを貼り付けるには、[Testing](テスト) ラベルの横にある [JSON モードに切り替える] () を選択します。

     

   • JSON のセクションだけを貼り付けるには、そのセクションのラベル (出力 や ヘッダー など) の横にある、JSON モードに切り替える を選択します。たとえば、以下のとおりです。

     

10. JSON エディターで、以前にコピーした JSON を貼り付けます。

    

11. 完了したら、 [完了] をクリックします。 または、デザイナーに戻るには、[エディター モードを切り替える] () を選択します。

モック データを無効にする

アクションで静的な結果をオフにしても、前回の設定の値は削除されません。 そのため、同じアクションで静的な結果を再度有効にした場合は、前の値を引き続き使用することができます。

従量課金プラン

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。 モック データを無効にするアクションを探します。

2. アクションの右上隅で、テスト ビーカー アイコン () を選びます。

   

3. [静的な結果の無効化]>[完了] の順に選択します。

   

Standard

1. Azure portal で、ロジック アプリ ワークフローをデザイナーで開きます。 モック データを無効にするアクションを選択します。

2. アクションの詳細ペインで、 [Testing](テスト) タブを選択します。

3. [静的な結果の無効化]>[完了] の順に選択します。

   

リファレンス

基になるワークフロー定義でのこの設定の詳細については、「Static results - Schema reference for Workflow Definition Language (静的結果 - ワークフロー定義言語のスキーマ参照)」と「runtimeConfiguration.staticResult - Runtime configuration settings (runtimeConfiguration.staticResult - ランタイム構成設定)」を参照してください

次のステップ

• Azure Logic Apps について学習します