Anzeigen von Werten aus benutzerdefinierten verwalteten Eigenschaften in klassischen Suchergebnissen – Option 1 in SharePoint Server
GILT FÜR:
2013 2016 2019 Subscription Edition 
SharePoint in Microsoft 365
Inhalt dieses Artikels:
Anzeigen eines benutzerdefinierten Symbols
Unter Grundlegendes zur Anzeige von Suchergebnissen in SharePoint Server haben wir erläutert, wie die Symbole Word, PDF und Excel für klassische Suchergebnisse angezeigt werden. In unserem Suchcenterszenario möchten wir das folgende benutzerdefinierte Symbol neben allen Suchergebnissen anzeigen, die zum neu erstellten Ergebnistyp TechNet-Inhalt gehören:
TN
Gehen Sie wie folgt vor, um ein benutzerdefiniertes Symbol für klassische Suchergebnisse anzuzeigen:
Fügen Sie das benutzerdefinierte Symbol einer SharePoint Server-Bibliothek hinzu.
In unserem Suchcenterszenario haben wir das benutzerdefinierte Symbol der Bibliothek Bilder hinzugefügt.
Öffnen Sie die Elementanzeigevorlage, auf die der Ergebnistyp verweist, für den Sie ein benutzerdefiniertes Symbol anzeigen möchten.
In unserem Suchcenterszenario haben wir auch die IF-Anweisung entfernt: if (ctx.CurrentItem.IsContainer).
Geben Sie auf einer Suchseite eine Abfrage ein, die den neuen Ergebnistyp auslöst.
In unserem Suchcenter-Szenario haben wir "Ergebnistyp" eingegeben. Suchergebnisse, bei denen es sich um TechNet-Veröffentlichungen handelt, haben jetzt ein benutzerdefiniertes Symbol neben ihnen. Großartig!
Die Benutzer unseres Suchcenters können nun einfach erkennen, dass die Suchergebnisse aus TechNet stammen. Doch wir wollten auch Informationen aus benutzerdefinierten Websitespalten hinzufügen, damit Benutzer wichtige Informationen zu jedem Suchergebnis erhalten, ohne darauf klicken zu müssen.
Unter Grundlegendes zur Anzeige von Suchergebnissen in SharePoint Server haben wir erläutert, dass Websitespalten während der Durchforstung in verwaltete Eigenschaften "transformiert" werden. Wir haben ferner erläutert, dass nur verwaltete Eigenschaften, die in der Elementanzeigevorlage aufgeführt sind, in Suchergebnissen angezeigt werden können. Damit also benutzerdefinierte Informationen in Ihren Suchergebnissen angezeigt werden, müssen Sie einer Elementanzeigevorlage verwaltete Eigenschaften hinzufügen. Als Nächsten müssen Sie deshalb den Namen der verwalteten Eigenschaft finden, der der benutzerdefinierten Websitespalte entspricht, die Sie verwenden möchten.
Finden des Namens einer verwalteten Eigenschaft
Bevor Sie nach dem Namen einer verwalteten Eigenschaft suchen, sollten Sie sich ein wenig mit der Benennungskonvention für verwaltete Eigenschaften vertraut machen. Weitere Informationen hierzu finden Sie unter Informationen zu den Benennungskonventionen für automatisch erstellte durchforstete und verwaltete Eigenschaften.
Je nach Berechtigungsstufe können Sie an drei Stellen nach verwalteten Eigenschaften suchen:
| Berechtigungsstufe | Ausgangsspeicherort für die Suche |
|---|---|
| Administrator einer Suchdienstanwendung |
Zentraladministration --> Verwaltete Dienstanwendung --> Suchdienstanwendung --> Suchschema |
| Websitesammlungsadministrator |
Websiteeinstellungen --> Suchschema (im Abschnitt Websitesammlungsverwaltung) |
| Websitesammlungsbesitzer |
Websiteeinstellungen --> Schema (im Abschnitt Suchen) |
Gehen Sie so vor:
Wechseln Sie zu Websiteeinstellungen>Suchschema.
Geben Sie auf der Seite Verwaltete Eigenschaften im Feld Verwaltete Eigenschaft den Namen der Websitespalte ein, für die Sie den Namen der verwalteten Eigenschaft suchen möchten. Denken Sie daran, dass die verwaltete Eigenschaftennamen keine Leerzeichen enthalten. Wenn also der Name der Websitespalte ein Leerzeichen enthält, lassen Sie es weg.
In unserem Suchcenterszenario wollten wir den verwaltete Eigenschaftennamen der Websitespalte Content Summary finden. Wir haben ContentSummary in das Feld Verwaltete Eigenschaft eingegeben und das grüne Pfeilsymbol ausgewählt.
Ein Suchergebnis wurde zurückgegeben: ContentSummaryOWSMTXT.
Da die Websitespalte Content Summary den Typ Mehrere Textzeilen hat, wussten wir, dass dies der Name unserer gewünschten verwalteten Eigenschaft war.
Wiederholen Sie die Schritte dieser Vorgehensweise, um die Namen aller verwalteten Eigenschaften zu finden, die Sie in Ihren Suchergebnissen anzeigen möchten.
Nun da Sie diese Namen gefunden haben, ist der nächste Schritt das Ändern der Elementanzeigevorlage.
Ändern einer Elementanzeigevorlage zum Anzeigen von aus benutzerdefinierten verwalteten Eigenschaften stammenden Werten – Option 1
Unter Grundlegendes zur Anzeige von Suchergebnissen in SharePoint Server haben wir erwähnt, dass es mehrere Möglichkeiten gibt, eine Elementanzeigevorlage so zu ändern, dass Werte aus benutzerdefinierten verwalteten Eigenschaften angezeigt werden. Die in diesem Abschnitt erläuterte Option ist sehr einfach. Die zweite Option behandeln wir im nächsten Artikel dieser Reihe. Sie sieht keine IF-Anweisungen vor, und die Hervorhebung von Treffern wird nicht aktiviert.
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.
- Verwenden Sie im zweiten <div>-Tag im Abschnitt <body> die folgende Syntax, um Code hinzuzufügen, der den Wert der benutzerdefinierten verwalteten Eigenschaft anzeigt:
_#= ctx.CurrentItem.<Current item property name> =#
In unserem Suchcenterszenario haben wir der Elementanzeigevorlage Folgendes hinzugefügt:
<div>_#= ctx.CurrentItem. ContentSummaryOWSMTXT =#_</div>
<div>_#= ctx.CurrentItem. owstaxIdTechnicalSubject =#></div>
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, da wir einer Elementanzeigevorlage (in Schritt 2) verwaltete Eigenschaften hinzugefügt haben. Um die Ergebnistypen mit den neu hinzugefügten verwalteten Eigenschaften zu aktualisieren, wählen Sie Aktualisieren aus.
Wichtig
Wenn diese Aktualisierung nicht erfolgt, werden die neu hinzugefügten verwalteten Eigenschaften nicht in Ihren Suchergebnissen angezeigt.
Nachdem wir diese Änderung vorgenommen haben, wurden beim Eingeben einer Abfrage in unser Suchcenter sowohl der Wert von ContentSummaryOWSMTXT als auch der Wert für owstaxIdTechnicalSubject in den Suchergebnissen angezeigt.
Obwohl zwei benutzerdefinierte Eigenschaften in den Suchergebnissen angezeigt wurden, war das Ergebnis nicht vollständig richtig. Wir wollten beispielsweise die beiden benutzerdefinierten Eigenschaften zwischen dem Titel und dem Link und nicht wie derzeit unter dem Link anzeigen.
Um besser zu verstehen, warum die Suchergebnisse auf diese Weise angezeigt wurden, schauen wir uns die angepasste Elementanzeigevorlage ein wenig genauer an:
ctx.CurrentItem.csr_Iconverweist auf den Speicherort des benutzerdefinierten Symbols. Die Variable wird von der Anzeigevorlage Item_CommonItem_Body verwendet._#=ctx.RenderBody(ctx)=#_ruft die Item_CommonItem_Body-Anzeigevorlage auf. (Denken Sie daran , zu verstehen, wie Elementanzeigevorlagen und Treffermarkierungen in SharePoint Server funktionieren. Die Item_CommonItem_Body Anzeigevorlage zeigt das benutzerdefinierte Symbol, den Titel und den Link zum Element an.)_#= ctx.CurrentItem.ContentSummaryOWSMTXT =#_und_#= ctx.CurrentItem.owstaxIdTechnicalSubject =#_zeigen die Werte der beiden verwalteten Eigenschaften ContentSummaryOWSMTXT und owstaxIdTechnicalSubject an.
Um die benutzerdefinierten Eigenschaften zwischen dem Titel und dem Link anzuzeigen, können Sie die Item_CommonItem_Body Anzeigevorlage aus dem Spiel nehmen, indem Sie den Verweis _#=ctx.RenderBody(ctx)=#_ aus Ihrer benutzerdefinierten Anzeigevorlage löschen. Sie können anschließend die Eigenschaften in der gewünschten Anzeigereihenfolge beispielsweise wie folgt hinzufügen:
Das Suchergebnis sähe dann so aus:
Wenn Sie die Formatierung noch ein bisschen anpassen, kann sich das Ergebnis sehen lassen. Durch das Löschen des Verweises auf _#=ctx.RenderBody(ctx)=#_ wird die Item_CommonItem_Body Anzeigevorlage nicht mehr zum Anzeigen von Ergebnissen verwendet. Die Item_CommonItem_Body Anzeigevorlage enthält einige Funktionen, die die Relevanz Ihrer klassischen Suchergebnisse automatisch verbessern. Doch bevor Sie also den Verweis _#=ctx.RenderBody(ctx)=#_ löschen, müssen Sie prüfen, ob eine automatisch verbesserte Relevanz etwas ist, wovon die Benutzer Ihrer Suchwebsite profitieren würden.
Informationen zum Nachverfolgen des Klickverhaltens und automatischen Verbessern von Relevanz
Die Anzeigevorlage Item_CommonItem_Body enthält die onlick-Methode zum Nachverfolgen des Klickverhaltens von Benutzern. Diese Nachverfolgung beeinflusst die Relevanz klassischer Suchergebnisse. Ein Suchergebnis, auf das Benutzer oft klicken, wird in den Suchergebnissen automatisch höher angezeigt.
Wichtig
Wenn Ihre klassischen Suchergebnisse basierend auf dem Klickverhalten von Benutzern automatisch eine verbesserte Relevanz erhalten sollen, löschen Sie den Verweis auf _#=ctx.RenderBody(ctx)=#_ nicht aus der Elementanzeigevorlage.
Im nächsten Artikel wird erläutert, wie Sie diesen Verweis beibehalten, benutzerdefinierte Eigenschaften zwischen dem Titel und dem Link in den klassischen Suchergebnissen anzeigen und auch Treffermarkierung auf Ihre benutzerdefinierten Eigenschaften anwenden können.