演習 - CLI を使用してコネクタをダウンロードする

完了

この演習では、CLI を使用してコネクタをダウンロードし、定義を検証して問題を解決します。 そして、オープンソースのカスタム コネクタの作成と認証を準備するために行うことをシミュレートします。

この演習を行うには、Python をインストールし、演習に使用しているコンピューターでコマンド プロンプトにアクセスする必要があります。

重要

Microsoft Dataverse がプロビジョニングされているテスト環境を使用してください。 テスト環境がない場合は、コミュニティ計画 に新規登録できます。

注意

次のファイルをローカル コンピューターにダウンロードして、この演習の Contoso Invoicing トリガー を完成させます。 画面の右中央の [ダウンロード] ボタンを選択します。

タスク 1: ソリューションをインポートする

このタスクでは、Contoso Invoicing カスタム コネクタを含むアンマネージド ソリューションをインポートします。 このコネクタは、この演習のタスクを実行するために使用します。

  1. Power Apps 作成者ポータル に移動し、適切な環境にいることを確認します。

  2. ソリューション > インポート を選択します。

  3. 参照 を選択します。

  4. ContosoInvoicingOpenSource_1_0_0_0.zip ソリューションを選択し、開く を選択します。

  5. 次へ を選択します。

  6. インポート を選択し、インポートが完了するのを待ちます。 インポートが完了すると、成功メッセージが表示されます。

  7. インポートした Contoso Invoicing - オープンソース ソリューションを選択します。

    Contoso Invoicing - オープンソース カスタム コネクタ コンポーネントが表示されます。

    Contoso Invoicing  - オープンソースのソリューション コンポーネントのスクリーンショット。

タスク 2: Microsoft Power Platform CLI をインストールする

Microsoft Power Platform CLI には、Microsoft Power Platform カスタム コネクタの開発に役立つ paconn コマンド ライン ツールが含まれています。 paconn ツールでは Python ランタイムが使用されるため、これもインストールします。

  1. Python のダウンロード に移動し、Python のダウンロード を選択します。 3.5 よりも大きい任意のバージョンを使用できます。

  2. インストールを開始するには、ダウンロードした .exe ファイルを選択します。

  3. Python xx を PATH に追加する チェック ボックスをオンにし、今すぐインストール を選択してインストールが完了するのを待ちます。

    [Python のインストール] ダイアログ ボックスのスクリーンショット。

  4. インストールが完了したら、インストール ウィザードを閉じます。

  5. コマンド プロンプトを起動し、次のコマンドを実行して paconn をインストールします。

    pip install paconn

    paconn のインストール コマンドを示すコマンド プロンプトのスクリーンショット。

  6. インストールが完了するまで待ちます。

タスク 3: コネクタをローカルにダウンロードする

このタスクでは、ホスト URL プロパティを追加できるように、コネクタ定義ファイルをローカルにダウンロードします。

  1. ログイン コマンドを実行します。

    paconn login

  2. 用意された コード をコピーします。

    コピーするコードを含むログイン コマンド応答のスクリーンショット。

  3. ブラウザーで、環境と同じ資格情報を使ってログインします。 Microsoft デバイス ログイン に移動し、コピーした コード を貼り付け、次へ を選択します。

  4. 資格情報を入力します。

    サインインの成功メッセージが表示されます。

    サインインの成功メッセージのスクリーンショット。

  5. コマンド プロンプトに戻ると、ログイン成功メッセージが表示されます。

  6. ダウンロード コマンドを実行します。

    paconn download

  7. 環境を選択するように求められたら、ソリューションをインストールした環境の番号を入力し、Enter キーを押します。

  8. Contoso Invoicing - オープンソース コネクタの番号を指定してから、Enter キーを押します。

  9. ダウンロードが正常に完了します。 コネクタがダウンロードされた場所をメモします。

タスク4: 検証する

このタスクでは、コネクタを検証し、一般的なエラーを修正します。 また、必要なコネクタ メタデータも追加します。

  1. コネクタがダウンロードされたパスをコピーします。

    コマンド ウィンドウで選択したコネクタ パスのスクリーンショット。

  2. コピーしたパスと API 定義の Swagger ファイル名 \apiDefinition.swagger.json を使用して、検証コマンドを実行します。

    paconn validate --api-def [Path to apiDefinition.swagger.json]

    コマンド ウィンドウの検証コマンドを示すスクリーンショット。

  3. ListInvoices アクションの 4 番目のパラメーターの概要が欠落している場合、および contact プロパティが欠落している場合は、エラーが表示されます。

    コマンド ウィンドウの検証エラーのスクリーンショット。

  4. 欠落している概要を修正します。 Power Apps 作成者ポータル に移動し、適切な環境にいることを確認します。

  5. Contoso Invoicing - オープンソース コネクタを選択して、編集 を選択します。

    [カスタム コネクタの編集] ボタンを指している矢印。

  6. 定義 タブを選択して、ListInvoices アクションを選択します。

  7. 要求 セクションまで下にスクロールし、toAmount パラメーターの省略記号 (...) ボタンを選択して、編集 を選択します。

    [パラメーターの編集] ボタンを指している矢印。

  8. 集計 フィールドに 終了金額 を入力して、コネクタの更新 を選択します。

    [コネクタの更新] ボタンを指している矢印。

  9. コネクタの更新が完了するまで待ちます。

  10. 以前にダウンロードしたコネクタを削除します (すぐに再追加します)。 ダウンロードしたコネクタをコンピューターから削除します。

  11. コネクタをもう一度ダウンロードします。 コマンド プロンプトに戻ってダウンロード コマンドをもう一度実行します。

    paconn download

  12. 環境を選択するように求められたら、ソリューションをインストールした環境の番号を入力し、Enter キーを押します。

  13. Contoso Invoicing - オープンソース コネクタの番号を指定してから、Enter キーを押します。

  14. ダウンロードが正常に完了します。 コネクタがダウンロードされた場所をメモします。

  15. コピーしたパスと API 定義の Swagger ファイル名 \apiDefinition.swagger.json を使用して、検証コマンドを実行します。

    paconn validate --api-def [Path to apiDefinition.swagger.json]

  16. これで、欠落している連絡先パラメーターに対するエラーが 1 件だけ表示されます。

    検証エラー。

  17. ダウンロードしたコネクタ フォルダーに移動し、メモ帳などの任意のテキスト エディターを使用して apiDefinition.swagger.json ファイルを開きます。

    コネクタ定義ファイルを開きます。

  18. description プロパティの後の情報に contact プロパティを追加します。

    "contact": {
      "name": "Contoso Support",
      "url": "https://contosoinvoicingtest.azurewebsites.net",
      "email": "info@Contoso.com"
    }
    

    description プロパティの末尾にコンマを付けて Swagger 定義に追加された連絡先パラメーターのスクリーンショット。

  19. 情報の後にコネクタ メタデータを追加します。

    "x-ms-connector-metadata": [
      {
       "propertyName": "Website",
       "propertyValue": "https://contosoinvoicingtest.azurewebsites.net"
      },
      {
       "propertyName": "Privacy policy",
       "propertyValue": "https://contosoinvoicingtest.azurewebsites.net"
      },
      {
       "propertyName": "Categories",
       "propertyValue": "Productivity"
      }
    ],
    

    情報セクションの末尾にコンマを付けて情報の後に追加されたコネクタ メタデータのスクリーンショット。

  20. ファイル を選択して、変更を 保存 します。

  21. 検証コマンドをもう 1 回実行します。

    paconn validate --api-def [Path to apiDefinition.swagger.json]

  22. これで、コネクタが正常に検証されます。

コネクタの検証の成功を示すスクリーンショット。

オープンソースとして作成され、認証されるコネクタの準備が整いました。 実際のコネクタを作成する場合は、そのコネクタを GitHub に公開する必要があります。