Gewusst wie: Anzeigen von Werten von benutzerdefinierten verwalteten Eigenschaften im daraufzeigebereich in SharePoint Server

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

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

Zusammenfassung: Informationen Sie zum Anzeigen von Werten von benutzerdefinierten verwalteten Eigenschaften im daraufzeigebereich in SharePoint Server.

Unter Von Werten von benutzerdefinierten verwalteten Eigenschaften in Suchergebnissen – Option 2 in SharePoint Server haben Sie erfahren, wie Sie Werte von benutzerdefinierten verwalteten Eigenschaften mit der Treffermarkierung anzeigen können und automatisch auf Basis des Klickverhaltens der Endbenutzer eine verbesserte Relevanz erhalten. In diesem Artikel erhalten Sie Informationen zum:

• Entscheiden, welche Daraufzeigebereichs-Anzeigevorlage zu ändern ist

• Kopieren einer vorhandenen Daraufzeigebereichs-Anzeigevorlage

• Ändern einer Daraufzeigebereichs-Anzeigevorlage für die Anzeige von Werten aus benutzerdefinierten verwalteten Eigenschaften

Entscheiden, welche Daraufzeigebereichs-Anzeigevorlage zu ändern ist

Als Erstes müssen wir uns klar werden, wie die unterschiedlichen Anzeigevorlagen miteinander in Zusammenhang stehen:

1. Jeder Ergebnistyp enthält einen Verweis zu einer Elementanzeigevorlage.

2. Jede Elementanzeigevorlage enthält einen Verweis zu einer Daraufzeigebereichs-Anzeigevorlage.

3. Jede Elementanzeigevorlage enthält einen Verweis zu einer allgemeinen Elementanzeigevorlage.

4. Jede referenzierte Daraufzeigebereichs-Anzeigevorlage enthält Verweise zu drei allgemeinen Daraufzeigebereichs-Anzeigevorlagen.

Standardmäßig wird das Rendern des Daraufzeigebereichs durch die drei allgemeinen Daraufzeigebereichs-Anzeigevorlagen vorgenommen. In der folgenden Abbildung wird veranschaulicht, wie der allgemeine Daraufzeigebereich zum Rendern des Standarddaraufzeigebereichs in unserem Suchcenter-Szenario verwendet wurde.

Sie sollten diese drei allgemeinen Daraufzeigebereichs-Anzeigevorlagen beim Hinzufügen von benutzerdefinierten Eigenschaften zu Ihrem Daraufzeigebereich aus Einfachheitsgründen nicht ändern. Demgegenüber sollten Sie sich auf den für die Daraufzeigebereichs-Anzeigevorlage spezifischen Ergebnistyp konzentrieren (in der folgenden Abbildung hervorgehoben). Selbiges haben wir in unserem Suchcenter-Szenario vorgenommen, und das veranschaulichen wir auch in diesem Artikel.

Das mag momentan ein wenig verwirrt sein, aber wir zeigen Ihnen alle erforderlichen Schritte in den nächsten beiden Abschnitten. Legen wir los!

Kopieren einer vorhandenen Daraufzeigebereichs-Anzeigevorlage

Beim Erstellen der benutzerdefinierten Elementanzeigevorlage TechNet-Inhalt haben wir zunächst die Elementanzeigevorlage namens Item_Default (weitere Informationen finden Sie unter Gewusst wie: erstellen ein neuen Ergebnistyps in SharePoint Server) kopiert. Die Item_Default-Anzeigevorlage enthält einen Verweis zur Item_Default_HoverPanel-Daraufzeigebereichs-Anzeigevorlage. Da wir die Item_Default-Anzeigevorlage kopiert haben, enthält unsere TechNet-Inhaltsanzeigevorlage zudem einen Verweis zum Item_Default_HoverPanel.

Wir möchten die Item_Default_HoverPanel-Daraufzeigebereichs-Anzeigevorlage als eine Grundlage verwenden, wenn wir benutzerdefinierte Eigenschaften zu unserem Daraufzeigebereich hinzufügen. Daher haben wir in unserem zugeordneten Netzlaufwerk die Anzeigevorlage Item_Default_HoverPanel kopiert

und sie wie folgt benannt: TechNet_Content_HoverPanel.

Wir mussten nur die HTML-Datei umbenennen, da der Name der zugehörigen JavaScript-Datei automatisch aktualisiert wurde.

In der TechNet-Inhaltsanzeigevorlage haben wir den Verweis in var hoverUrl geändert, sodass sie auf die neu kopierte und umbenannte Anzeigevorlage TechNet_Content_HoverPanel zeigte.

Ändern einer Daraufzeigebereichs-Anzeigevorlage für die Anzeige von Werten aus benutzerdefinierten verwalteten Eigenschaften

In unserem Suchcenter-Szenario enthält der Standarddaraufzeigebereich beinah keine zusätzlichen Informationen über die Suchergebnisse.

Wir wollten die Werte aus den folgenden vier Sitespalten zum Daraufzeigebereich hinzufügen:

• GUID/UUID

• Internal Writer

• Status

• Submission Contact

Im folgenden Screenshot wird gezeigt, wie diese Werte für ein Element in unserer internen Liste verwaltet werden.

Beim Hinzufügen von benutzerdefinierten Eigenschaften zu einem Daraufzeigebereich müssen wir sie zur Elementanzeigevorlage (in der folgenden Abbildung hervorgehoben) hinzufügen.

Zur Erinnerung, da dies nicht wirklich intuitiv ist … Beim Hinzufügen von benutzerdefinierten Eigenschaften zu einem Daraufzeigebereich müssen wir sie zur Elementanzeigevorlage hinzufügen.

So zeigen Sie benutzerdefinierte Eigenschaften im Daraufzeigebereich an

1. Suchen Sie die Namen der verwalteten Eigenschaft der Sitespalten, die Sie verwenden möchten. Unter Von Werten von benutzerdefinierten verwalteten Eigenschaften in Suchergebnissen – Option 1 in SharePoint Server erfahren Sie, wie dies möglich ist.

2. Öffnen Sie die Elementanzeigevorlage, die den Verweis zur Daraufzeigebereichs-Anzeigevorlage enthält, die Sie anpassen möchten. Verwenden Sie in der Elementanzeigevorlage im Tag "ManagedPropertyMapping" die folgende Syntax, um die benutzerdefinierte verwaltete Eigenschaft hinzuzufügen, die Sie verwenden möchten:

   '<Current item property name>':<Managed property name>'
   

   In unserem Suchcenter-Szenario haben wir vier verwaltete Eigenschaften zur TechNet-Inhalts-Elementanzeigevorlagehinzugefügt.

   

3. Hinweis

   Dieser Schritt ist nicht erforderlich, wenn Sie SharePoint Online verwenden.

   Wechseln Sie zu Websiteeinstellungen --> Suchergebnistypen. Beachten Sie, dass die Warnung Eigenschaftensynchronisierung angezeigt wird.

   

   Diese Warnung wird angezeigt, da wir neue verwaltete Eigenschaften zu einer Elementanzeigevorlage hinzugefügt haben (das haben wir in Schritt 2 vorgenommen). Wählen Sie Update aus, um die Ergebnistypen mit den neu hinzugefügten verwalteten Eigenschaften zu aktualisieren.

   

   Wichtig

   Wenn Sie die Aktualisierung nicht vornehmen, werden die neu hinzugefügten verwalteten Eigenschaften nicht in Ihrem Daraufzeigebereich angezeigt.

4. Öffnen Sie die zu ändernde Daraufzeigebereichs-Anzeigevorlage, und verwenden Sie HTML, um die anzuzeigenden benutzerdefinierten Eigenschaften hinzuzufügen.

   In unserem Suchcenter-Szenario haben wir den TechNet_Content_HoverPanel geöffnet. Aus dem folgenden Screenshot geht hervor, wie wir unsere vier benutzerdefinierten Eigenschaften hinzugefügt haben.

   

5. Speichern Sie die Datei.

Durch das Ausführen einer neuen Suche und das Zeigen auf ein Suchergebnis konnten wir sehen, dass die vier benutzerdefinierten Eigenschaften nun angezeigt wurden. Sehr schön!

Aber wir sind noch nicht vollständig fertig damit. Die Werte für Internal Writer und Submission Contact wurden unterschiedlich angezeigt. Es mag zwar nicht eindeutig aus dem Screenshot hervorgehen, Sie können jedoch hoffentlich sehen, dass der Wert für Internal Writer richtig angezeigt wurde, der Wert für Submission Contact war jedoch sehr lang und enthielt eine ellenlange GUID.

Beide Werte stammen aus einer Sitespalte vom Typ Person oder Gruppe. Der Unterschied besteht darin, dass in den Sitespalteneinstellungen Internal Writer für die Anzeige von Name konfiguriert ist. Demgegenüber wurde Submission Contact konfiguriert, Name (with presence) anzuzeigen.

Damit Submission Contact richtig angezeigt wird, haben wir die Methode HP.GetAuthorsHtml kopiert, die durch die Item_CommonHoverPanel_Body-Anzeigevorlage zum Anzeigen der Verfasser verwendet wird.

Und nun sieht der Daraufzeigebereich richtig gut aus.

Damit der Daraufzeigebereich noch nützlicher wird, wollten wir unten im Daraufzeigenbereich eine Aktion hinzufügen. Wie dies funktioniert, zeigen wir Ihnen.

Zum nächsten Artikel in dieser Reihe

Gewusst wie: hinzufügen eine benutzerdefinierte Aktion zum daraufzeigebereich in SharePoint Server