変更要約: PL-400 第4章を新規作成（ドメイン: プラットフォーム拡張の後半）。カスタムコネクタ（Open API 定義・認証 OAuth/API キー/Basic・ポリシーテンプレート・Azure Function・データ変換）、プラットフォーム API と Azure Functions（Dataverse Web API OData・Organization service .NET SDK・throttling/retry・OAuth・楽観的同時実行/ExecuteMultiple・Azure Functions long-running/トリガー/マネージド ID）、Power Automate クラウドフロー（Dataverse connector・式・Azure Key Vault・エラー処理 run after・trigger filter/retry・child flows・Entra ID サービスプリンシパル）。
4.1カスタムコネクタ
Open API 定義、認証方式、ポリシーテンプレート、Azure サービス/GitHub からのインポート、データ変換を理解します。
カスタムコネクタ は外部の REST API を Power Platform から使えるようにラップ する仕組みです。定義と認証を正しく設計します。
4.1.1Open API 定義と認証
コネクタの API 仕様は Open API 定義（Swagger） で記述します（操作・パラメーター・応答）。Azure サービス・既存の Open API・GitHub からインポートして作成できます。認証は OAuth 2.0 / API キー / Basic などから選び、対象 API の要件に合わせます。Azure Function をバックエンドにしてカスタムロジック付きのコネクタを作ることもできます。
4.1.2ポリシーテンプレートとデータ変換
ポリシーテンプレート は 実行時にコネクタの動作を変更する仕組みで、ヘッダーの設定/変換、ホスト URL の変更、パラメーターの変換などをコードなしで行えます。応答データの整形が必要なら データ変換のコード を追加します。Open API（API の記述）とポリシーテンプレート（実行時の挙動変更）は役割が異なります。
決め手：「REST APIの操作/パラメーター/応答を記述」＝Open API定義(Swagger)。「実行時にヘッダー/URL/パラメーターを変更」＝ポリシーテンプレート。「認証はOAuth2.0/APIキー/Basic」。「バックエンドにカスタムロジック」＝Azure Function。カスタムコネクタ(外部API取込)とcustom API(Dataverse内独自操作)は別。
混同に注意：
①Open API定義(API記述)とポリシーテンプレート(実行時挙動変更)を取り違えない。
②カスタムコネクタ(外部API)とcustom API(Dataverse内)は別物。
③認証方式は対象APIの要件に合わせる。
④データ変換は応答整形でAPI定義そのものではない。
4.1.3この節のまとめ
- Open API定義(Swagger)でREST APIを記述・Azure/GitHubからインポート
- 認証=OAuth2.0/APIキー/Basic・Azure Functionをバックエンドに
- ポリシーテンプレートで実行時の挙動(ヘッダー/URL)を変更
進捗の記録にはログインが必要です。
理解度チェック
（軽い確認用）Q1. 外部 REST API の操作・パラメーター・応答を記述してカスタムコネクタを定義したい。最適なのはどれですか？
Q2. カスタムコネクタで実行時にリクエストヘッダーを設定/変換するなど、挙動をコードなしで変更したい。最適なのはどれですか？
Q3. カスタムコネクタのバックエンドにカスタムロジックを置きたい。最適なのはどれですか？
Q4. カスタムコネクタの認証方式として、対象 API の要件に応じて選べるものはどれですか？
Q5. カスタムコネクタと custom API の違いとして正しいのはどれですか？