Postman コレクションからカスタム コネクタを作成する

注意

このトピックは、Azure Logic Apps、Power Automate、および Power Apps でのカスタム コネクタの作成および使用に関するチュートリアル シリーズの一部です。 カスタム コネクタの概要 を必ず読んで、プロセスを理解してください。

カスタム コネクタを作成するには、接続したい API について記述して、コネクタが API の操作とデータ構造を認識できるようにする必要があります。 このトピックでは、カスタム コネクタを、Cognitive Services Text Analytics Sentiment API を説明する Postman コレクションを使用して作成します (このシリーズの例)。

API を説明する他の方法については、以下のトピックへ移動してください:

• OpenAPI 定義からカスタム コネクタを作成する

• カスタム コネクタを最初から作成する

前提条件

• 例の API を説明する Postman コレクション:

  • 作成した Postman コレクション をダウンロードする
    または
  • トピック カスタム コネクタの Postman コレクションを作成する を完了します カスタム コネクタを作成するときは、Postman コレクションが 1 MB を超えてはいけないので注意してください。

• Cognitive Services Text Analytics API の API キー

• 次のいずれかのサブスクリプション:

  • Logic Appsを使用している場合は、Azure
  • Power Automate
  • Power Apps

• Logic Apps を使用する場合は、最初に Azure Logic Apps カスタム コネクタを作成 します

Postman コレクションをインポートする

作成またはダウンロードした Postman コレクションを使用する準備ができました。 コレクションには必要な情報が多数含まれています。 この情報は、カスタム コネクタ ウィザードで確認および更新することもできます。 Logic Apps、または Power Automate および Power Apps の Postman コレクションのインポートから始めます。

Logic Apps 用の Postman コレクションをインポートする

1. Azure portal に移動し、以前に Azure Logic Apps カスタム コネクタの作成 で作成した Logic Apps コネクタを開きます。

2. コネクタのメニューで、Logic Apps コネクタ を選択し、次に 編集 を選択します。

   

3. 全般で Postman コレクション V1 をアップロードするを選択し、作成した Postman コレクションに移動します。

   

   ウィザードによってコレクションがインポートされ、その後、generatedApiDefinition.swagger.json という名前の OpenAPI 定義に変換されます。

注意

このチュートリアルでは REST API に焦点を当てていますが、Logic Apps で SOAP API を使用する こともできます。

Power Automate および Power Apps 用の Postman コレクションをインポートします

1. make.powerapps.com または flow.microsoft.com に移動します。

2. ナビゲーション ウィンドウで、データ > カスタム コネクタを選択します。

3. 新しいカスタム コネクタ を選択し、Postman コレクションをインポート を選択します。

4. カスタム コネクタの名前を入力し、ダウンロードまたは作成した Postman コレクションに移動し、続行を選択します。

   

   パラメーター	価値
   カスタム コネクタ タイトル	「SentimentDemo」

   ウィザードによってコレクションがインポートされ、その後、generatedApiDefinition.swagger.json という名前の OpenAPI 定義に変換されます。

全般的な詳細を更新する

この点から、Power Automate UI について説明しますが、その手順は、3 つのすべてのテクノロジ全体でそれほど変わりません。 違いがある場合は指摘します。

1. 全般 ページで、API のホストやベース URL など、Postman コレクションからインポートされた情報を確認します。 コネクタでは、ホストとベース URL を使用して、API を呼び出す方法を決定します。

   注意

   オンプレミス API への接続に関する詳細情報は、データ ゲートウェイを使用してオンプレミス API に接続する をご覧ください。

2. わかりやすい説明に更新します。 この説明は、カスタム コネクタの詳細に表示され、他のユーザーがそのコネクタがどのように役立つかを把握するうえで助けになります。

   パラメーター	値
   説明	"Cognitive Services Text Analytics センチメント API を使用して、テキストが肯定的か否定的かを判断します。"

認証の種類を指定する

カスタム コネクタでは認証に複数のオプションを使用できます。 Cognitive Services API では API キー認証が使用されます。

1. セキュリティ ページの 認証の種類 で API キーを選択します。

2. API キー で、パラメーターのラベル、名前、および場所を指定します。 表現力があり意味のあるラベルを選択します。 このテキストは、ユーザーがそのカスタム コネクタを使用して接続するときに表示されます。 パラメーターの名前と場所は、API で必要なものと一致する必要があります (この場合は Postman で指定したヘッダー)。 接続 を選択します。

   

   パラメーター	値
   パラメーターのラベル	"API キー"
   パラメーター名	"Ocp-Apim-Subscription-Key"
   パラメーターの場所	"ヘッダー"

3. ウィザードの上部で、名前が "SentimentDemo" に設定されていることを確認し、コネクタの作成 を選択します。

コネクタの定義を確認して更新する

カスタム コネクタ ウィザードには、コネクタがどのように機能し、ロジック アプリ、フロー、アプリで公開される方法を定義するための多くのオプションが用意されています。 このセクションでは、UI について説明し、いくつかのオプションについて説明しますが、自分で探索することもお勧めします。

UI と定義を確認する

特定の手順に入る前に 定義 ページでまず UI を見てみましょう。

1. この領域には、コネクタに対して定義されているアクション、トリガー (Logic Apps および Power Automate 用)、および参照が表示されます。 この場合、Postman コレクションからの DetectSentiment アクションが表示されました。 このコネクタにはトリガーがありませんが、カスタム コネクタのトリガーについては、Azure Logic Apps および Power Automate での webhook の使用 ページでご確認いただけます。

   

2. 全般領域には、現在選択されているアクションまたはトリガーに関する情報が表示されます。 この情報は、Postman コレクションから取得されます。 ロジック アプリまたはフローの操作とパラメーターに対する Visibility プロパティを含む情報 は、ここで編集できます。

   • 重要: 必ずユーザーに最初に表示
   • なし: 通常、ロジック アプリまたはフローで表示
   • advanced: 最初は追加メニューに表示されません
   • internal: ユーザーに表示されません

3. 要求 領域には、Postman コレクションに含まれる HTTP 要求に基づいて情報が表示されます。 この場合、HTTP 動詞 は POST で、URL は 「/text/analytics/v2.0/sentiment」 (API への完全な URL は 「<https://westus.api.cognitive.microsoft.com//text/analytics/v2.0/sentiment>」) です。 body パラメータを見ていきます。

4. 応答 領域には、Postman コレクションに含まれる HTTP 応答に基づいて情報が表示されます。 ここで定義されている応答は 「200」 (成功応答) のみですが、他の応答を定義することもできます。

5. 検証 領域には、API 定義で検出された問題が表示されます。 コネクタを保存する前に、必ずこの領域を確認してください。

定義を更新する

Logic App、Power Automate、または Power Apps で使用する際は、接続しやすくなるように、いくつかの変更を実行しましょう。

1. 全般エリアで、概要を「検出されたセンチメントを表す数値スコアを返す」に更新します。

2. 要求 領域で、本文、編集 の順に選択します。

3. パラメーター 領域に、API に必要な、id、language、および text の 3 つのパラメーターが表示されます。 ID、編集 の順に選択します。

4. スキーマのプロパティ 領域で、パラメーターの値を更新し、戻る を選択します。

   

   パラメーター	値
   タイトル	"ID"
   説明	"送信する各ドキュメントの識別子"
   既定値	"1"
   必須	"はい"

5. パラメーター 領域で、言語、編集 の順に選択し、上記のプロセスを次の値を使用して繰り返します。

   パラメーター	値
   タイトル	"言語"
   説明	"テキストの 2 または 4 文字の言語コード"
   既定値	"en"
   必須	"はい"

6. パラメーター 領域で、テキスト、編集 の順に選択し、上記のプロセスを次の値を使用して繰り返します。

   パラメーター	値
   タイトル	"テキスト"
   説明	"センチメントの分析対象テキスト"
   既定値	いいえ​​
   必須	"はい"

7. パラメーター領域で、戻るを選択して、メインの定義ページに戻ります。

8. ウィザードの右上で、コネクタの更新 を選択します。

コネクタをテストする

コネクタの作成が完了したので、次はそのコネクタをテストして、適切に機能していることを確認します。 テストは現在、Power Automate と Power Apps でのみ使用可能です。

重要

API キーを使用する場合は、作成後すぐにコネクタをテストしないことをお勧めします。 コネクタが API に接続できるようになるまで数分かかる場合があります。

1. テスト ページで、新しい接続を選択します。

2. Text Analytics API から API キーを入力し、接続の作成 を選択します。

3. テスト ページに戻ります。

   • Power Automate で、テスト ページに戻ります。 更新アイコンを選択して、接続情報が更新されることを確認します。
   • Power Apps で、現在の環境で使用できる接続の一覧に移動します。 右上隅にある歯車アイコンを選択し、カスタム コネクタ を選択します。 作成したコネクタを選択した後、テスト ページに戻ります。

4. テスト ページの テキスト フィールドに値を入力し (他のフィールドでは前に設定した既定値を使用)、テスト操作 を選択します。

5. コネクタは API を呼び出し、センチメント スコアを含む応答を確認できます。

   

制限

Power Automate および Power Apps で、Postman コレクションを使用して既存のカスタム コネクタを更新する場合は、コネクタを保存する前に以前のカスタマイズをやり直す必要があります。 たとえば、認証の種類、アクションのパラメーターの既定値などを再構成する必要があります。

次の手順

カスタム コネクタを作成し、その動作を定義したので、コネクタを使用できます。

• フローからカスタム コネクタを使用する
• アプリからカスタム コネクタを使用する
• ロジック アプリからカスタム コネクタを使用する

組織内でコネクタを共有したり、組織外のユーザーが使用できるようにコネクタの認定を受けたりすることもできます。

• 自分のコネクタの共有
• 自分のコネクタを認定する

フィードバックを提供する

コネクタ プラットフォームの問題点や新機能のアイデアなどのフィードバックをお待ちしています。 フィードバックを提供するには、「問題を送信するか、コネクタに関するヘルプを入手する」にアクセスし、フィードバックの種類を選択します。