SharePoint Server でホバー パネルにカスタム管理プロパティの値を表示する方法
適用対象:
2016 2019 Subscription Edition 
SharePoint in Microsoft 365
「 検索結果にカスタム管理プロパティの値を表示する方法 - SharePoint Server のオプション 2」で 、ヒットの強調表示を使用してカスタム管理プロパティの値を表示し、エンド ユーザーのクリック動作に基づいて自動的に関連性を向上させる方法を示しました。 この記事では、以下について説明します。
変更するホバー パネル表示テンプレートを決定する方法
まず最初に、さまざまな表示テンプレートがどのように接続されるかについて復習します。
それぞれの結果種類には、1 つのアイテム表示テンプレートへの参照が含まれています。
それぞれのアイテム表示テンプレートには、ホバー パネル表示テンプレートへの参照が含まれています。
各アイテム表示テンプレートには、共通アイテム表示テンプレートへの参照が含まれています。
参照されている各ホバー パネル表示テンプレートには、3 つの共通ホバー パネル表示テンプレートへの参照が含まれています。
既定では、ホバー パネルのレンダリングは 3 つの共通ホバー パネル表示テンプレートによって実行されます。 以下の図は、検索センターのシナリオで、既定のホバー パネルをレンダリングするために共通ホバー パネル表示テンプレートが使用される方法を示しています。
ホバー パネルにカスタム プロパティを追加する際に便利なように、これら 3 つの共通ホバー パネル表示テンプレートを現状のままに維持して、代わりに結果の種類特定のホバー パネル表示テンプレートに注意を向けます (下の図で強調表示されています)。 それが検索センターのシナリオで行ったことであり、またこの記事で例示することでもあります。
今は分かりにくい場合もありますが、次の 2 つのセクションで、必要なすべての手順を説明します。 では開始します。
既存のホバー パネル表示テンプレートをコピーする方法
カスタムアイテム表示テンプレート TechNet コンテンツ を作成したとき、 まず Item_Default という名前のアイテム表示テンプレートをコピーしました (詳細については、「 SharePoint Server で新しい結果の種類を作成する方法 」を参照してください)。 Item_Default 表示テンプレートには、Item_Default_HoverPanel ホバー パネル表示テンプレートへの参照が含まれています。 Item_Default表示テンプレートをコピーしたため、TechNet コンテンツ表示テンプレートには、Item_Default_HoverPanel への参照も含まれています。
カスタム プロパティをホバー パネルに追加するときは、Item_Default_HoverPanel ホバー パネル表示テンプレートを基礎として使用します。 そのため、マップされたネットワーク ドライブで、Item_Default_HoverPanel 表示テンプレートをコピーしました。
新しい名前を付TechNet_Content_HoverPanel。
関連付けられた JavaScript ファイルの名前は自動的に更新されるので、HTML ファイルの名前だけを変更する必要がありました。
TechNet コンテンツ表示テンプレートで、var hoverUrl 内の参照を変更して、新しくコピーして名前変更した TechNet_Content_HoverPanel 表示テンプレートが指定されるようにしました。
カスタム管理プロパティの値を示すようにホバー パネル表示テンプレートを変更する方法
検索センターのシナリオでは、既定のホバー パネルには検索結果についての追加情報がほとんど含まれていません。
次の 4 つのサイト列からホバー パネルに値を追加することにしました。
GUID/UUID
内部ライター
状態
送信連絡先
次のスクリーン ショットは、内部リストの 1 つのアイテムに対して、それらの値が維持される方法を示しています。
カスタム プロパティをホバー パネルに追加するとき、それらをアイテム表示テンプレート (下の図では強調表示されています) に追加する必要があります。
これも、実際には直観的でないため、次のことを行う必要があります。カスタム プロパティをホバー パネルに追加するときには、それらをアイテム表示テンプレートに追加する必要があります。.
カスタム プロパティをホバー パネルに表示するには、以下のことを行う必要があります。
使用するサイト列の管理プロパティの名前を見つけます。 検索結果にカスタム管理プロパティの値を表示する方法 - SharePoint Server のオプション 1 で これを行う方法を示しました。
カスタマイズするホバー パネル表示テンプレートへの参照を含むアイテム表示テンプレートを開きます。 アイテム表示テンプレートの [ManagedPropertyMapping] タグで、次の構文を使用して、表示するカスタム管理プロパティを追加します。
'<Current item property name>':<Managed property name>'検索センターのシナリオでは、[TechNet コンテンツ] のアイテム表示テンプレートに 4 つの管理プロパティを追加しました。
-
注:
Microsoft 365 で SharePoint を使用している場合は、この手順を実行する必要 はありません 。
Go to Site settings>Search Result Types. プロパティ同期アラートが表示されます。
![[プロパティの同期] 通知](../sharepointserver/media/otcsp_propertysyncalert.png)
このアラートは、項目表示テンプレートに新しい管理プロパティを追加したために表示されます (手順 2 でこれを行いました)。 新しく追加された管理プロパティによって結果の種類を更新するためには、[ 更新 ] を選択します。
重要
更新を行わないと、新しく追加された管理プロパティはホバー パネルに表示されません。
変更するホバー ネル表示テンプレートを開いて、HTML を使用することにより、表示するカスタム プロパティを追加します。
Search Center のシナリオでは、*TechNet_Content_HoverPanelを開きました。 次のスクリーンショットは、4 つのカスタム プロパティを追加した方法を示しています。
ファイルを保存します。
新しい検索を実行して、検索結果の上にカーソルを合わせると、4 つのカスタム プロパティが表示されるようになったことを確認できました。 良好です。
しかしまだ完成ではありません。 [内部ライター] と [申請連絡先] の値が異なって表示されました。 スクリーン ショットでは明確に表示されない場合がありますが、 内部ライター の値が適切に表示されているのに、 申請連絡先 の値が非常に長く、醜い GUID が含まれていたことを願っています。
これらの値はどちらも、種類が [ユーザーまたはグループ] のサイト列からのものです。 ただしサイト列設定で、[内部ライター] は名前を示すように構成され、[送信連絡先] は名前 (プレゼンス付き) を示すように構成されている点が異なります。
提出連絡先が正しく表示されるように、HP をコピーしました。Item_CommonHoverPanel_Body表示テンプレートによって作成者を表示するために使用される GetAuthorsHtml メソッド。
これでホバー パネルの見栄えが良くなってきました。
しかし、ホバー パネルをさらに便利にするために、ホバー パネルの下部にアクションを追加することにしました。 この方法を説明します。