Von Werten von benutzerdefinierten verwalteten Eigenschaften in Suchergebnissen – Option 1 in SharePoint Server

**Gilt für:**SharePoint Server 2013, SharePoint Server 2016

**Letztes Änderungsdatum des Themas:**2018-03-07

Zusammenfassung: Hier erfahren Sie, eine Option zum Anzeigen von Werten von benutzerdefinierten verwalteten Eigenschaften in SharePoint Server.

Inhalt dieses Artikels:

• Anzeigen eines benutzerdefinierten Symbols

• Finden des Namens einer verwalteten Eigenschaft

• Ändern einer Elementanzeigevorlage zum Anzeigen von aus benutzerdefinierten verwalteten Eigenschaften stammenden Werten - Option 1

• Informationen zum Nachverfolgen des Klickverhaltens und automatischen Verbessern von Relevanz

Anzeigen eines benutzerdefinierten Symbols

Unter Grundlegendes zur Anzeige der Suchergebnisse in SharePoint Server haben wir erklärt, wie die Symbole Word, PDF und Excel für die einzelnen 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

Führen Sie die folgenden Schritte aus, um für Suchergebnisse ein benutzerdefiniertes Symbol anzuzeigen:

1. Das benutzerdefinierte Symbol einer Bibliothek SharePoint Server hinzufügen.

   In unserem Suchcenterszenario haben wir das benutzerdefinierte Symbol der Bibliothek Bilder hinzugefügt.

   

2. Ö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).

   

3. Geben Sie auf einer Suchseite eine Abfrage ein, die den neuen Ergebnistyp auslöst.

4. In unserem Suchcenterszenario haben wir "Ergebnistyp" eingegeben. Neben Suchergebnissen, die TechNet-Publikationen sind, befindet sich jetzt ein benutzerdefiniertes Symbol.

   

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.

In Grundlegendes zur Anzeige der Suchergebnisse in SharePoint Server haben wir erklärt, dass Websitespalten während einer Durchforstung in verwaltete Eigenschaften umgewandelt 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 Benennungskonventionen für automatisch erstellte durchforstete Eigenschaften und verwaltete Eigenschaften.

Je nach Berechtigungsstufe können Sie an drei Stellen nach verwalteten Eigenschaften suchen:

Gehen Sie so vor:

1. Wechseln Sie zu Websiteeinstellungen --> Suchschema.

   

2. Geben Sie auf der Seite Verwaltete Eigenschaften in das Feld Verwaltete Eigenschaft den Namen der Websitespalte an, deren verwalteten Eigenschaftennamen Sie finden 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 auf den grünen Pfeil geklickt.

   

   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.

3. 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

In Grundlegendes zur Anzeige der Suchergebnisse in SharePoint Server haben wir erwähnt, dass es mehrere Möglichkeiten zum Ändern einer Elementanzeigevorlage dergestalt gibt, 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:

1. Ö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.

2. 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 Suchcenter-Szenario sollten die Werte von 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.

   

3. 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>
   

   

4. Speichern Sie die Elementanzeigevorlage.

5. Hinweis

   Bei Verwenden von SharePoint Online ist dieser Schritt nicht erforderlich. Wechseln Sie zu Websiteeinstellungen --> Suchergebnistypen. Beachten Sie, dass die Warnung Eigenschaftensynchronisierung angezeigt wird.

   

   Diese Warnung wird angezeigt, da wir einer Elementanzeigevorlage (in Schritt 2) verwaltete Eigenschaften hinzugefügt haben. Zum Aktualisieren der Ergebnistypen mit den neu hinzugefügten verwalteten Eigenschaften klicken Sie auf Aktualisieren.

   

   Wichtig

   Wenn diese Aktualisierung nicht erfolgt, werden die neu hinzugefügten verwalteten Eigenschaften nicht in Ihren Suchergebnissen angezeigt.

   Nachdem Benutzer nach dieser Änderung in unserem Suchcenter eine Abfrage eingegeben haben, wurde der Wert von ContentSummaryOWSMTXT und owstaxIdTechnicalSubject in den Suchergebnissen angezeigt.

   

   Doch auch wenn die beiden benutzerdefinierten Eigenschaften nun in den Suchergebnissen angezeigt werden, war das Resultat nicht vollständig wie gewünscht. 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:

1. ctx.CurrentItem.csr_Icon verweist auf den Speicherort des benutzerdefinierten Symbols. Die Variable wird von der Anzeigevorlage Item_CommonItem_Body verwendet.

2. _#=ctx.RenderBody(ctx)=#_ ruft die Anzeigevorlage Item_CommonItem_Body auf. (Siehe Grundlegendes zu anzeigen wie Vorlagen und treffermarkierungen in SharePoint Server. Die Anzeigevorlage Item_CommonItem_Body dient zum Anzeigen des benutzerdefinierten Symbols, Titels und Links zum Element.)

3. _#= ctx.CurrentItem.ContentSummaryOWSMTXT =#_ und _#= ctx.CurrentItem.owstaxIdTechnicalSubject =#_ zeigen die Werte der beiden verwalteten Eigenschaften ContentSummaryOWSMTXT und owstaxIdTechnicalSubject.

Zum Anzeigen der benutzerdefinierten Eigenschaften zwischen dem Titel und dem Link können Sie die Anzeigevorlage Item_CommonItem_Body deaktivieren, 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. Doch durch Löschen des Verweises auf _#=ctx.RenderBody(ctx)=#_ dient die Anzeigevorlage Item_CommonItem_Body nicht mehr zum Anzeigen von Ergebnissen. Die Anzeigevorlage Item_CommonItem_Body enthält Funktionalität, die die Relevanz Ihrer Suchergebnisse automatisch verbessert. 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. Dieses Nachverfolgen beeinflusst die Relevanz von Suchergebnissen. Ein Suchergebnis, auf das Benutzer oft klicken, wird in den Suchergebnissen automatisch höher angezeigt.

Im nächsten Artikel erläutern wir, wie Sie diesen Verweis beibehalten können, benutzerdefinierte Eigenschaften zwischen Titel und Link in den Suchergebnissen anzeigen und die Trefferhervorhebung für Ihre benutzerdefinierten Eigenschaften aktivieren.

Nächster Artikel dieser Reihe

Von Werten von benutzerdefinierten verwalteten Eigenschaften in Suchergebnissen – Option 2 in SharePoint Server