Dataverse 検索を使用して行を取得する

  • [アーティクル]

フローの行の検索アクションを使用して、キーワードと Dataverse 検索 を使用し Microsoft Dataverse からデータを取得します。これにより、Dataverse のテーブル全体で高速、インテリジェント、包括的な結果が得られます。

前提条件

Microsoft Dataverse で検索アクションを使用する前に、管理者は環境でDataverse 検索 を構成する必要があります。

行の検索アクション。

行に行を検索アクションを追加してから、検索語句にキーワードを指定して、Dataverse のすべてのインデックス付き行でそのキーワードを検索します。

フローの前のステップからの動的コンテンツを使用して、検索語句ボックスをパラメーター化します。 たとえば、Power Virtual Agent ボットに入力されたキーワードを使用して、次のオプションを設定して自動検索を開始できます。

Power Virtual Agent によるフローの呼び出し。

注意

新しく追加された行が検索結果に含まれるまでに数時間かかる場合があります。

検索の種類

検索の種類オプションを使用して、検索クエリの構文を提供します。 簡易を使用して、簡易クエリ構文を使用することを示します。 Lucene クエリ構文を使用する場合は、完全を使用します。 既定のクエリ構文は簡易です。

次の例を参照するか、Dataverse 検索を使用してテーブル データ全体を検索する での機能の完全なリストを確認してください。

単純なクエリ構文は、次の機能をサポートしています。

演算子 内容
ブール演算子 AND演算子; + で示される
OR 演算子; | で示される
NOT 演算子; - で示される
優先演算子 "hotel+(wifi | luxury)" という検索用語は、"hotel" という用語と "wifi" または "luxury" (あるいはその両方) のいずれかを含む結果を検索します。
ワイルドカード 末尾のワイルドカードがサポートされています。例: 「アルパイン」の場合、"Alp*" を検索します。
完全一致 引用符 " " で囲まれたクエリ。

Lucene クエリ構文は、次の機能をサポートしています。

演算子 内容
ブール演算子 単純なクエリ構文と比較して、拡張されたセットを提供します。
AND 演算子; AND、&&、+
OR 演算子; OR、II で示される
NOT 演算子; NOT、!、- で示される
優先演算子 単純なクエリ構文と同じ機能です。
ワイルドカード 末尾のワイルドカードに加えて、先頭のワイルドカードもサポートしています。
末尾のワイルドカード – "alp*"
先頭のワイルドカード - "/.*pine/"
あいまい検索 最大 2 文字のスペルミスのあるクエリをサポートします。
"Uniersty~" は "University" を返します
"Blue~1" は "glue"、"blues" を返します
用語ブースト クエリ内の特定の用語の重みが異なります。 "Rock
2 electronic" は、"electronic" との一致よりも "rock" の一致の方が重要な結果を返します。
近接検索 より文脈的な結果を得るために、用語が互いに x 語以内にある結果を返します。
たとえば、"airport hotel"~5" は、"airport" と "hotel" が互いに 5 語以内の結果を返すため、空港の近くにあるホテルを見つける可能性が高くなります。
正規表現 (regex) 検索 たとえば、/[mh]otel/ は "motel" または "hotel" に一致します。

検索演算子を検索テキストの一部として使用するには、その文字の前にバックスラッシュを 1 つ付けてエスケープします (\)。 エスケープされる特殊文字には、次の文字が含まれますs: + - & | ! ( ) { } [ ] ^ " ~ * ? : \ /

Search mode

ドキュメントを一致としてカウントするために、検索語の一部またはすべてを一致させる必要があるかどうかを指定できます。 既定値は any です。 NOT 演算子を持つ単語を、クエリ内の他の単語と AND 検索または OR 検索するかどうかを制御します (他の単語に + または | 演算子がないことが前提です)。

  • 検索モードに any を使用すると、より多くの結果を含めることによりクエリのリコールが増加します。 既定では、"OR NOT" として解釈されます。 たとえば、"wifi -luxury" は、"wifi" という用語が含まれているドキュメント、または "luxury" という用語が含まれていないドキュメントに一致します。

  • 検索モードに all を使用すると、含める結果が少なることによりクエリの精度が上昇します。 既定では、"AND NOT" として解釈されます。 たとえば、"wifi -luxury" は、"wifi" という用語を含み、"luxury" という用語を含まないドキュメントと一致します。

詳細については、Dataverse 検索を使用してテーブル データ全体を検索する に移動してください。

検索モードの例。

詳細オプション

このセクションで説明されているように、他の詳細オプションを使用して検索を最適化できます。 その他の例については、Dataverse 検索を使用してテーブル データ全体を検索する を参照してください。

  • 行フィルター: 次の図に示すように、フィルターを指定して検索を絞り込むことができます。

  • テーブル フィルター: 次の図に示すように、指定したテーブルに検索を制限できます。

  • 並べ替え基準: 次の画像に示すように、このオプションを使用して、列名を指定して接尾辞として asc または desc を追加することにより、並べ替えを行います。

    詳細オプション。

動的コンテンツと Dataverse 行を使用する

アクションの出力は、動的コンテンツから直接使用できます。 各パラメーターの意味は次のとおりです。

パラメーター名 内容
本体 応答全体を表すオブジェクト。 これには、行の一覧、合計行数、およびファセット結果が含まれます。
行の一覧 返されるすべての行を表すオブジェクト。
行の項目の一覧 ループ内で使用される場合の、行の一覧内の個々の行。
行の検索スコア 行の Dataverse スコア。 このスコアは、検索キーワードと条件にどの程度一致しているかを示します。
行の検索のハイライト 行の検索キーワードに一致した特定のキーワードを強調表示します。
行のテーブル名 1 つの行のテーブル名。 このアクションは、環境内のすべての検索可能なテーブルから行を集約します。
行のオブジェクト ID これは各行の識別子です。 この識別子を 複数行を取得 アクションのテーブル名と組み合わせて使用すると、行内のすべての列を読み取ることができます。
行オブジェクトの種類コード 行のテーブル名識別子。

フローを構築しているとき、動的コンテンツはこの画像のように表示される場合があります。

フローを構築するための動的コンテンツ。

行の検索アクションは、Dataverse 検索の構成 に応じて、変数スキーマ内の一致した行に対して他の多くの列を返します。 これらの列を使用するには、JSON 応答を解析してから、次の図に示すように、JSON 応答から生成された動的出力を使用します。

JSON スキーマ。