カスタム コネクタを認定する
Logic Apps、Power Automate、Power Apps のすべてのユーザーがカスタム コネクタを認定コネクタとして利用できるようにするには、Microsoft にコネクタを送信して認定を受けます。 Microsoft ではコネクタを確認し、認定資格基準を満たした場合、発行を承認します。 発行されたコネクタは、パブリックに利用可能なコネクタの 完全な一覧 に加えられます。
このユニットでは、認定プロセスのいくつかの高次の手順を含む各手順について検証していきます。 これら同手順は後の更新にも適用されますが、更新の範囲によっては大幅に処理時間が短縮されます。
計画
計画は、コネクタの外観を想定し始める認定プロセスの最初の手順です。 他のユーザーが使用するコネクタの作成には、ある程度の計画が必要です。
最初の手順では、コネクタがまだ存在しないことを確認します。コネクタがある場合、Microsoft では同じ API に対して複数のコネクタを認定しないため、提案された変更を既存のコネクタに提供することを検討する必要があります。
考慮する必要がある重要な計画要因を次に示します。
最初に使用できるトリガーおよびアクションを特定します。 API を 100% カバーする必要はありませんが、最初のトリガーとアクションは有用なものでなければなりません。 初期バージョンでの使用に制限が多すぎると、一般的なシナリオ向けの機能が欠落しているという不満がユーザーに生まれます。 コネクタを使用して、Microsoft Power Automate で作成できる 1 つ以上のワークフローを書き出したりスケッチしてみたりしてください。 このアプローチは、コネクタに含める API を決定するのに役立ちます。
トリガーをサポートしたり、ユーザーフレンドリーなコネクタを提供する能力を向上させたりするために API に必要な変更を評価します。
認証がどのように処理されるか、そして API の現在の認証方法とカスタム コネクタでサポートされている機能との間で必要な適応について検討します。
API で API キーを使用する場合、コネクタを使用するユーザーがどのようにキーを取得するかを検討します。
コネクタ ポリシー テンプレートをレビューして、テンプレートの実装がコネクタの使い勝手に役立つかどうかを判断します。
サポートされている OpenAPI 拡張機能の適用可能性を確認してください。 たとえば、テスト接続は一般に認定コネクタによって実装されます。 また、動的値の拡張子を使用すると、選択できる値のリストを含むパラメーターがある場合に役立ちます。
新しいコネクタ認定の場合、認定に登録するコネクタの開発が完了するまで待つ必要はありません。 詳細については、「検証済み発行者の認定プロセス」または「独立系発行者の認定プロセス」を参照してください。 Microsoft の担当者からご連絡させていただきます。担当者は、カスタム コネクタの理解を深めるお手伝いをし、開発の進捗状況を説明して、認定プロセスについてご案内します。
認定コネクタを更新する場合、計画で最も重要なのは、既存のユーザーに影響を与えないことです。 この問題については、後のユニットで詳しく説明します。
開発
開発ステップの主な焦点は、API とカスタム コネクタの定義を送信できる状態にすることです。 次の手順に進む前に、カスタム コネクタ定義がクリーンアップされ、発行する適切な名前付けがすべて完了していることを確認する必要があります。
オープンソースを作成する
導入ユニットでは、オープンソース コネクタの作成方法に関する大まかな導入について説明しました。 検証済み発行者の認定コネクタを certified-connectors フォルダーに配置し、独立系発行者のコネクタを independent-publisher-connectors フォルダーに配置します。 pull request を送信する前に、次のタスクを行う必要があります。
コネクタ ファイルを編集して、特定の必須メタデータを追加します。 コネクタ ファイルには、コネクタとそのエンド サービスを説明する特定のメタデータが含まれている必要があります。
ダウンロードしたコネクタでファイル名を指定して paconn 検証コマンドを実行し、エラーを解決します。
検証を実行するには、次のコマンドを使用します。
paconn validate --api-def [Location of apiDefinition.swagger.json]
検証に合格した後、pull request を GitHub リポジトリの dev ブランチに送信できます。 このアクションにより、pull request の初回検証を行う自動プロセスが開始され、適切な貢献者契約が締結されます。 自動検証が完了すると、その検証の初回レビューが Microsoft に割り当てられます。 レビュー担当者は修正する必要がある問題を見つけると、pull request に関するコメントを入力します。ユーザーは、それらの問題を解決して、pull request を再送信するよう求められます。 すべて問題がないと考えられる場合は、pull request がリポジトリに結合されます。
独立系発行者に関する送信
独立系発行者のコネクタを公開する場合、次の手順では、コネクタの提案時に作成した pull request にコネクタ アーティファクトを送信し、pull request テンプレートのチェックリストに入力して、pull request のタイトルから "提案 -" を削除します。 Microsoft 認定エンジニアは、最初の要求後、1 週間または 2 週間以内にフィードバックを提供します。 フィードバックでコネクタへの更新が必要と提案されている場合は、pull request の更新を送信する必要があります。 1 回だけです。
検証済み発行者に関する送信
次の手順は、Microsoft の担当者から求められたら、コネクタを ISV Studio に送信して認定を受けることです。 ISV Studio は認定プロセスの残り部分を管理するためのポータルであり、デプロイ後のコネクタの状態を把握することができます。
認定を受けるために ISV Studio に送信するプロセスの一環として、次の情報を提供する準備を整えておきます。
コネクタのテスト情報 (APIキー、その他の認証詳細、またはテスターがコネクタを使用する際に役立つ情報など)。
コネクタのパブリック ドキュメントに記載する情報が含まれる
Intro.mdファイル。 テンプレートについては、ISV Studio への送信に関するドキュメントを参照してください。
認定が進行すると、ポータルで更新状況が表示され、主要連絡先からメールが届きます。 問題が発生した場合は、認定が続行される前に問題を解決することが求められます。 コネクタが認定資格に合格すると、テスト用に "プレビュー" リージョンへのデプロイがスケジュールされます。
テスト
認定プロセスの一環として、コネクタは "プレビュー" リージョンにデプロイされてテストします。 ここが、世界の全リージョンにデプロイされる前に、デプロイされたコネクタが正常に動作することを確認するチャンスです。 Power Apps、Power Automate、および Logic Apps で、コネクタのすべての機能をテストしてください。
詳細については、認定でコネクタをテストする方法を参照してください。
デプロイ
テストが完了すると、コネクタがすべてのパブリック リージョンにデプロイされます。 このプロセスは 7～10 営業日ほどかかります。これは、Microsoft が全世界のリージョンに徐々にデプロイを行うためです。 各リージョンにデプロイされると通知が届きます。
サポート
これで、コネクタが公開リリースされたので、ISV Studio から検証済み発行者のコネクタのパフォーマンスを監視することが可能になりました。 問題が発生しているユーザーをサポートできるように、サポート スタッフは、Power Apps または Power Automate でコネクタがどのように使用されるかを把握しておく必要があります。