データの検索

完了

[Microsoft Dataverse コネクタ 行検索] アクションを使用すると、Power Automate クラウド フローで Dataverse 検索機能を使用できるようになります。 Dataverse 検索は、複数のテーブルにわたって高速かつ包括的な結果を表示します。

Power Automate フローで Dataverse 検索を使用する前に、以下を必ず実行します。

  • お使いの環境で Dataverse 検索を有効化します。

  • Dataverse 検索用検索可能テーブルを選択します。

  • 検索する列と返す列を指定します。

ここでは、Microsoft Dataverse 検索用の環境を構成す方法について簡単に説明しますが、段階的な手順を確認する場合は、「環境に適した Dataverse 検索を構成する」を参照してください。

お使いの環境で Dataverse 検索を有効化するには、[Power Platform 管理センター] にアクセスし、Dataverse 検索を有効化する環境の設定に移動します。 [設定] ページで、[製品] セクションを展開し、[機能] を選択します。 [検索] セクションでトグル ボタンを使用すると Dataverse 検索を有効化または無効化できます。

[Dataverse 検索] トグル ボタンが有効になっている状態のスクリーンショット。

検索可能なテーブルを選択

検索用のテーブルを選択するには、テーブルがあるソリューションを開き、概要 タブにある 検索インデックスを管理 リンク ボタンを選択します。ここで、Dataverse 検索で索引するテーブルを選択できます。

列の指定

テーブルの簡易検索ビューは、Dataverse 検索が有効化されているテーブルの検索可能な列やフィルターを操作します。 検索条件 セクションにある 検索テーブル列の編集 ボタンを使用すると、検索する列を構成できます。

[検索条件] セクションを示すスクリーンショット。

Dataverse 検索用に設計された簡易ビューも作成できます。これには、フィルター、並び替え、および列があります。

[Dataverse 行検索] アクションの使用

基本的な検索として、[Dataverse 行検索] アクションを使用するのは簡単です。検索語句のみを入力するだけです。検索語句として前のステップからの動的コンテンツを使用できます。 この例では、入力パラメーターを使用して手動でトリガーされたフローを使用します。 次に、[Dataverse 行検索] アクションの検索語句としてトリガーからの入力を選択します。 ここでは簡略化していますが、入力は前のアクションからのものにすることができます。

検索語句入力を示すスクリーンショット。

Dataverse 行検索は、検索語句と一致するすべての行を返します。この結果は、単一テーブルからのものである場合もあれば、複数テーブルからのものである場合もあります。 ほとんどの場合、複数テーブルからの結果の列は、一致しないため、最終的なコピー先に到達する前に、返された結果を構成する必要があります。

この例では、[Dataverse 行検索] アクションが、Contact、Reservation、Review テーブルから結果を返しています。 返される列が同じではないことがわかっているため、HTML テーブルを作成する前に、データを共通の列を持つ配列変数に変換しました。

フローを示すスクリーンショット。

まず、結合された検索結果を格納する配列変数を作成しました。 その後、JSON 解析ステップを追加して、[Dataverse 行検索] アクションからの結果を把握しました。 次に各アクションへの適用を採用して、各結果を反復処理しました。

各テーブルの項目結果を適切に管理するためにスイッチ コントロールを導入しました。 このステップは、動的コンテンツを介して各テーブルの一意の列を確実に使用できるようにするために重要でした。 最後に、結果を検索結果配列変数に組み込みました。

これらのステップを実装することで、列の不一致の問題に効果的に対処し、HTML テーブルの作成を支援するために、データを変換しました。

テーブル フィルター

[Dataverse 行検索] アクションを使用すると、検索するテーブルを選択できます。 この例では、Dataverse 検索は、複数のテーブルにわたって検索するように構成されていますが、Power Automate フロー内の [Dataverse 行検索] アクションが Contact テーブルだけを検索するように制限しています。

テーブル フィルターを示すスクリーンショット。

行フィルター

OData スタイルのフィルター式を使用すると検索を制限できます。 検索でレドモンドからの連絡先のみを返すようにするには、行フィルターとしてこの式を指定します。

address1_city eq 'Redmond'

この例では、Dataverse 検索は、複数のテーブルにわたって検索するように構成されていますが、Power automate 内の [Dataverse 行検索] アクションは、Contact テーブルだけを検索するように制限しています。

並べ替え

返された結果を検索スコアの降順で並べ替え、次にフルネームの昇順で並べ替える場合は、並べ替え順として、これらの式を使用します。

アイテムで並べ替え - 1: @search.score desc

アイテムで並べ替え - 2: fullname asc