演習 - ソリューションでの新しい接続の作成

  • 6 分

この演習では、Contoso Invoicing という既存の API に対して最初のカスタム コネクタを作成します。

重要

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

タスク 1: API を確認する

API を確認するには、次の手順に従います。

  1. Contoso Invoicing に移動します。

  2. ドキュメントのリンクを選択します。

    API のドキュメントのリンクを矢印で示しているスクリーンショット。

  3. 使用できる操作を確認します。

  4. 各操作を選択して展開および確認します。

  5. ドキュメントのブラウザーのタブまたはウィンドウを閉じます。

  6. Open API 定義のリンクを選択します。

  7. 次の図は、ドキュメントのページに表示された OpenAPI のバージョンの例を示しています。 右クリックして、名前を付けて保存を選択します。

    [名前を付けて保存] ボタンを矢印で示しているスクリーンショット。

  8. ファイルをローカル環境に保存します。 このファイルは、後でこの演習で使用します。

  9. 定義のブラウザーのタブまたはウィンドウを閉じます。

  10. API キー のリンクを選択します。

  11. この API キーは後で必要になるため、コピーして保存します。

    Contoso Invoicing の API キーのスクリーンショット。

  12. ホームに戻る を選択します。

  13. ロゴをダウンロード を選択します。

  14. ロゴ画像をローカルに保存します。これは後で使用します。

タスク 2: 新しいソリューションを作成する

新しいソリューションを作成するには、次の手順に従います。

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

  2. ソリューション > + 新しいソリューションを選択します。

  3. 表示名に Contoso 社請求書と入力し、公開元で CDS Default Publisher (CDS の既定の公開元) を選択して、作成を選択します。 実際のプロジェクトで作業している場合は、独自の公開元を作成してください。

    新しい Contoso Invoicing ソリューションを作成しているスクリーンショット。

  4. 作成を選択した後も、このページから移動しないでください。

タスク 3: 新しいコネクタを作成する

新しいコネクタを作成するには、次の手順に従います。

  1. 作成した Contoso Invoicing ソリューションを開きます。

  2. + 新規 > 自動化 > カスタム コネクタを選択します。

    新しいカスタム接続の作成を矢印で示しているスクリーンショット。

  3. コネクタ名に Contoso 社請求書と入力し、画像のアップロードを選択します。

    アイコン画像のアップロード ボタンを矢印で示しているスクリーンショット。

  4. タスク 1: API を確認するでダウンロードしたコネクタのロゴ画像を選択します。

  5. アイコンの背景色 に #175497 を入力します。

  6. ホスト に contosoinvoicingtest.azurewebsites.net と入力します。

  7. コネクタの作成を選択します。

    コネクタの作成ボタンを矢印で示しているスクリーンショット。

  8. このページから移動しないでください。

タスク 4: OpenAPI 定義をインポートする

OpenAPI 定義をインポートには、次の手順に従います。

  1. コネクタ名の横にある矢印を選択します。

    戻るボタンを矢印で示しているスクリーンショット。

  2. コネクタの省略記号 (...) ボタンを選択して、OpenAPI ファイルから更新するを選択します。

    [OpenAPI ファイルから更新する] ボタンを矢印で示しているスクリーンショット。

  3. インポートを選択します。

  4. タスク 1: API を確認するでダウンロードした swagger.json ファイルを選択して、開くを選択します。

  5. 続行を選択します。

  6. ホスト URL に contosoinvoicingtest.azurewebsites.net と入力し、セキュリティを選択します。

    セキュリティ タブを矢印で示しているスクリーンショット。

  7. フィールドがインポートしたファイルから入力されます。

  8. このページから移動しないでください。

タスク 5: 定義を確認および調整する

定義を確認および調整するには、次の手順に従います。

  1. 定義タブを選択します。

  2. インポートした操作をしばらく確認します。

  3. GetInvoice の横にある、注意する必要がある何かを示す青色の情報アイコンに注目してください。

    GetInvoice アクションを矢印で示しているスクリーンショット。

  4. GetInvoice 操作を選択します。

  5. この操作には 概要 がないことがわかります。

  6. ユーザビリティを向上させるために、概要 に 請求書の取得 と入力します。

    GetInvoice アクションの概要のスクリーンショット。

  7. PayInvoice 操作に情報を示す青色の丸が表示されており、説明がないことがわかります。

  8. 説明 に 請求書の支払い と入力します。

  9. NewInvoice 操作は使用しないため、どちらも削除します。

    [削除] ボタンを矢印で示しているスクリーンショット。

  10. GetInvoiceSchema 操作を選択します。

  11. 表示オプションを内部に変更して、ユーザーのアクション リストに表示されないようにします。

  12. コネクタの更新を選択します。

    コネクタの更新ボタンを矢印で示しているスクリーンショット。

  13. このページから移動しないでください。

タスク 6: コネクタをテストする

コネクタをテストするには、次の手順に従います。

  1. テスト タブを選択します。

  2. + 新しい接続を選択します。

    新しい接続ボタンを矢印で示しているスクリーンショット。

  3. タスク 1: API を確認するで保存した API キーを貼り付けて、接続の作成を選択します。

  4. 更新ボタンを選択します。

    [更新] ボタンを矢印で示しているスクリーンショット。

  5. ListInvoiceTypes > 操作のテストを選択します。

    [操作のテスト] ボタンを矢印で示しているスクリーンショット

本文の領域にいくつかの請求書データが表示されます。