Anzeigen von Werten aus benutzerdefinierten verwalteten Eigenschaften in klassischen Suchergebnissen – Option 2 in SharePoint Server
GILT FÜR:
2013 2016 2019 Subscription Edition 
SharePoint in Microsoft 365
Unter Anzeigen von Werten aus benutzerdefinierten verwalteten Eigenschaften in Suchergebnissen – Option 1 in SharePoint Server haben wir eine einfache Methode zum Hinzufügen eines benutzerdefinierten Symbols und von Werten aus zwei benutzerdefinierten verwalteten Eigenschaften zu Ihren klassischen Suchergebnissen gezeigt. In diesem Artikel betrachten wir eine umfassendere Methode zum Ändern der Anzeige klassischer Suchergebnisse, die if-Anweisungen und Treffermarkierung umfasst. Inhalt dieses Artikels:
"Zwei Fliegen mit einer Klappe schlagen" - Strategie für Suchergebnisse
Lassen Sie uns zunächst angeben, was wir erreichen möchten:
Anzeigen von Werten von zwei benutzerdefinierten Eigenschaften
Anwenden der Treffermarkierung auf die beiden benutzerdefinierten Eigenschaften
Erhalten Sie automatisch verbesserte Relevanz für unsere klassischen Suchergebnisse.
Bevor wir uns im Einzelnen damit beschäftigen, wie wir diese Ziele erreichen können, sehen wir uns die Strategie an, die wir einsetzen möchten. Wenn die Ausführungen ein wenig komplex werden, versuchen Sie dennoch, am Ball zu bleiben. Hoffentlich wird es am Ende klar sein.
Erinnern Sie sich zuerst daran, wie Sie sich die Treffermarkierung vorstellen können:
Die verwalteten Eigenschaften, die im Abschnitt Eigenschaften für Trefferhervorhebung (JSON) des Suchergebnisse-Webparts aufgelistet sind, und die Eigenschaft für die "magische Zusammenfassung" werden an die HitHighlightedProperties-Eigenschaft übergeben.
Alle Werte der Eigenschaft HitHighlightedProperties werden an die Eigenschaft HitHighlightedSummary weitergegeben.
Eine abgeschnittene Version der Werte in HitHighlightedSummary wird im Suchergebnisse-Webpart mit drei Punkten am Ende angezeigt.
Denken Sie auch daran, dass jede Elementanzeigevorlage einen Verweis auf die Item_CommonItem_Body Anzeigevorlage enthält und dass diese Vorlage eine onlick-Methode enthält, die basierend auf dem Klickverhalten des Benutzers automatisch zu einer verbesserten Relevanz führt.
Wir setzen nun folgende Strategie um: Wir erstellen Variablen in der Elementanzeigevorlage, die von der Anzeigevorlage Item_CommonItem_Body übergeben und gerendert werden.
Dies bedeutet, dass wir insbesondere folgende Schritte durchführen müssen:
Fügen Sie die benutzerdefinierten verwalteten Eigenschaften, die in unseren klassischen Suchergebnissen angezeigt werden sollen, den Eigenschaften mit Treffermarkierung im Suchergebnisse-Webpart hinzu.
Fügen Sie die benutzerdefinierten verwalteten Eigenschaften einer Elementanzeigevorlage hinzu.
Erstellen Sie in der Elementanzeigevorlage eine Variable, die von der Eigenschaft HitHighlightedSummary verwendet wird, um unsere beiden benutzerdefinierten verwalteten Eigenschaften mit Treffermarkierung anzuzeigen.
Behalten Sie in der Elementanzeigevorlage den Verweis
_#=ctx.RenderBody(ctx)=#_bei, damit die Item_ComonItem_Body Anzeigevorlage das Suchergebnis rendert. Dadurch wird sichergestellt, dass die Relevanz automatisch verbessert wird.
Ok, jetzt gehen wir es Schritt für Schritt mit Beispielen dafür, wie wir dies für unser Suchcenter-Szenario gemacht haben.
Anzeigen von Werten von benutzerdefinierten Eigenschaften mit Treffermarkierung und Erzielen automatisch verbesserter Relevanz
Zuerst müssen Sie die Namen der verwalteten Eigenschaften finden, die den benutzerdefinierten Websitespalten entsprechen, die Sie verwenden möchten. Wir haben uns die Vorgehensweise unter Anzeigen von Werten aus benutzerdefinierten verwalteten Eigenschaften in Suchergebnissen – Option 1 in SharePoint Server angesehen.
Als Nächstes müssen Sie einige Konfigurationsschritte für das Suchergebnisse-Webpart durchführen. Die Schritte sind hier aufgeführt:
Wählen Sie auf der Seite Suchergebnisse das Menü Einstellungen und dann Seite bearbeiten aus.
Wählen Sie im Suchergebnisse-Webpart Webpart menü>Webpart bearbeiten aus.
Erweitern Sie im Webpart-Toolbereich den Abschnitt Anzeigevorlagen , und wählen Sie dann Einzelne Vorlage zum Anzeigen von Elementen verwenden aus. Auf diese Weise können Sie das Json-Feld (Hit-highlighted properties) ändern.
Verwenden Sie im Feld Eigenschaften für Trefferhervorhebung (JSON) das folgende Format, um die benutzerdefinierten verwalteten Eigenschaften hinzuzufügen, denen Sie die Treffermarkierung hinzufügen möchten:
"<Name> der verwalteten Eigenschaft"
In unserem Suchcenter-Szenario möchten wir den verwalteten Eigenschaften ContentSummaryOWSMTXT und owstaxIdTechnicalSubject die Treffermarkierung hinzufügen.
Wählen Sie Übernehmen aus, um die Änderungen zu speichern. Der Abschnitt Anzeigevorlagen wird geschlossen.
Um den Abschnitt erneut zu öffnen, wählen Sie Vorlagen anzeigen und dann Ergebnistypen zum Anzeigen von Elementen verwenden aus.
Wählen Sie OK aus, und speichern Sie die Seite.
Als Nächstes müssen Sie die benutzerdefinierten verwalteten Eigenschaften einer Elementanzeigevorlage hinzufügen. Gehen Sie so vor:
Öffnen Sie die Elementanzeigevorlage, die zum Ergebnistyp gehört, für den Sie Suchergebnisse anpassen möchten.
In unserem Suchcenter-Szenario war dies TechNet-Inhalte.
Verwenden Sie in der Elementanzeigevorlage im ManagedPropertyMapping-Tag die folgende Syntax zum Hinzufügen der gewünschten benutzerdefinierten verwalteten Eigenschaften:
'<Current item property name>':<Managed property name>'
In unserem Suchcenterszenario sollen die Werte aus den verwalteten Eigenschaften ContentSummaryOWSMTXT und owstaxIdTechnicalSubject im Suchergebnis angezeigt werden. Damit die Datei einfacher verwaltet werden kann, gaben wir den aktuellen Elementeigenschaften den gleichen Namen wie den verwalteten Eigenschaften.
Als Nächstes müssen Sie Variablen in der Elementanzeigevorlage erstellen, die von der Anzeigevorlage Item_Common_Item_Body verwendet und gerendert werden. Gehen Sie dabei wie folgt vor:
Da Sie keine Garantie dafür haben, dass die Werte Ihrer benutzerdefinierten Eigenschaften eines der eingegebenen Abfragewörter enthalten, d. h. die Treffermarkierung wird nicht verwendet, müssen Sie Variablen erstellen, die garantieren, dass der Wert Ihrer benutzerdefinierten Eigenschaften unabhängig von der Treffermarkierung angezeigt wird.
Die folgenden Screenshots zeigen, wie wir zwei solche Variablen für unsere benutzerdefinierten Eigenschaften ContentSummaryOWSMTXT und owstaxIdTechnicalSubject erstellt haben.
Außerdem haben wir eine ähnliche Variable für die Eigenschaft Titel hinzugefügt. Wenn Sie dies nicht hinzufügen, werden die Suchergebnisse nicht gerendert.
Im letzten Schritt, den Sie in der Elementanzeigevorlage durchführen müssen, erstellen Sie eine Variable, die die zum Anzeigen der Werte verwendete Eigenschaft HitHighlightedSummary außer Kraft setzt.
Speichern Sie die Elementanzeigevorlage.
Hinweis
Sie müssen diesen Schritt nicht ausführen, wenn Sie SharePoint in Microsoft 365 verwenden. Wechseln Sie zu Websiteeinstellungen>Suchergebnistypen. Eine Warnung zur Eigenschaftensynchronisierung wird angezeigt.
Diese Warnung wird angezeigt, weil wir einer Elementanzeigevorlage verwaltete Eigenschaften hinzugefügt haben (was wir in Schritt 9 getan haben). Wählen Sie Update aus, um die Ergebnistypen mit den neu hinzugefügten verwalteten Eigenschaften zu aktualisieren.
Wichtig
Wenn Sie diese Aktualisierung nicht durchführen, werden die neu hinzugefügten verwalteten Eigenschaften nicht in den Suchergebnissen angezeigt.
Nachdem diese Änderungen durchgeführt wurden, enthalten die Suchergebnisse Folgendes, wenn Benutzer eine Abfrage im Suchcenter eingeben:
Ein benutzerdefiniertes Symbol
Den Wert von Titel mit Treffermarkierung
Den Wert von ContentSummaryOWSMTXT mit Treffermarkierung
Der Wert von owstaxIdTechnicalSubject (Die Abfragewörter stimmten nicht mit dem Eigenschaftswert überein, aber aufgrund der Variablen, die wir in Schritt 10 erstellt haben, wird der Wert angezeigt.)
Einen Link zu dem Element in der Liste
Wir wollten eine kleine Änderung daran vornehmen, wie der Wert für owstaxIdTechnicalSubject angezeigt wird. Außerdem wollten wir den Benutzern etwas mehr Kontext dazu bieten, was dieser Wert darstellt. Daher entschieden wir uns dafür, vor dem Wert den Text "Technisches Thema:" hinzuzufügen. Da dieser Wert nicht immer für alle Listenelemente vorhanden ist, haben wir uns entschieden, dass er nur angezeigt werden sollte, wenn ein Wert vorhanden war.
Hierfür nahmen wir eine Änderung an der Variablen vor, die die Eigenschaft HitHighlightedSummary außer Kraft setzt:
Beachten Sie, dass wir dem Text "Technical Subject:" eine etwas andere Farbe hinzugefügt haben. Das endgültige Suchergebnis wird nun wie wie folgt angezeigt:
Unter Erstellen eines neuen Ergebnistyps in SharePoint Server hatten wir uns entschieden, sechs verschiedene Ergebnistypen zu verwenden. Nach dem Erstellen des TechNet-Inhaltsergebnistyps und der Anzeigevorlage war es einfach, diese Arbeit in die anderen fünf Ergebnistypen zu kopieren.
Und hier ist das Ergebnis:
Nachdem wir nun die Anzeige klassischer Suchergebnisse geändert haben, besteht der nächste Schritt darin, die Werte zu ändern, die im Mauszeigerbereich angezeigt werden.