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

  • 5 分

この演習では、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. 説明に Contoso 社請求書 API と入力します。

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

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

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

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

タスク 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 の横に警告を示すオレンジ色の三角が表示されています。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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