Azure Logic Apps でモック出力を使用してワークフローをテストする

[アーティクル]
07/30/2024

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

運用環境に影響を与えずにワークフローをテストするには、モック出力つまり "静的な結果" を設定して、ワークフロー操作から返すことができます。そのようにすると、ライブアプリ、データ、サービス、またはシステムへの呼び出しやアクセスの必要がなくなります。たとえば、さまざまな条件に基づいて異なるアクションパスをテストしたり、強制的にエラーを発生させたり、特定のメッセージ応答本文を指定したり、一部のステップをスキップしたりすることができます。アクションからのモック結果を設定しても操作は実行されず、代わりにテスト出力が返されます。

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

このガイドでは、従量課金または Standard のロジックアプリワークフローでアクションに対してモック出力を設定する方法について説明します。

前提条件

Azure アカウントとサブスクリプション。サブスクリプションをお持ちでない場合には、無料の Azure アカウントにサインアップしてください。
モック出力を設定するロジックアプリリソースとワークフロー。この記事では、Recurrence トリガーと HTTP アクションをワークフローの例として使用しています。

ロジックアプリを初めて使う場合は、次のドキュメントをご覧ください。
- マルチテナント Azure Logic Apps で従量課金ロジックアプリワークフローの例を作成する
- シングルテナント Azure Logic Apps で Standard ロジックアプリワークフローの例を作成する

制限事項

この機能はアクションでのみ使用でき、トリガーではできません。
現在、この機能を動的に、またはプログラムで有効または無効にするオプションはありません。
この機能が有効になっていることをロジックアプリレベルで示すものはありません。次の一覧は、この機能が有効になっていることを示すものが見つかる場所の説明です。
- アクション図形では、右下隅にテストビーカーアイコン () が示されます。
- アクションの詳細ペインの [テスト] タブでは、[静的な結果] オプションが有効になります。
- コードビューでは、アクションの JSON 定義の runtimeConfiguration JSON オブジェクトに次のプロパティが含まれます。
```
"runtimeConfiguration": {
    "staticResult": {
        "name": "{action-name-ordinal}",
        "staticResultOptions": "Enabled"
    }
}
```
- ワークフローの実行履歴では、[静的な結果] 列で、少なくとも 1 つのアクションでこの機能が有効になっている実行の横に、[有効] という単語が表示されます。

Azure portal で、従量課金ロジックアプリのワークフローをデザイナーで開きます。
デザイナーで、モック出力を返すアクションを選びます。
アクション情報ペインで、[テスト] を選びます。次はその例です。
[テスト] タブで、[静的な結果の有効化] を選びます。

[フィールドの選択] の一覧で、アクションの応答で返すモック出力を指定するプロパティを選びます。

使用できるプロパティは、選んだアクションの種類によって異なります。たとえば、HTTP アクションには次のセクションとプロパティがあります。

セクションまたはプロパティ	必須	内容
Status	はい	返すアクションの状態。 - [成功] を選んだ場合は、[フィールドの選択] の一覧から [出力] も選ぶ必要があります。 - [失敗] を選んだ場合は、[フィールドの選択] の一覧から [エラー] も選ぶ必要があります。
コード	いいえ	アクションに対して返す特定のコード
エラー	はい: [状態] が [失敗] の場合	返すエラーメッセージと省略可能なエラーコード
出力	はい: [状態] が [成功] の場合	返す状態コード、ヘッダーの内容、省略可能な本文

次に示すのは、[状態] を [失敗] に設定した場合の例です。[エラー] フィールドを選び、[エラーメッセージ] と [エラーコード] プロパティの値を指定する必要があります。

準備ができたら、[保存] を選びます。

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

モック出力が使われているワークフローの実行を見つけるには、このトピックで後述する静的な結果を使用した実行の検索に関するセクションをご覧ください。

Azure portal で、Standard ロジックアプリのワークフローをデザイナーで開きます。
デザイナーで、モック出力を返すアクションを選びます。
アクション情報ペインで、[テスト] を選びます。次はその例です。
[テスト] タブで、[静的な結果の有効化] を選びます。

[フィールドの選択] の一覧で、アクションの応答で返すモック出力を指定するプロパティを選びます。

使用できるプロパティは、選んだアクションの種類によって異なります。たとえば、HTTP アクションには次のセクションとプロパティがあります。

セクションまたはプロパティ	必須	内容
Status	はい	返すアクションの状態。 - [成功] を選んだ場合は、[フィールドの選択] の一覧から [出力] も選ぶ必要があります。 - [失敗] を選んだ場合は、[フィールドの選択] の一覧から [エラー] も選ぶ必要があります。
コード	いいえ	アクションに対して返す特定のコード
エラー	はい: [状態] が [失敗] の場合	返すエラーメッセージと省略可能なエラーコード
出力	はい: [状態] が [成功] の場合	返す状態コード、ヘッダーの内容、省略可能な本文

準備ができたら、[保存] を選びます。

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

モック出力が使われているワークフローの実行を見つけるには、このトピックで後述する静的な結果を使用した実行の検索に関するセクションをご覧ください。

モック出力が使われている実行を検索する

従量課金プラン
Standard

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

Azure portal で、従量課金ロジックアプリのワークフローをデザイナーで開きます。
ロジックアプリのリソースメニューで、 [概要] を選択します。
選ばれていない場合は、[要点] セクションの [実行の履歴] を選びます。
[実行の履歴] テーブルの下で [静的な結果] 列を見つけます。

モック出力のあるアクションを含むどの実行でも、たとえば次のように、[静的な結果] 列が [有効] に設定されています。
実行内でモック出力が使われているアクションを表示するには、[静的な結果] 列が [有効] に設定されている実行を選びます。

ワークフロー実行の詳細ペインで、静的な結果を使うアクションには、次のようなテストビーカーアイコン () が表示されます。