導入
オープンソースのカスタム コネクタを作成し、すべてのユーザーが簡単に利用できるよう認定することができます。 オープンソースにすることで、コネクタが Microsoft Power Platform GitHub リポジトリ に公開されるようになります。 リポジトリからは、どのユーザーでもカスタム コネクタ定義を環境にインポートして使用したり、コネクタの共同作成に参加して導入を検討したりすることができます。 カスタム コネクタを作成した場合、自分自身およびコネクタを明示的に共有したユーザーだけが使用できます。 Microsoft Power Automate、Microsoft Power Apps、Microsoft Azure Logic Apps のすべてのユーザーの公式コネクタ一覧にコネクタを表示するには、認定する必要があります。
カスタム コネクタの認定が必要となるケース
カスタム コネクタの認証には多くの理由がありますが、API を使いやすくする、認知度を高める、リーチを拡大するというのが主な理由です。 カスタム コネクタが社内向けではなく、幅広いユーザーにとって役立つ API へのアクセスを提供している場合は、そのカスタム コネクタを認定しましょう。 API の基礎となるサービスを Microsoft テクノロジでホストする必要はありません。 実際、コネクタは、Microsoft 以外のソリューションと Microsoft Power Platform ソリューションを統合する場合に便利です。 コネクタは、無償 API 用でも有償 API 用でも認定できます。
公開前に、認定コネクタが認定基準を満たしているかどうかが確認されます。 コネクタの発行者には、検証済み発行者と独立系発行者の 2 つのタイプがあります。
検証済み発行者 - 主な要件は、基礎となるサービスを所有するか、API を使用する明示的な権限を提示して、製品に適したユーザー シナリオを提供することです。
独立系発行者 - コネクタの背後にある基礎となるサービスを所有していません。 たとえば、API のユーザーが会社に所属していない場合、そのユーザーは API 用のコネクタを送信することで、コネクタの認定を受けることができます。 発行者がこのタイプである場合、コミュニティ内のユーザーは、Power Platform コネクタ エコシステムに参加できるようになります。
コネクタの初回の認定と更新は無料です。 次のユニットでは、認定プロセスについて詳しく説明します。
オープンソースのカスタム コネクタを作成するケース
作成したカスタム コネクタが他のユーザーにとってもメリットとなると判断した場合、どれもオープンソース化の候補となります。 コネクタを認証する場合、最初のステップとして定義をオープンソースにします。 まず、作成しようとしている API のリポジトリに既存のカスタム コネクタ定義が存在するかどうかを確認します。 定義が見つかった場合、重複するコネクタを作成するのではなく、pull request を送信することで、共同作成によってコネクタを改善するための変更を行うことをお勧めします。
オープンソースのカスタム コネクタの作成に最適なケースと適していないケースの例を次に示します。
| オープンソースに最適な例 | オープンソースに適していない例 |
|---|---|
| 誰でも使用できるように公開されている API 用のコネクタ | 社内ネットワーク内でのみ使用できるプライベート API 用のコネクタ |
ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、「共同作成者使用許諾契約書」を参照してください。
GitHub リポジトリには、コネクタが存在する 3 つのメイン フォルダ (custom-connectors、independent-publisher-connectors、certified-connectors) があります。
custom-connectors フォルダーには、完全に機能するコネクタ サンプルが格納されており、機能の拡張やコネクタの使用を目的として、Microsoft Power Platform に展開することができます。 これらのサンプルは、認定コネクタではない場合がありますが、オープンソース コミュニティによって作成および管理されており、コネクタの概念に基づく有用なシナリオや例が提供されます。
independent-publisher-connectors フォルダーには、コネクタの背後にある基礎となるサービスを所有していない発行者が送信したコネクタが格納されています。 これらのコネクタは、Power Platform 内でプレミアム コネクタとして展開し、使用することができます。 このフォルダへの新しいコネクタの送信、このフォルダ内にあるコネクタへの機能追加、このフォルダ内にあるコネクタに関連する問題の解決は、誰でも実行できます。 このフォルダは、独立系発行者コネクタのコミュニティによって管理されます。このコミュニティは、独立系発行者やプロジェクト コーディネーターによって構成されます。 master ブランチは Microsoft コネクタ認定チームによって管理され、コネクタのバージョンは Power Platform に展開されているバージョンと同一のバージョンになっています。 dev ブランチはコネクタの管理者と Microsoft コネクタ認定チームによって管理され、バージョンの認定および展開前にコミュニティがコネクタを開発できるようにしています。
certified-connectors フォルダーには、既に展開済みであり、Microsoft Power Platform 内ですぐに使用できる認定コネクタが格納されています。 Microsoft コネクタ認定プログラムの要件は、新しい認定コネクタをコミュニティが共同作成できるオープンソースにすることです。 Microsoft コネクタ認定チームは、certified-connectors フォルダーを管理してており、master ブランチ内のコネクタのバージョンが Microsoft Power Platform に展開されているバージョンと同じになるようにしています。 dev ブランチはコネクタの所有者と Microsoft コネクタ認定チームによって管理され、バージョンの認定および展開前にコミュニティがコネクタを開発できるようにしています。
GitHub リポジトリを共同作成するには、まずリポジトリの独自のコピーを取得 (つまり、フォークを作成) します。 手順については、フォークの作成 で説明されています。 フォークを作成したら、pull request を使用することで、コネクタを共同作成する準備が完了します。 Microsoft Power Platform コネクタ CLI を使用すると、コネクタ資産をダウンロードできます。
Microsoft Power Platform コネクタ CLI を使用したダウンロード
オープンソース コネクタの作成に必要なファイルを準備するには、Microsoft Power Platform コネクタ CLI から paconn ダウンロード コマンドを使用します。
次のコマンドを実行してカスタム コネクタ ファイルをダウンロードします。
paconn download
このコマンドを実行すると、デバイス サインインが行われ、ユーザーに代わって paconn が Microsoft Power Platform 環境にアクセスできるようになります。 認証が完了すると、paconn により環境の一覧が表示され、環境を選択できます。その後、コネクタの一覧が表示され、コネクタを選択できます。
環境 ID とコネクタ ID がわかっている場合、次のコマンド ライン構文を使用することで、それらの ID を求めるメッセージをスキップできます。
paconn download -e [Microsoft Power Platform Environment GUID] -c [Connector ID]
ダウンロードには次の 4 つのファイルが含まれています。
apiDefintion.swagger.json - 含まれているコネクタ (すべてのトリガーやアクションなど) の OpenAPI 定義。
apiProperties.json - ポリシー テンプレートと、OpenAPI 仕様の一部ではないその他の拡張コネクタ プロパティを定義します。
icon.png - コネクタが使用されているときにデザイナーでサービスを表すために使用される小さいアイコン。
settings.json - paconn にパラメーターを提供する代わりに使用されます。
カスタム コネクタをオープンソースにして認定すると、API の知名度が高まります。 オープンソース リポジトリでコネクタ定義を共同作成することで、他のユーザーがカスタム コネクタを使用できるようになります。 認定コネクタを使用しているユーザーは、更新が公開されると自動的に更新される定義を使用していることになります。 オープンソース コネクタの定義を使用している場合、ユーザーは自分のコピーに更新を適用する必要があります。 このモジュールの残りの部分では、カスタム コネクタを認定する方法と、進展に伴ってライフサイクルを管理する方法について説明します。