検索バーティカルを管理する

[アーティクル]
04/03/2023

検索バーティカルは、特定の種類または選択したソースの結果を表示する検索結果ページのタブです。たとえば、[ファイル] バーティカルでは、ファイルとして分類された結果が表示され、ドキュメントを見つけるユーザーが簡単に見つかります。 Microsoft Search では、organizationまたは個々の部門のニーズに合わせて縦書きをカスタマイズできます。 Microsoft Search には、2 種類の縦書きがあり、既定または既定の縦型とカスタム縦型があります。 [すべて]、[ファイル]、[People] などの既定の垂直方向では、最も一般的に使用される検索結果に簡単にアクセスできます。

垂直線は、次の 2 つのレベルで管理できます。

組織レベル – ユーザーが SharePoint のスタートページ、Microsoft Office、および Microsoft Search からBingで検索すると、検索結果ページにorganization レベルの縦線が表示されます。
サイトレベル – ユーザーが SharePoint サイトで検索すると、サイトレベルの垂直方向が検索結果ページに表示されます。たとえば、カスタマーサービスの従業員が部門の SharePoint サイトから重大度 1 のインシデントを直接検索できるようにする場合があります。

既定の縦書き

既定の縦書きは、Bingの SharePoint、Microsoft Office、Microsoft Search などのエクスペリエンスのorganization レベル、または各サイトの検索結果ページの SharePoint サイトレベルに存在します。

カスタマイズ機能の概要を次に示します。

カスタマイズの種類	組織レベル	サイトレベル
垂直方向の名前を変更する	はい	はい
垂直を無効にする	一部	はい
クエリの追加	一部	はい

カスタムの縦書き

検索エクスペリエンスに検索バーティカルを追加できます。組織レベルまたはサイトレベルの検索では、Graph コネクタまたは SharePoint からのコンテンツを検索できます。 SharePoint コンテンツのカスタムバーティカルには、そのスコープの他のバーティカルと同様に、それぞれのスコープの結果が表示されます。たとえば、組織のスコープのカスタム垂直にはすべての結果が表示され、マーケティングサイトの SharePoint コンテンツを含むカスタム垂直には、そのサイトのデータが表示されます。同じハブスコープが適用されるハブサイトについても同じことが当てはまります。

検索バーティカルを作成または変更する

垂直管理エクスペリエンスはウィザード駆動型であり、検索するコンテンツの垂直名、コンテンツソース、スコープを定義する手順を説明します。限定されたキーワードクエリ言語 (KQL) のセットを使用して、特定のコンテンツソースの垂直検索のスコープを定義できます。フィルターは、organizationおよびサイトレベルで、すぐに使える縦線やカスタムの縦線に追加することもできます。フィルターの詳細については、「フィルターの管理」を参照してください。

organization レベルの垂直線を管理する

Microsoft 365 管理センターで、[カスタマイズ] セクションの [バーティカル] ページに移動します。
既存の垂直を選択し、[ 編集 ] をクリックするか、[ 追加 ] をクリックして新しい垂直を作成します。
構成手順を進めてから、垂直方向を確認して保存できます。

サイトレベルの縦書きを管理する

垂直方向を管理する SharePoint サイトで、歯車をクリックして設定パネルを開きます。
[サイト情報]、[すべてのサイト設定を表示] の順に選択します。 
「Microsoft Search」セクションを探し、[検索設定の構成]を選択します。
ナビゲーションウィンドウで、[カスタムエクスペリエンス] に移動し、[ 縦] を選択します。
既存の垂直を選択し、[ 編集 ] をクリックするか、[ 追加 ] をクリックして新しい垂直を作成します。
構成を設定した後、垂直方向を確認して保存できます。

検索結果ページで垂直を表示する

グラフコネクタの結果を検索の垂直ページに表示するには、検索結果レイアウトが必要です。適切な結果レイアウトが存在することを確認する場合は、垂直方向の検索を有効にすることができます。垂直方向を有効または更新した後、検索ページで変更を表示できるようになるまで、数時間の遅延が発生します。 SharePoint と Office の URL に cacheClear=true を追加して、変更をすぐに表示できます。 Bingで、&features=uncachedVerticals を作業の垂直 URL に追加して、変更をすぐに表示します。

注:

モバイル Web ブラウザーから表示すると、追加された縦書きは SharePoint と Office には表示されません。

高度な構成オプション

垂直方向の複数の接続

垂直検索では、複数のコネクタソースからの結果を表示できます。このオプションを使用すると、検索結果ページを柔軟に設計できます。垂直セットアッププロセスを使用すると、管理者は "コンテンツソース" 手順で複数の接続を選択できます。

できるだけ多くの セマンティックラベル を正確に指定すると、このエクスペリエンスが強化されます。セマンティックラベルは、スキーマ定義とインジェストの時点で追加します。セマンティックラベルを作成および管理する方法の詳細を参照してください。セマンティックラベルを作成および管理する方法の追加情報を次に示します。

注:

接続は、1 つの垂直方向の下にコンテンツソースとして追加できます。複数の垂直線の下で接続を使用することはできません。

複数の接続ソースが追加された垂直検索のクエリを設定するには、一般的なソースプロパティを使用してクエリを作成します。

キーワードクエリ言語 (KQL)

キーワードクエリ言語 (KQL) ( 制限付きサポート) を使用して、垂直方向の検索に表示される結果を絞り込むために、クエリを垂直方向に追加できます。このページには、使用可能なプロパティの一覧が表示されます。 KQL を作成するには、ブール演算子でフリーテキストキーワードとプロパティ制限を使用することをお勧めします。 XRANK、近接演算子、単語などの動的ランク付け演算子はサポートされていません。

クエリの例を次に示します。

シナリオ	Query
アーカイブサイトからの結果の除外	NOT (path:http//contoso.sharepoint.com/archive OR path:http//contoso.sharepoint.com/CompanyArchive)
ファイルの種類プロパティに基づく結果の除外	NOT(FileType:htm)

垂直方向の KQL クエリセクションで変数を使用して、垂直方向のクエリへの入力として動的データを提供します。 "Profile" と "query string" は、使用できるクエリ変数の種類です。

プロファイルクエリ変数

プロファイルクエリ変数を使用して、サインインしているユーザーに検索結果をコンテキスト化できます。プロファイルクエリ変数は、サインインしているユーザーのプロファイルから値をフェッチします。たとえば、ユーザーが割り当てられたサポートチケットを検索するための "チケット" 垂直を作成するには、管理ページの垂直方向の作成中に [クエリ] セクションで次のクエリを指定できます。

AssignedTo:{Profile.accounts.userPrincipalName}

これにより、検索結果がトリミングされ、検索を行うユーザーに割り当てられている項目のみが表示されます。

プロファイルリソースは、プロパティをコレクションとして公開します。たとえば、電子メールアドレスに関連する情報は、電子メールの収集、位置の収集としての仕事の位置などを通じて公開されます。ユーザープロファイルで使用できるすべてのプロパティは、クエリ変数として公開されます。

次に示すように、電子メールコレクションで使用できる 3 つのメールアドレスを持つユーザーを考えてみましょう。

"emails": [{ 

        "address": "Megan.Bowen@contoso.com",
        "id": "xyz", 
        "source": { 
            "CreatedBy": "xyz", 
            "CreatedOn": "2222", 
            "Type": "official" 
        },
        "type": "main" 
    }, { 
        "address": "meganb@hotmail.com",
        "id": "abc", 
        "source": { 
            "CreatedBy": "abc",
            "CreatedOn": "3333", 
            "Type": "non-official",
        },
        "type": "work"
    }, { 
        "address": "meganb@outlook.com",
        "id": "pqr", 
        "source": { 
            "CreatedBy": "pqr", 
            "CreatedOn": "4444", 
            "Type": "personal" 
        },
        "type": "personal" 
    } 
]

クエリ MyProperty: {Profile.emails.address} は MyProperty: "Megan.Bowen@contoso.com"に解決されます。
address 属性のすべての値を解決するには、複数値展開構文を使用します。クエリ {|MyProperty:{Profile.emails.address}} は ((MyProperty:"Megan.Bowen@contoso.com") OR (MyProperty: "meganb@hotmail.com") OR (MyProperty:"meganb@outlook.com")) に解決されます。

"|" 演算子を使用して、複数値変数を解決します。プロファイル拡張の例については、次の表を参照してください。

#	構文	戻り値
1	MyProperty:{Profile.emails.address}	"Megan.Bowen@contoso.com"
2	MyProperty:{Profile.emails}	{Profile.emails} 電子メールはオブジェクトであるため、これは解決されません。
3	{?MyProperty:{Profile.emails}}	電子メールはオブジェクトであるため、これは解決されません。 "?" 演算子は、解決されないクエリ変数を無視します。この変数は、クエリスタックのさらに下に渡されると削除されます。
4	{\|MyProperty: {Profile.emails.source.Type}}	((MyProperty:"official") OR (MyProperty:"nonofficial") OR (MyProperty:"personal"))

クエリ文字列変数

クエリ文字列変数を使用すると、ユーザーが SharePoint サイトとやり取りする方法に基づいて検索結果をカスタマイズできます。これは、検索 URL にキーと値のペアを追加することで行われます。たとえば、進行中のタスクを示す単純な Web パーツを使用してプロジェクトに関する情報を提供する SharePoint サイトがあるとします。 [進行中] Web パーツをクリックすると、ユーザーが "作業項目" 検索の垂直方向にリンクされ、結果は InProgress としてタグ付けされた項目のみを表示するように絞り込まれます。

これを行うには、管理ページの垂直作成時に [クエリ] セクションで次のクエリを指定します。

Status:{QueryString.state}

SharePoint サイトボタン Web パーツの URL を更新して、次のキー値ペア https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress を渡す必要があります。

クエリの状態:{QueryString.state} は status:InProgresss に解決されます。

クエリ文字列の拡張の例を次に示します。

#	クエリ構文	URL 構文	戻り値
1	MyProperty:{QueryString.state}	https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgresss	MyProperty:InProgresss
2	MyProperty:{QueryString.state} OR MyProperty:{QueryString.priority}	https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress&priority=1	MyProperty:InProgress OR MyProperty:1
3	{?MyProperty:{QueryString.state}}	https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?State=InProgresss	QueryStrings では大文字と小文字が区別されるため、この状態は解決されません。 "?" 演算子は、解決されないクエリ変数を無視します。この変数は、クエリスタックのさらに下に渡されると削除されます。
4	{\|MyProperty: {QueryString.state}}	https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed	(MyProperty:InProgress)OR (MyProperty:Closed) \|演算子は、muti 値変数を解決するために使用されます。変数の値は、URL 構文に示すようにコンマ区切り記号を使用して渡す必要があります。
5	{MyProperty: {QueryString.state}}	https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed	MyProperty:InProgresss ここでは、クエリ構文で複数値変数として定義されていないため、状態の最初の値のみが URL から取得されます。

制限事項

言語のローカライズは、変更後のすぐに使用できる縦書きの名前には適用されません。
カスタムバーティカルは、Microsoft Search のモバイルビューには表示されません。
People垂直ではクエリの追加はサポートされていません。
垂直方向の変更と新しい縦書きは、organizationのゲストユーザーには表示されません。
垂直方向の順序変更はサポートされていません。
Bingの Microsoft Search では、[すべての] タブの垂直方向の名前変更はサポートされていません。
クエリ文字列変数は、SharePoint サイトでのみ使用できます。

トラブルシューティング

発生する可能性がある一般的な問題と、それらを修正するためのアクションの一覧を次に示します。

問題	アクション
バーティカルに「問題が発生しました」というエラーメッセージが表示されます。	セットアップを完了するには、バーティカルタイプと結果タイプの両方が必要です。両方がコンテンツソース用に設定されていることを確認します。
垂直ページにコンテンツソースが表示されません。	コネクタとインデックス付きデータが構成されていることを確認してください。

次の方法で共有

検索バーティカルを管理する

既定の縦書き

カスタムの縦書き

検索バーティカルを作成または変更する

organization レベルの垂直線を管理する

サイトレベルの縦書きを管理する

検索結果ページで垂直を表示する

高度な構成オプション

垂直方向の複数の接続

キーワードクエリ言語 (KQL)

プロファイルクエリ変数

クエリ文字列変数

制限事項

トラブルシューティング

その他のリソース

次の方法で共有

検索バーティカルを管理する

既定の縦書き

カスタムの縦書き

検索バーティカルを作成または変更する

organization レベルの垂直線を管理する

サイト レベルの縦書きを管理する

検索結果ページで垂直を表示する

高度な構成オプション

垂直方向の複数の接続

キーワード クエリ言語 (KQL)

プロファイル クエリ変数

クエリ文字列変数

制限事項

トラブルシューティング

その他のリソース

サイトレベルの縦書きを管理する

キーワードクエリ言語 (KQL)

プロファイルクエリ変数