導入
このモジュールでは、トリガー定義を使用してカスタム コネクタの機能を拡張する方法を説明します。
このモジュールの内容は次のとおりです。
カスタム コネクタのトリガーについて学習する。
トリガーを使用できる一般的なシナリオについて確認する。
さまざまなタイプのトリガーを特定する。
サービス API によって定義されるトリガーにカスタム コネクタ定義を拡張する方法について説明します。
トリガーを使用することで、システムが基になるデータまたはサービスの変更に対応する必要がある Microsoft Power Automate と Microsoft Azure Logic Apps でコネクタ機能を拡張できます。 トリガーを使用する最も一般的なシナリオは、「レコードが作成されたとき」など基になるデータが変更された場合、または「通知が生成されたとき」などカスタム コネクタによって定義されたサービスで特定のイベントが発生した場合に開始されるクラウド フローの作成です。
Power Automate および Logic Apps でのトリガー
Power Automate と Logic Apps は、クラウド フローまたは Logic Apps ワークフローを開始するイベントとして、トリガーを定義 します。 これらのイベントは、ユーザーによって開始され、カスタム コネクタを含むコネクタによってスケジュールまたは生成されます。 トリガー定義によって、カスタム コネクタが機能拡張され、これらのコネクタを使用してクラウド フローおよび Logic Apps ワークフローが開始されます。
ほとんどのコネクタでは、トリガーの概要が "<object> が <verb> される場合" として定義され、一般的なコネクタの実装には 1 つ以上のアクションが含まれます。
トリガーのタイプ
ボイスメール管理システムについて検討します。 そのようなシステムのトリガーが、「新しいメッセージを受信」イベントであるとします。 新しいボイスメールを受信したかどうかを識別する方法を定義するには、次の 2 つの方法があります。
定期的にボイスメール ボックスに電話をかけ、新しいメッセージを確認します。 この動作は、ポーリング トリガーを示します。つまり、データが基になるサービスからポーリングされる場所での実装です。 ポーリング トリガーは、新しいデータが使用可能かどうかを判断するために、定期的に構成可能な間隔でサービス API への呼び出しを開始する時間指定の活動です。 ポーリング トリガーをサポートするために、API は状態に基づいて結果をフィルター処理できます。 「昨日以降に受信したすべてのボイスメールに返信する」など、状態は一般的には時間ベースです。
新しいボイス メッセージを受信した場合、ボイスメール システムからユーザーにメールを送信させましょう。 この方法は、Webhook トリガーまたはサービスがデータをプッシュする実装を定義します。 Webhook トリガーをサポートするサービスは、通話の呼び戻しを行う関係者の一覧を管理し、通話の方法を確認できる必要があります。 ボイスメールの例では、メール アドレスの一覧および通知メールを送信する機能です。
基本的に、これらの 2 種類のトリガーは、どちらが運用管理を担当する側かによって異なります。
| ポーリング | Webhook |
|---|---|
| まず、状態を設定する | サービスに登録されている |
| 定期的に更新を確認する | イベントが発生した場合のシグナル |
| 前回の状態更新以降のすべての新しいデータを要求する | 自動的に破棄されているか |
| サービスが状態を管理する | Power Automate または Logic Apps が Webhook の登録と機能変更のプロセスを管理する |
重要
サービスに対して REST API を使用できるからといって、カスタム コネクタ トリガーを定義できるとは限りません。 基になるサービスは、データを差分的に返したり、Webhook 実装を提供する必要があります。 トリガーが必要とされるもののサービス API にどちらの機能もない場合、開発者は、ユーザーがトリガーを定義できるようにサービスの機能拡張を行う必要があります。
トリガーの定義
コネクタの定義の場合と同様に、どちらのタイプのトリガーも、エンドポイント、パラメーター、条件、および応答を指定する OpenAPI (Swagger) ドキュメントによって定義されます。 ただし、Microsoft Power Platform によって使用される OpenAPI 仕様のバージョンでは、アクションとトリガーは区別されません。 Microsoft Power Platform ではカスタム OpenAPI 拡張機能を追加して、トリガーとその内容を定義する仕様を拡張します。
トリガーのステップ バイ ステップ ウィザードを使用できます。このウィザードは、アクション ウィザードと同じ一般的なレイアウトに従います。
カスタム コネクタ アクションと同様に、適切なトリガーの概要を選択することが重要です。 この概要は、作成者がコネクタを検索するときに使用され、トリガーが選択されると、その概要が Power Automate および Logic Apps の既定の手順のタイトルになります。
ほとんどがカスタム コネクタ デザイナーで完全に作成できるアクションとは異なり、トリガーの方が複雑であり、多くの場合、手作業での変更が必要となります。 このモジュールでは、ポーリングおよび Webhook シナリオでのトリガー定義の作成方法について説明します。