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

注意

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

このトピックでは、前のトピックで作成したカスタム コネクタを使用する基本的なロジック アプリを構築します。 アイテムが SharePoint リストの場合ロジック アプリがトリガーされ、ロジック アプリはカスタム コネクタを使用して Cognitive Services Text Analytics API を呼び出します。 コネクタは、リスト アイテムのテキストのセンチメント スコア (0〜1) を返し、ロジック アプリはスコアをリストに書き込みます。 次の図は、次の完了したロジック アプリを示しています。

完了した感情分析ロジック アプリ

前提条件

SharePoint リストを作成する

まず、SharePoint オンラインで簡単な 3 列のリストを作成し、このリストには、ロジック アプリがセンチメントについて分析する映画レビュー データが格納されます。 SharePoint リストについての詳細は、SharePoint ドキュメントの リストの概要 を参照してください。

  1. 自分の SharePoint オンライン サイトで、新着、その後 リスト を選択します。

    新規 SharePoint リストを作成する

  2. "映画レビュー" という名前を入力し、作成 を選択します。

    新しいリストの名前を指定する

    既定の タイトル フィールドを持つ、リストが作成されます。

    プロジェクトの申請リスト

  3. 新規アイテムのアイコン1 行のテキスト の順に選択します。

    1 行テキスト フィールドの追加

  4. "レビュー" という名前を入力し、保存 を選択します。

  5. 手順 3. および 4. リストに列を追加します。データ型には 数値 を使用し、名前は "スコア" にします。

ロジック アプリを作成する

使用するリストが作成されたので、Azure ポータルでロジック アプリを作成します。

  1. Azure 資格情報を使って Azure Portal にサインインします。

  2. Azure のメインメニューから、新規 > エンタープライズ統合 > ロジック アプリ を選択します。

    ロジック アプリを作成する

  3. ロジックアプリを作成する で、ここに示すようにロジック アプリの詳細を入力します。 終了したら、ダッシュボードにピン留めする > 作成 を選択します。

    ロジック アプリの詳細を指定する

    設定 内容
    件名 感情分析 ロジック アプリの名前
    サブスクリプション <your-Azure-subscription-name> Azure サブスクリプションの名前
    リソース グループ My-First-LA-RG 関連リソースを整理するために使用される Azure リソースグループ の名前
    場所 米国東部 2 ロジック アプリ情報を格納するリージョン

    注意: ロジック アプリとカスタム コネクタは同じリージョンに存在する必要があります。

    Log Analytics オフに切り替え 診断ログではオフ設定を維持します。
  4. Azure がアプリを展開すると、Logic Apps Designer が開き、紹介ビデオと一般的に使用されるトリガーを含むページが表示されます。 テンプレート空のロジック アプリ を選択します。

    空のロジック アプリ テンプレートを選択する

トリガーとカスタム コネクタを追加する

ロジック アプリを作成したら、SharePoint リストに項目が追加されたときに起動するトリガーを追加します。 次に追加した項目に基づいて実行するアクションを追加します。

  1. Logic Apps Designe で、SharePoint を検索または選択し、次にトリガー SharePoint - 項目が作成されたとき を選択します。

    SharePoint が項目トリガーを作成する

  2. 求められたら、SharePoint の資格情報を使用してサインインします。

  3. SharePoint トリガーの値を入力します。

    SharePoint が項目トリガー パラメーターを作成する

    パラメーター
    サイトのアドレス <your-SharePoint-site-address>
    リスト名 映画レビュー
    間隔 10
    頻度
  4. 新規ステップ を選択し、アクションの追加 を選択します。

  5. 作成した SentimentDemo カスタム コネクタを検索し、そのコネクタに関連付けられているアクションを選択します。

    SentimentDemo アクションを選択する

    アクションの名前と説明は、コネクタの作成時に指定した情報に基づいています。

  6. 接続と API キーの名前を入力します。

    接続名と API キー

    パラメーター
    接続名 SentimentDemoConnection などの名前。
    API キー Text Analytics API の API キー。 詳細については、API キーの取得 に移動します。
  7. すべてのフィールドに値を入力します。

    接続パラメーター

    パラメーター
    言語 en
    ID 1
    テキスト SharePoint レビュー フィールド (ダイナミック コンテンツ ダイアログ ボックスから)

    コネクタは複数のドキュメントを処理できるため、ID は必須です。この例では、一度に 1 つのドキュメントを送信します。 生産ロジック アプリでは、言語 そして ID の値はリストまたは別のデータ ソースから取得される場合があります。

  8. 新規ステップ を選択し、アクションの追加 を選択します。

  9. アクション SharePoint - アイテムの更新 を追加して、すべてのフィールドに値を入力します。

    リスト項目アクションの更新

    パラメーター
    サイトのアドレス <your-SharePoint-site-address>
    リスト名 映画レビュー
    ID SharePoint ID フィールド
    敬称 SharePoint タイトル フィールド
    レビュー SharePoint レビュー フィールド
    スコア カスタムコネクタの スコア フィールド

    スコア フィールドに動的なコンテンツを追加すると、カスタム コネクタが複数のドキュメントを認識するため、Logic Apps によってそれぞれにコンテナーが追加されることに注意してください。 コネクターは一度に 1 つしか送信しませんが、ロジック アプリがコネクタの機能と一致するのは素晴らしいことです。

    Apply to each

    完了したロジック アプリは、次の図のようになります。

    完了した感情分析ロジック アプリ

  10. Logic Apps Designer の上部で、実行 を選択します。

ロジック アプリをテストする

ロジック アプリが完成したので、SharePoint リストにレビューを追加し、ロジック アプリの応答を確認することで次にロジック アプリをテストします。

  1. 自分の SharePoint オンライン リストで、クイック編集 を選択します。

    SharePoint リストの簡易編集

  2. リストに 2 つのレビュー (1 つは否定的、もう 1 つは肯定的) を追加し、完了 を選択します。

    簡易編集の完了

    パラメーター 提案された値
    タイトル (肯定的) お気に入りの映画
    レビュー (肯定的) 忙しかった一日の後に新しい映画を楽しんだ
    タイトル (否定的) その他の映画
    レビュー (否定的) 私が数十年で見た中で最悪の映画
  3. Azure portal に戻り、概要 を選択してこのロジック アプリの実行履歴を確認します。 2 回の実行 — リストに追加したレビューごとに 1 回 - が表示されます。 このロジック アプリが完了した後に Azure リソースを保存するには、無効にする を選択します。

    実行履歴

  4. SharePoint リスト ページに戻り、ブラウザを更新してロジック アプリが追加したスコアを確認します。

    ロジック アプリから追加されたスコア

準備が完了しました! これは単純なロジック アプリですが、カスタム コネクタから Cognitive Services を呼び出すことで強力な機能が得られました。

次の手順

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

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

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