ロジック アプリからカスタム コネクタを使用する
注意
このトピックは、Azure Logic Apps、Power Automate、および Power Apps でのカスタム コネクタの作成および使用に関するチュートリアル シリーズの一部です。 カスタム コネクタの概要 を必ず読んで、プロセスを理解してください。
このトピックでは、前のトピックで作成したカスタム コネクタを使用する基本的なロジック アプリを構築します。 アイテムが SharePoint リストの場合ロジック アプリがトリガーされ、ロジック アプリはカスタム コネクタを使用して Cognitive Services Text Analytics API を呼び出します。 コネクタは、リスト アイテムのテキストのセンチメント スコア (0〜1) を返し、ロジック アプリはスコアをリストに書き込みます。 次の図は、次の完了したロジック アプリを示しています。
前提条件
Office 365 Business Premium サブスクリプション、または 試用版 に新規登録してください
ロジック アプリの基本的な構築経験。 詳細については、最初のロジック アプリ ワークフローを構築する を参照してください。
次のいずれかのトピックで作成したカスタム コネクタ:
カスタム コネクタがオンプレミスのデータ ゲートウェイを使ってオンプレミスのリソースにアクセスする場合、ゲートウェイ インストールを設定して、対応する事前構築されたコネクタアウトバウンド IP アドレス に対するアクセスを許可する必要があります。 同じリージョンのすべてのロジック アプリは、同じ IP アドレス範囲を使用します。 詳細については、Azure Logic Apps 用のオンプレミスのデータゲートウェイをインストールする - 通信設定を確認または調整するを参照してください。
SharePoint リストを作成する
まず、SharePoint オンラインで簡単な 3 列のリストを作成し、このリストには、ロジック アプリがセンチメントについて分析する映画レビュー データが格納されます。 SharePoint リストについての詳細は、SharePoint ドキュメントの リストの概要 を参照してください。
自分の SharePoint オンライン サイトで、新着、その後 リスト を選択します。
"映画レビュー" という名前を入力し、作成 を選択します。
既定の タイトル フィールドを持つ、リストが作成されます。
、1 行のテキスト の順に選択します。
"レビュー" という名前を入力し、保存 を選択します。
手順 3. および 4. リストに列を追加します。データ型には 数値 を使用し、名前は "スコア" にします。
ロジック アプリを作成する
使用するリストが作成されたので、Azure ポータルでロジック アプリを作成します。
Azure 資格情報を使って Azure Portal にサインインします。
Azure のメインメニューから、新規 > エンタープライズ統合 > ロジック アプリ を選択します。
ロジックアプリを作成する で、ここに示すようにロジック アプリの詳細を入力します。 終了したら、ダッシュボードにピン留めする > 作成 を選択します。
設定 値 内容 件名 感情分析 ロジック アプリの名前 サブスクリプション <your-Azure-subscription-name> Azure サブスクリプションの名前 リソース グループ My-First-LA-RG 関連リソースを整理するために使用される Azure リソースグループ の名前 場所 米国東部 2 ロジック アプリ情報を格納するリージョン 注意: ロジック アプリとカスタム コネクタは同じリージョンに存在する必要があります。
Log Analytics オフに切り替え 診断ログではオフ設定を維持します。 Azure がアプリを展開すると、Logic Apps Designer が開き、紹介ビデオと一般的に使用されるトリガーを含むページが表示されます。 テンプレート で 空のロジック アプリ を選択します。
トリガーとカスタム コネクタを追加する
ロジック アプリを作成したら、SharePoint リストに項目が追加されたときに起動するトリガーを追加します。 次に追加した項目に基づいて実行するアクションを追加します。
Logic Apps Designe で、SharePoint を検索または選択し、次にトリガー SharePoint - 項目が作成されたとき を選択します。
求められたら、SharePoint の資格情報を使用してサインインします。
SharePoint トリガーの値を入力します。
パラメーター 値 サイトのアドレス <your-SharePoint-site-address> リスト名 映画レビュー 間隔 10 頻度 秒 新規ステップ を選択し、アクションの追加 を選択します。
作成した SentimentDemo カスタム コネクタを検索し、そのコネクタに関連付けられているアクションを選択します。
アクションの名前と説明は、コネクタの作成時に指定した情報に基づいています。
接続と API キーの名前を入力します。
パラメーター 値 接続名 SentimentDemoConnection などの名前。 API キー Text Analytics API の API キー。 詳細については、API キーを取得する を参照してください。 すべてのフィールドに値を入力します。
パラメーター 値 言語 en ID 1 テキスト SharePoint レビュー フィールド (ダイナミック コンテンツ ダイアログ ボックスから) コネクタは複数のドキュメントを処理できるため、ID は必須です。この例では、一度に 1 つのドキュメントを送信します。 生産ロジック アプリでは、言語 そして ID の値はリストまたは別のデータ ソースから取得される場合があります。
新規ステップ を選択し、アクションの追加 を選択します。
アクション SharePoint - アイテムの更新 を追加して、すべてのフィールドに値を入力します。
パラメーター 値 サイトのアドレス <your-SharePoint-site-address> リスト名 映画レビュー ID SharePoint ID フィールド 敬称 SharePoint タイトル フィールド レビュー SharePoint レビュー フィールド スコア カスタムコネクタの スコア フィールド スコア フィールドに動的なコンテンツを追加すると、カスタム コネクタが複数のドキュメントを認識するため、Logic Apps によってそれぞれにコンテナーが追加されることに注意してください。 コネクターは一度に 1 つしか送信しませんが、ロジック アプリがコネクタの機能と一致するのは素晴らしいことです。
完了したロジック アプリは、次の図のようになります。
Logic Apps Designer の上部で、実行 を選択します。
ロジック アプリをテストする
ロジック アプリが完成したので、SharePoint リストにレビューを追加し、ロジック アプリの応答を確認することで次にロジック アプリをテストします。
自分の SharePoint オンライン リストで、クイック編集 を選択します。
リストに 2 つのレビュー (1 つは否定的、もう 1 つは肯定的) を追加し、完了 を選択します。
パラメーター 提案された値 タイトル (肯定的) お気に入りの映画 レビュー (肯定的) 忙しかった一日の後に新しい映画を楽しんだ タイトル (否定的) その他の映画 レビュー (否定的) 私が数十年で見た中で最悪の映画 Azure portal に戻り、概要 を選択してこのロジック アプリの実行履歴を確認します。 2 回の実行 — リストに追加したレビューごとに 1 回 - が表示されます。 このロジック アプリが完了した後に Azure リソースを保存するには、無効にする を選択します。
SharePoint リスト ページに戻り、ブラウザを更新してロジック アプリが追加したスコアを確認します。
準備が完了しました! これは単純なロジック アプリですが、カスタム コネクタから Cognitive Services を呼び出すことで強力な機能が得られました。
次の手順
組織内でコネクタを共有したり、組織外のユーザーが使用できるようにコネクタの認定を受けます。
フィードバックを提供する
コネクタ プラットフォームの問題点や新機能のアイデアなどのフィードバックをお待ちしています。 フィードバックを提供するには、「問題を送信するか、コネクタに関するヘルプを入手する」にアクセスし、フィードバックの種類を選択します。