演習 - 認定済みカスタム コネクタを作成する
この演習では、paconn CLI を使用してコネクタをダウンロードし、定義を検証して問題を解決します。 そして、オープンソースのカスタム コネクタの作成と認証を準備するために行うことをシミュレートします。
この演習を行うには、Python をインストールし、演習に使用しているコンピューターでコマンド プロンプトにアクセスする必要があります。
重要
Microsoft Dataverse がプロビジョニングされているテスト環境を使用してください。 テスト環境がない場合は、コミュニティ計画に新規登録できます。
注
次のファイルをローカル コンピューターにダウンロードして、この演習の Contoso Invoicing Triggers を完成させます。 画面の右中央部分の [ダウンロード] ボタンを選択します。
ソリューションをインポートする
このタスクでは、Contoso Invoicing カスタム コネクタを含む管理されていないソリューションをインポートします。 このコネクタは、この演習のタスクを実行するために使用します。
Power Apps Maker Portal に移動し、適切な環境にいることを確認します。
ソリューション > ソリューションのインポートを選択します。
参照を選択します。
ContosoInvoicingOpenSource_1_0_0_0.zip ソリューションを選択し、開くを選択します。
次へを選択します。
インポートを選択し、インポートが完了するのを待ちます。 インポートが完了すると、成功メッセージが表示されます。
インポートした Contoso Invoicing - Open Source ソリューションを開きます。
Contoso Invoicing - Open Source カスタム コネクタ コンポーネントが表示されます。
Microsoft Power Platform コネクタ CLI をインストールする
Microsoft Power Platform コネクタ CLI には、Microsoft Power Platform カスタム コネクタの開発に役立つ paconn コマンド ライン ツールが含まれています。 paconn ツールでは Python ランタイムが使用されるため、これもインストールします。
Python のダウンロードに移動し、Python のダウンロード ボタンを選択します。 3.5 よりも大きい任意のバージョンを使用できます。
インストールを開始するには、ダウンロードした .exe ファイルを選択します。
Python xx を PATH に追加するチェック ボックスをオンにし、今すぐインストールを選択してインストールが完了するのを待ちます。
インストールが完了したら、インストール ウィザードを閉じます。
コマンド プロンプトを起動し、次のコマンドを実行して paconn をインストールします。
pip install paconnインストールが完了するまで待ちます。
コネクタをローカルにダウンロードする
このタスクでは、ホスト URL プロパティを追加できるように、コネクタ定義ファイルをローカルにダウンロードします。
paconn loginコマンドを実行します。用意されたコードをコピーします。
ブラウザーで、環境と同じ資格情報を使ってサインインします。 Microsoft デバイス ログインに移動し、コピーしたコードを貼り付け、次へを選択します。
資格情報を入力します。
続行を選択します。
サインインの成功メッセージが表示されます。
コマンド プロンプトに戻ると、ログイン成功メッセージが表示されます。
ダウンロード コマンドを実行します。
paconn download環境を選択するように求められたら、ソリューションをインストールした環境の番号を入力します。 キーボードの Enter キーを押します。
Contoso Invoicing - Open Source コネクタの番号を指定してから、キーボードの Enter キーを押します。
ダウンロードが正常に完了します。 コネクタがダウンロードされた場所をメモします。
コネクタの検証、エラーの修正、メタデータの追加
このタスクでは、コネクタを検証して、一般的なエラーを修正し、必要なコネクタ メタデータを追加します。
コネクタがダウンロードされたパスをコピーします。
コピーしたパスと API 定義の Swagger ファイル名 \apiDefinition.swagger.json を使用して、検証コマンドを実行します。
paconn validate --api-def [Path to apiDefinition.swagger.json]ListInvoices アクションの 4 番目のパラメーターの概要が欠落している場合、および contact プロパティが欠落している場合は、エラーが表示されます。
欠落している概要を修正します。 Power Apps Maker Portal に移動し、適切な環境にいることを確認します。
ソリューションを選択し、Contoso Invoicing - Open Source ソリューションを開きます。
Contoso Invoicing - Open Source コネクタを選択して、編集を選択します。
定義タブを選択して、ListInvoices アクションを選択します。
要求セクションまで下にスクロールし、toAmount パラメーターの横にあるボタン (V 字型ボタン) をクリックして、編集を選択します。
集計フィールドに終了金額を入力して、コネクタの更新を選択します。
コネクタの更新が完了するまで待ちます。
以前にダウンロードしたコネクタを削除します (すぐに再追加します)。 ダウンロードしたコネクタをコンピューターから削除します。
コネクタをもう一度ダウンロードします。 コマンド プロンプトに戻ってダウンロード コマンドをもう一度実行します。
paconn download環境を選択するように求められたら、ソリューションをインストールした環境の番号を入力します。 キーボードの Enter キーを押します。
Contoso Invoicing - Open Source コネクタの番号を指定してから、キーボードの Enter キーを押します。
ダウンロードが正常に完了します。 コネクタがダウンロードされた場所をメモします。
コピーしたパスと API 定義の Swagger ファイル名 \apiDefinition.swagger.json を使用して、検証コマンドを実行します。
paconn validate --api-def [Path to apiDefinition.swagger.json]これで、欠落している連絡先パラメーターに対するエラーが 1 件だけ表示されます。
ダウンロードしたコネクタ フォルダーに移動し、注帳などの任意のテキスト エディターを使用して apiDefinition.swagger.json ファイルを開きます。
description プロパティの後の情報に contact プロパティを追加します。
"contact": { "name": "Contoso Support", "url": "https://contosoinvoicingtest.azurewebsites.net", "email": "info@Contoso.com" }情報の後にコネクタ メタデータを追加します。
"x-ms-connector-metadata": [ { "propertyName": "Website", "propertyValue": "https://contosoinvoicingtest.azurewebsites.net" }, { "propertyName": "Privacy policy", "propertyValue": "https://contosoinvoicingtest.azurewebsites.net" }, { "propertyName": "Categories", "propertyValue": "Productivity" } ],ファイルを選択して、変更を保存します。
検証コマンドをもう 1 回実行します。
paconn validate --api-def [Path to apiDefinition.swagger.json]
これで、コネクタが正常に検証されます。
オープンソースとして作成され、認証されるコネクタの準備が整いました。 実際のコネクタを作成するとき、そのコネクタを GitHub に公開する必要があります。