Anpassen der Seitenlayouts für eine katalogbasierte Website in SharePoint

Hier erfahren Sie, wie Sie Layouts für Kategorieseiten und Katalogelementseiten für eine websiteübergreifende SharePoint-Veröffentlichungswebsite erstellen und anpassen können.

Voraussetzungen für die Erstellung und Anpassung von Seitenlayouts für eine katalogbasierte Website

Um die Schritte in diesem Beispiel ausführen zu können, benötigen Sie Folgendes:

  • Einen HTML-Editor

  • Eine websiteübergreifende SharePoint-Veröffentlichungsumgebung

Informationen zum Einrichten einer websiteübergreifenden SharePoint-Veröffentlichungsumgebung finden Sie unter Konfigurieren der websiteübergreifenden Veröffentlichung in SharePoint.

Kernkonzepte zur Erstellung und Anpassung von Seitenlayouts für eine katalogbasierte Website

In Tabelle 1 sind nützliche Artikel aufgeführt, die Ihnen die Konzepte und Arbeitsschritte zur Erstellung und Anpassung von Seitenlayouts für eine katalogbasierte Website näher bringen.

Tabelle 1. Kernkonzepte für die Erstellung und Anpassung von Seitenlayouts für eine katalogbasierte Website

Titel des Artikels Beschreibung
Übersicht über die websiteübergreifende Veröffentlichung in SharePoint
Erfahren Sie, wie Sie mit der websiteübergreifenden Veröffentlichung und Such-Webparts anpassungsfähige SharePoint-Websites für das Internet, Intranet und Extranet erstellen können.
Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint
Erfahren Sie, wie Sie Seitenlayouts in SharePoint Server erstellen können.
Vorgehensweise: Beheben von Fehlern und Warnungen bei der Vorschau einer Seite in SharePoint
Erfahren Sie, wie Sie Probleme beheben, die verhindern, dass die serverseitige Vorschau Ihre Seite rendert.
Codeausschnitte des SharePoint-Entwurfs-Managers
Erfahren Sie, wie Sie mit Codeausschnitten der HTML-Masterseite oder dem Seitenlayout SharePoint-Funktionen hinzufügen.

Einführung in Layouts für Kategorieseiten und Katalogelementseiten

Kategorieseiten und Katalogobjektseiten sind Seitenlayouts, die Sie zum konsistenten Anzeigen von strukturiertem Kataloginhalt auf einer Website verwenden können. SharePoint kann standardmäßig ein Kategorieseitenlayout und ein Katalogobjektseiten-Layout pro Katalogverbindung erstellen. Seiten, die auf diesen Layouts basieren, werden in der Seitenbibliothek einer Veröffentlichungswebsite erstellt, wenn Sie die Website mit einem Katalog verbinden. Weitere Informationen zu Seitenlayouts finden Sie unter Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint. Weitere Informationen zu Features, die für Kategorieseitenlayouts und Katalogelementseitenlayouts spezifisch sind, finden Sie unter Übersicht über die websiteübergreifende Veröffentlichung in SharePoint.

Standardmäßig werden Layouts für Kategorieseiten und Katalogelementseiten automatisch erstellt, wenn Sie eine Veröffentlichungswebsite mit einem Katalog verbinden. Sie können diese Layouts jedoch auch mit dem Entwurfs-Manager erstellen und sie bei der Verbindung der Veröffentlichungswebsite mit einem Katalog oder der Konfiguration eines Navigationsausdruckssatzes auf einer Veröffentlichungswebsite auswählen.

Erstellen eines Layouts für eine Kategorieseite

Vor dem Erstellen oder Anpassen eines Layouts für Kategorieseiten empfehlen wir Ihnen, ein zugeordnetes Netzlaufwerk zu erstellen, das auf den Gestaltungsvorlagenkatalog verweist. Weitere Informationen finden Sie unter Vorgehensweise: Zuordnen eines Netzlaufwerks zum SharePoint-Gestaltungsvorlagenkatalog.

Die einfachste Methode besteht darin, ein Layout für eine Kategorieseite automatisch bei der Verbindung einer Veröffentlichungswebsite mit einem Katalog von SharePoint erstellen zu lassen und anschließend das Markup des bestehenden Kategorieseitenlayouts an den Seitenentwurf anzupassen. Alternativ können Sie mit dem Entwurfs-Manager ein vollständig neues Layout erstellen.

So passen Sie ein automatisch von SharePoint erstelltes Layout für eine Kategorieseite an

  1. Öffnen Sie im Windows-Explorer das zugeordnete Netzlaufwerk, das auf den Gestaltungsvorlagenkatalog verweist.

  2. Bearbeiten Sie zum Anpassen eines Kategorieseitenlayouts die HTML-Datei, die sich direkt auf dem Server befindet, indem Sie einen HTML-Editor verwenden, um die HTML-Datei auf dem zugeordneten Laufwerk zu öffnen und zu bearbeiten. Nach jedem Speichervorgang werden die Änderungen mit der entsprechenden ASPX-Datei synchronisiert.

  3. Ersetzen Sie das Markup innerhalb des Inhaltsplatzhalters, der id="PlaceHolderMain" beinhaltet, durch das Markup, das Sie im Seitenlayout verwenden möchten.

    Wichtig: Der Markupcodeausschnitt für die Inhaltssuche muss erhalten bleiben, damit auf der Kategorieseite Suchergebnisse angezeigt werden können.

  4. Um den HTML-Code für alle Codeausschnitte zu konfigurieren und zu kopieren, die Sie der Seite hinzufügen möchten, führen Sie die Schritte 1 bis 11 im Abschnitt "Einfügen eines Ausschnitts aus dem Codeausschnittkatalog" der SharePoint-Entwurfs-Manager-Codeausschnitte aus.

  5. Nehmen Sie alle weiteren gewünschten Änderungen am Markup vor, und speichern Sie die Datei.

  6. Führen Sie die Schritte 9 bis 11 im Abschnitt "Erstellen eines Seitenlayouts" von Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint aus, um den Status der Datei zu überprüfen, eine Vorschau des Seitenlayouts anzuzeigen und fehler zu beheben.

So erstellen Sie ein Kategorieseitenlayout mit dem Entwurfs-Manager

  1. Führen Sie die Schritte 1 bis 6 im Abschnitt "Erstellen eines Seitenlayouts" von Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint aus.

  2. Wählen Sie bei Schritt 7 den Inhaltstyp Artikelseite.

  3. Wählen Sie OK aus.

    SharePoint erstellt jetzt eine HTML-Datei und eine ASPX-Datei mit dem gleichen Namen.

    Im Entwurfs-Manager wird die HTML-Datei nun mit der Spalte Status angezeigt, die einen der beiden folgenden Status hat:

  • Fehler

  • Konvertierung erfolgreich

  1. Öffnen Sie im Windows-Explorer das Netzlaufwerk, das auf den Gestaltungsvorlagenkatalog verweist.

  2. Um das Layout für die Kategorieseite anzupassen, bearbeiten Sie die HTML-Datei, die sich auf dem Server befindet, mit einem HTML-Editor. Nach jedem Speichervorgang werden die Änderungen mit der entsprechenden ASPX-Datei synchronisiert.

  3. Ersetzen Sie im Tag <head> den Inhaltsplatzhalter id="PlaceHolderPageTitle" durch:

  
<!--MS:<asp:ContentPlaceHolder id="PlaceHolderPageTitle" runat="server">-->
<!--CS: Start Taxonomy TermProperty Snippet-->
<!--SPM:<%@Register Tagprefix="Taxonomy"  Namespace="Microsoft.SharePoint.Taxonomy" Assembly="Microsoft.SharePoint.Taxonomy, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>-->
<!--MS:<Taxonomy:TermProperty Property="Name" runat="server">-->
<!--ME:</Taxonomy:TermProperty>-->
<!--ME:</asp:ContentPlaceHolder>-->
  1. Suchen Sie nach dem Inhaltsplatzhalter mit id="PlaceHolderPageTitleInTitleArea", und ersetzen Sie ihn durch:
  
<!--MS:<asp:ContentPlaceHolder id="PlaceHolderPageTitleInTitleArea" runat="server">-->
<!--SPM:<asp:SiteMapPath runat="server" ParentLevelsDisplayed="1" SiteMapProvider="CurrentNavigationSwitchableProvider"/>-->
<!--ME:</asp:ContentPlaceHolder>-->
  1. Ersetzen Sie das Markup innerhalb des Inhaltsplatzhalters, der id="PlaceHolderMain" beinhaltet, durch das Markup, das Sie im Seitenlayout verwenden möchten.

  2. Um den HTML-Code für den Inhaltssucheausschnitt und alle anderen Codeausschnitte zu konfigurieren und zu kopieren, die Sie der Seite hinzufügen möchten, führen Sie die Schritte 1 bis 11 im Abschnitt "Einfügen eines Ausschnitts aus dem Codeausschnittkatalog" der SharePoint-Entwurfs-Manager-Codeausschnitte aus.

    Hinweis

    Wenn Sie den Inhaltssuche-Codeausschnitt zum Seitenlayout hinzufügen, ändern Sie die Abfrage so, dass die Ergebnisquelle verwendet wird, die erstellt wurde, als Sie die Veröffentlichungswebsite mit einem Katalog verbunden haben. Weitere Informationen finden Sie unter Konfigurieren von Ergebnisquellen für die Webinhaltsverwaltung in SharePoint.

  3. Nehmen Sie alle weiteren gewünschten Änderungen am Markup vor, und speichern Sie die Datei.

  4. Führen Sie die Schritte 9 bis 11 im Abschnitt "Erstellen eines Seitenlayouts" von Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint aus, um den Status der Datei zu überprüfen, eine Vorschau des Seitenlayouts anzuzeigen und fehler zu beheben.

Grundlegendes zum Markup im HTML-Layout der Kategorieseite

Wenn Sie ein Seitenlayout erstellen, wird eine ASPX-Datei zur Verwendung durch SharePoint erstellt, und der HTML-Datei für das Seitenlayout wird HTML-Code hinzugefügt. Layouts für Kategorieseiten umfassen Markupkomponenten, die dem Seitenlayout basierend auf der Funktion zur websiteübergreifenden Veröffentlichung von Sammlungen hinzugefügt werden und die speziell für Kategorieseitenlayouts gelten. Möglicherweise fällt Ihnen die Bearbeitung des HTML-Kategorieseitenlayouts leichter, wenn Sie sich im Folgenden näher mit dem Markup vertraut machen.

Seitentitel im Browserfenster

Die Komponente im Inhaltsplatzhalter mit dem Attribut id="PlaceHolderPageTitle" enthält Markup, mit dem SharePoint angewiesen wird, eine Begriffseigenschaft als Seitentitel im Browserfenster zu verwenden, anstelle des Standardseiten-Feldwerts. Dieses Markup wird im folgenden Codebeispiel dargestellt.


<!--CS: Start Taxonomy TermProperty Snippet-->
<!--SPM:<%@Register Tagprefix="Taxonomy"  Namespace="Microsoft.SharePoint.Taxonomy" Assembly="Microsoft.SharePoint.Taxonomy, Version=15.0.0.0, Culture=neutral, 
PublicKeyToken=71e9bce111e9429c" %>-->
<!--MS:<Taxonomy:TermProperty Property="Name" runat="server">-->
<!--ME:</Taxonomy:TermProperty>-->

Seitentitel

Die Komponente im Inhaltsplatzhalter mit dem Attribut id="PlaceHolderPageTitleInTitleArea" enthält Markup, mit dem SharePoint angewiesen wird, eine Begriffseigenschaft als Seitentitel auf der Seite zu verwenden, anstelle des Codeausschnitts SPTitleBreadcrumb und des Standardseiten-Feldwerts. Dieses Markup wird im folgenden Codebeispiel dargestellt.


<!--SPM:<asp:SiteMapPath runat="server" ParentLevelsDisplayed="1" SiteMapProvider="CurrentNavigationSwitchableProvider"/>-->"

Inhaltssuche-Codeausschnitt

Die Komponenten, die nach dem Seiteninhaltsausschnitt innerhalb des Inhaltsplatzhalters mit id="PlaceHolderMain" angezeigt werden, enthalten Markup für einen Webpart-Zonenausschnitt, der vier Webpartzonen enthält. Die erste Webpartzone enthält einen Inhaltssuchausschnitt, der ein Inhaltssuche-Webpart auf der Seite anzeigt. Dieser Codeausschnitt enthält auch Informationen, mit denen das Inhaltssuche-Webpart eine Ergebnisquelle abfragen und die Ergebnisse auf der Seite anzeigen kann. Die letzten drei Webpartzonen sind leer. Möchten Sie ein benutzerdefiniertes Layout für Kategorieseiten erstellen, muss das Markup für den Inhaltssuche-Codeausschnitt in der HTML-Datei des Seitenlayouts eingefügt werden. Das folgende Codebeispiel zeigt das Markup für den Inhaltssuche-Codeausschnitt. Ersetzen Sie ResultSourceID durch die GUID der Ergebnisquelle und CatalogURL durch die URL des Katalogs.

Hinweis

Die GUIDS für ID und __WebPartId werden von SharePoint nach dem Zufallsprinzip generiert, wenn dem Seitenlayout Codeausschnitte hinzugefügt werden.

<!--
CS: Start Content Search Snippet-->
<!--SPM:<%@Register Tagprefix="a781102493" Namespace="Microsoft.Office.Server.Search.WebControls" Assembly="Microsoft.Office.Server.Search, Version=15.0.0.0, Culture=neutral, 
PublicKeyToken=71e9bce111e9429c"%>-->
<!--MS:<a781102493:ContentBySearchWebPart runat="server" DataProviderJSON="{&amp;#34;QueryTemplate&amp;#34;:&amp;#34;&amp;#34;,&amp;#34;SourceID&amp;#34;
:&amp;#34;ResultSourceID&amp;#34;,&amp;#34;PropertiesJson&amp;#34;:&amp;#34;
{'Tag':'{Term.IDWithChildren}','Scope':'CatalogURL'}&amp;#34;}" ResultsPerPage="3" RenderTemplateId="~sitecollection/_catalogs/masterpage/Display Templates/Content Web Parts/Control_ListWithPaging.js" 
ItemTemplateId="~sitecollection/_catalogs/masterpage/Display Templates/Content Web Parts/Item_PictureOnTop.js" SelectedPropertiesJson="[&amp;#34;WorkId&amp;#34;,&amp;#34;Rank&amp;#34;,&amp;#34;Title&amp;#34;,&amp;#34;Author&amp;#34;,&amp;#34;
Size&amp;#34;,&amp;#34;Path&amp;#34;,&amp;#34;Description&amp;#34;,&amp;#34;Write&amp;#34;,&amp;#34;CollapsingStatus&amp;#34;,&amp;#34;
HitHighlightedSummary&amp;#34;,&amp;#34;HitHighlightedProperties&amp;#34;,&amp;#34;ContentClass&amp;#34;,&amp;#34;
PictureThumbnailURL&amp;#34;,&amp;#34;ServerRedirectedURL&amp;#34;,&amp;#34;ServerRedirectedEmbedURL&amp;#34;,&amp;#34;
ServerRedirectedPreviewURL&amp;#34;,&amp;#34;FileExtension&amp;#34;,&amp;#34;ContentTypeId&amp;#34;,&amp;#34;ParentLink&amp;#34;,&amp;#34;
ViewsLifeTime&amp;#34;,&amp;#34;ViewsRecent&amp;#34;,&amp;#34;SectionNames&amp;#34;,&amp;#34;SectionIndexes&amp;#34;,&amp;#34;
SiteLogo&amp;#34;,&amp;#34;SiteDescription&amp;#34;,&amp;#34;deeplinks&amp;#34;,&amp;#34;importance&amp;#34;]" ShouldHideControlWhenEmpty="True" FrameType="None" SuppressWebPartChrome="False" Description="$Resources:Microsoft.Office.Server.Search,CBS_Description;" IsIncluded="True" 
ZoneID="" PartOrder="0" FrameState="Normal" AllowRemove="True" AllowZoneChange="True" 
AllowMinimize="True" AllowConnect="True" AllowEdit="True" AllowHide="True" IsVisible="True" 
DetailLink="" HelpLink="" HelpMode="Modeless" Dir="Default" PartImageSmall="" IsIncludedFilter="" ExportControlledProperties="True" ConnectionID="00000000-0000-0000-0000-000000000000" ID="g_54e35103_6f29_4dd9_b93b_8d4c863834af" ChromeType="None" ExportMode="All" __MarkupType="vsattributemarkup" __WebPartId="54e35103-6f29-4dd9-b93b-8d4c863834af" 
WebPart="true" Height="" Width="" Title="$Resources:cms,WebPartZoneTitle_Dynamic;">-->
<!--ME:</a781102493:ContentBySearchWebPart>-->
<!--CE: End Content Search Snippet-->

Erstellen eines Seitenlayouts für ein Katalogelement

Vor dem Erstellen oder Anpassen eines Layouts für Kategorieelemente empfehlen wir Ihnen, ein zugeordnetes Netzlaufwerk zu erstellen, das auf den Gestaltungsvorlagenkatalog verweist. Weitere Informationen finden Sie unter Vorgehensweise: Zuordnen eines Netzlaufwerks zum SharePoint-Gestaltungsvorlagenkatalog.

Wie beim Layout der Kategorieseite besteht die einfachste Möglichkeit zum Erstellen eines Katalogelementseitenlayouts darin, SharePoint das Seitenlayout automatisch erstellen zu lassen, wenn Sie die Veröffentlichungswebsite mit einem Katalog verbinden, und dann das vorhandene Layout der Katalogelementseite anpassen, um zusätzliches Markup hinzuzufügen, das für das Seitendesign erforderlich ist. Alternativ können Sie mit dem Entwurfs-Manager ein Layout der Katalogelementseite von Grund auf neu erstellen.

So bearbeiten Sie ein bestehendes Layout für ein Kategorieelement, das automatisch von SharePoint erstellt wurde

  1. Öffnen Sie im Windows-Explorer das Netzlaufwerk, das auf den Gestaltungsvorlagenkatalog verweist.

  2. Um das Layout für die Katalogelementseite anzupassen, bearbeiten Sie die HTML-Datei, die sich auf dem Server befindet, mit einem HTML-Editor. Nach jedem Speichervorgang werden die Änderungen mit der entsprechenden ASPX-Datei synchronisiert.

  3. Fügen Sie das Markup, das Sie im Seitenlayout verwenden möchten, im Inhaltsplatzhalter mit dem Attribut id="PlaceHolderMain" hinzu.

  4. Löschen Sie alle Codeausschnitte, die Sie nicht im Seitenlayout verwenden möchten, und verschieben Sie die verbleibenden Codeausschnitte an die Stellen, an denen die Werte der Eigenschaften angezeigt sollen.

    Achtung: Standardmäßig wird dem Seitenlayout ein Webpartzone-Codeausschnitt hinzugefügt, der einen Codeausschnitt zur Wiederverwendung von Katalogobjekten enthält. Dieser Codeausschnitt enthält den Datenanbieter, der Abfrageergebnisse zurückgibt, die von allen anderen Codeausschnitten auf der Seite verwendet werden. Es wird empfohlen, dass Sie den Codeausschnitt zur Wiederverwendung von Katalogobjekten in diesem standardmäßigen Webpartzone-Codeausschnitt belassen. (Sie können den Catalog-Item Codeausschnitt wiederverwenden außerhalb der Webpartzone verschieben und die angezeigte Eigenschaft ändern. Sie müssen jedoch die Catalog-Item Codeausschnitt wiederverwenden im Seitenlayout beibehalten.) Weitere Informationen finden Sie weiter unten in diesem Artikel unter Seitenfelder.

  5. Um den HTML-Codeausschnitt für alle Codeausschnitte zu konfigurieren und zu kopieren, die Sie auf der Seite verwenden möchten, führen Sie die Schritte 1 bis 11 im Abschnitt "Einfügen eines Ausschnitts aus dem Codeausschnittkatalog" der SharePoint-Entwurfs-Manager-Codeausschnitte aus.

  6. Nehmen Sie alle weiteren gewünschten Änderungen am Markup vor, und speichern Sie die Datei.

  7. Führen Sie die Schritte 9 bis 11 im Abschnitt "Erstellen eines Seitenlayouts" von Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint aus, um den Status der Datei zu überprüfen, eine Vorschau des Seitenlayouts anzuzeigen und fehler zu beheben.

So erstellen Sie mit dem Entwurfs-Manager ein Layout für eine Katalogelementseite

  1. Führen Sie die Schritte 1 bis 6 im Abschnitt "Erstellen eines Seitenlayouts" von Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint aus.

  2. Wählen Sie in Schritt 7 Remotekatalog, und wählen Sie dann den Katalog mit den Daten, die auf der Seite angezeigt werden sollen.

  3. Wählen Sie OK aus.

    SharePoint erstellt jetzt eine HTML-Datei und eine ASPX-Datei mit dem gleichen Namen.

    Im Entwurfs-Manager wird die HTML-Datei nun mit der Spalte Status angezeigt, die einen der beiden folgenden Status hat:

  • Fehler

  • Konvertierung erfolgreich

  1. Öffnen Sie im Windows-Explorer das Netzlaufwerk, das auf den Gestaltungsvorlagenkatalog verweist.

  2. Um das Layout für die Katalogelementseite anzupassen, bearbeiten Sie HTML-Datei, die sich auf dem Server befindet, mit einem HTML-Editor. Nach jedem Speichervorgang werden die Änderungen mit der entsprechenden ASPX-Datei synchronisiert.

  3. Fügen Sie das Markup, das Sie im Seitenlayout verwenden möchten, im Inhaltsplatzhalter mit dem Attribut id="PlaceHolderMain" hinzu.

  4. Löschen Sie alle Codeausschnitte, die Sie nicht im Seitenlayout verwenden möchten, und verschieben Sie die verbleibenden Codeausschnitte an die Stellen, an denen die Werte der Eigenschaften angezeigt sollen.

    Achtung: Standardmäßig wird dem Seitenlayout ein Webpartzone-Codeausschnitt hinzugefügt, der einen Codeausschnitt zur Wiederverwendung von Katalogobjekten enthält. Dieser Codeausschnitt enthält den Datenanbieter, der Abfrageergebnisse zurückgibt, die von allen anderen Codeausschnitten auf der Seite verwendet werden. Es wird empfohlen, dass Sie den Codeausschnitt zur Wiederverwendung von Katalogobjekten in diesem standardmäßigen Webpartzone-Codeausschnitt belassen. (Sie können den Catalog-Item Codeausschnitt wiederverwenden außerhalb der Webpartzone verschieben und die angezeigte Eigenschaft ändern. Sie müssen jedoch die Catalog-Item Codeausschnitt wiederverwenden im Seitenlayout beibehalten.) Weitere Informationen finden Sie weiter unten in diesem Artikel unter Seitenfelder.

  5. Um den HTML-Codeausschnitt für alle Codeausschnitte zu konfigurieren und zu kopieren, die Sie auf der Seite verwenden möchten, führen Sie die Schritte 1 bis 11 im Abschnitt "Einfügen eines Ausschnitts aus dem Codeausschnittkatalog" der SharePoint-Entwurfs-Manager-Codeausschnitte aus.

  6. Nehmen Sie alle weiteren gewünschten Änderungen am Markup vor, und speichern Sie die Datei.

  7. Führen Sie die Schritte 9 bis 11 im Abschnitt "Erstellen eines Seitenlayouts" von Vorgehensweise: Erstellen eines Seitenlayouts in SharePoint aus, um den Status der Datei zu überprüfen, eine Vorschau des Seitenlayouts anzuzeigen und fehler zu beheben.

Grundlegendes zum Markup im HTML-Layout für Katalogelementseiten

Wenn Sie ein Seitenlayout erstellen, wird eine ASPX-Datei zur Verwendung durch SharePoint erstellt, und der HTML-Datei für das Seitenlayout wird HTML-Code hinzugefügt. Layouts für Katalogelementseiten umfassen Markupkomponenten, die dem Seitenlayout basierend auf der Funktion zur websiteübergreifenden Veröffentlichung von Sammlungen hinzugefügt werden und die speziell für Katalogelement-Seitenlayouts gelten. Möglicherweise fällt Ihnen die Bearbeitung des HTML-Katalogelement-Seitenlayouts leichter, wenn Sie sich im Folgenden näher mit dem Markup vertraut machen.

Seitentitel im Browserfenster

Die Komponente im Inhaltsplatzhalter mit dem Attribut id="PlaceHolderPageTitle" enthält einen Codeausschnitt zur Wiederverwendung von Katalogelementen, mit dem SharePoint angewiesen wird, den Namen des Katalogelements als Seitentitel im Browserfenster zu verwenden, anstelle des Standardseiten-Feldwerts. Dieses Markup wird im folgenden Codebeispiel dargestellt.

Hinweis

Die GUIDS für ID und __WebPartId werden von SharePoint nach dem Zufallsprinzip generiert, wenn dem Seitenlayout Codeausschnitte hinzugefügt werden.


<!--CS: [Title] Start Catalog-Item Reuse Snippet-->
<!--SPM:<cc1:CatalogItemReuseWebPart runat="server" UseServerSideRenderFormat="True" ResultType="" NumberOfItems="1" UseSharedDataProvider="True" OverwriteResultPath="False" ResultsPerPage="1"  SelectedPropertiesJson="[&amp;#34;Title&amp;#34;]" 
Title="$Resources:Microsoft.Office.Server.Search,CBSItem_Title;" Description="$Resources:Microsoft.Office.Server.Search,CBSItem_Description;" 
MissingAssembly="Cannot import this web part." ID="g_863912c1_c849_46dc_8781_2920ee2bc83f" __WebPartId="{863912c1-c849-46dc-8781-2920ee2bc83f}">-->
<!--SPM:<RenderFormat>-->
<!--DC:Renders value from search without any additional formatting.-->
<!--SPM:</RenderFormat>-->
<!--SPM:</cc1:CatalogItemReuseWebPart>-->
<!--CE:End Catalog-Item Reuse Snippet-->

Seitenfelder

Die Komponenten im Inhaltsplatzhalter mit dem Attribut id="PlaceHolderMain" enthalten Codeausschnitte für die Felder Title, Page Content und Catalog-Item URL. Sie können diese Codeausschnitte auf Wunsch aus dem Seitenlayout löschen. Das folgende Codebeispiel zeigt das Markup für diese Seitenfelder.


<div>
    <!--CS: Start Page Field: Title Snippet-->
    <!--SPM:<%@Register Tagprefix="PageFieldTextField" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, 
Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <!--SPM:<%@Register Tagprefix="Publishing" Namespace="Microsoft.SharePoint.Publishing.WebControls" Assembly="Microsoft.SharePoint.Publishing, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <!--MS:<Publishing:EditModePanel runat="server" CssClass="edit-mode-panel">-->
        <!--MS:<PageFieldTextField:TextField FieldName="fa564e0f-0c70-4ab9-b863-0177e6ddd247" 
runat="server">-->
        <!--ME:</PageFieldTextField:TextField>-->
    <!--ME:</Publishing:EditModePanel>-->
    <!--CE: End Page Field: Title Snippet-->
</div>
<div>
    <!--CS: Start Page Field: Page Content Snippet-->
    <!--SPM:<%@Register Tagprefix="PageFieldRichHtmlField" Namespace="Microsoft.SharePoint.Publishing.WebControls" Assembly="Microsoft.SharePoint.Publishing, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <!--MS:<PageFieldRichHtmlField:RichHtmlField FieldName="f55c4d88-1f2e-4ad9-aaa8-819af4ee7ee8" runat="server">-->
        <!--PS: Start of READ-ONLY PREVIEW (do not modify)-->
            <div id="ctl02_label" style="display:none">Page Content</div>
            <div id="ctl02__ControlWrapper_RichHtmlField" class="ms-rtestate-field" style="display:inline" aria-labelledby="ctl02_label">
                <div align="left" class="ms-formfieldcontainer">
                    <div class="ms-formfieldlabelcontainer" nowrap="nowrap">
                        <span class="ms-formfieldlabel" nowrap="nowrap">Page Content</span>
                    </div>
                    <div class="ms-formfieldvaluecontainer">
                        <div class="ms-rtestate-field">Page Content field value. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</div>
                    </div>
                </div>
            </div>
        <!--PE: End of READ-ONLY PREVIEW-->
    <!--ME:</PageFieldRichHtmlField:RichHtmlField>-->
    <!--CE: End Page Field: Page Content Snippet-->
</div>
<div>
    <!--CS: Start Page Field: Catalog-Item URL Snippet-->
    <!--SPM:<%@Register Tagprefix="PageFieldCatalogSourceFieldControl" Namespace="Microsoft.SharePoint.Publishing.WebControls" Assembly="Microsoft.SharePoint.Publishing, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <!--MS:<PageFieldCatalogSourceFieldControl:CatalogSourceFieldControl FieldName="75772bbf-0c25-4710-b52c-7b78344ad136" runat="server">-->
    <!--PS: Start of READ-ONLY PREVIEW (do not modify)-->
        <div align="left" class="ms-formfieldcontainer">
            <div class="ms-formfieldlabelcontainer" nowrap="nowrap">
                <span class="ms-formfieldlabel" nowrap="nowrap">Catalog-Item URL</span>
            </div>
            <div class="ms-formfieldvaluecontainer">
                <a href="http://www.example.com">Link to sample web site.</a>
            </div>
        </div>
    <!--PE: End of READ-ONLY PREVIEW-->
    <!--ME:</PageFieldCatalogSourceFieldControl:CatalogSourceFieldControl>-->
    <!--CE: End Page Field: Catalog-Item URL Snippet-->
</div>

Wenn das Seitenlayout des Katalogelements automatisch erstellt wurde, als die Veröffentlichungswebsite mit einem Katalog verbunden war, oder durch Auswählen eines Remotekatalogs während der Seitenlayouterstellung erstellt wurde, enthält das Seitenlayout auch einen Webpart-Zonenausschnitt, der einen Catalog-Item Wiederverwendungsausschnitt enthält, der einen Datenanbieter für die Seite registriert. Der Codeausschnitt zur Wiederverwendung von Katalogelementen enthält die Eigenschaft UseSharedDataProvider, deren Wert auf False gesetzt ist. Der Webpartzonenausschnitt kann aus dem Seitenlayout gelöscht werden. Damit die Seite weiterhin Katalogelemente anzeigen kann, muss der Codeausschnitt zur Wiederverwendung von Katalogelementen allerdings im Seitenlayout verbleiben. Wenn Sie eine Seite erstellen, die dieses Seitenlayout verwendet, können Sie das Webpart so konfigurieren, dass es ausgeblendet wird, wenn ein Benutzer die Seite anzeigt.

Wichtig: Wenn Sie ein neues Katalogelement-Seitenlayout erstellen und einen Inhaltstyp anstelle eines Remotekatalogs auswählen, müssen Sie einen Codeausschnitt zur Wiederverwendung von Katalogobjekten in das Seitenlayout einschließen. Der folgende Code zeigt das Markup für den Codeausschnitt zur Wiederverwendung von Katalogobjekten, wie er innerhalb des Webpartzone-Codeausschnitts angezeigt wird. Ersetzen Sie ManagedPropertyName durch den Namen der anzuzeigenden verwalteten Eigenschaft, ersetzen Sie ResultSourceID durch die GUID der Ergebnisquelle und CatalogURL durch die URL des Katalogs.


<div>
    <!--CS: Start web part Zone Snippet-->
    <!--SPM:<%@Register Tagprefix="WebPartPages" Namespace="Microsoft.SharePoint.WebPartPages" Assembly="Microsoft.SharePoint, 
Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <!--SPM:<%@Register Tagprefix="cc1"  Namespace="Microsoft.Office.Server.Search.WebControls" Assembly="Microsoft.Office.Server.Search, Version=15.0.0.0, Culture=neutral, 
PublicKeyToken=71e9bce111e9429c" %>-->
    <!--MS:<WebPartPages:WebPartZone runat="server" Title="&amp;#60;%$Resources:cms,WebPartZoneTitle_Body%&amp;#62;" AllowPersonalization="False" FrameType="TitleBarOnly" ID="Body" Orientation="Vertical">-->
        <!--MS:<ZoneTemplate>-->
            <!--CS: [ManagedPropertyName] Start Catalog-Item Reuse Snippet-->
            <!--DC:To render the search property using a rendering template, change the "UseServerSideRenderFormat" property to "False".-->
            <!--SPM:<cc1:CatalogItemReuseWebPart runat="server" UseServerSideRenderFormat="True" 
ResultType="" NumberOfItems="1" AddSEOPropertiesFromSearch="True" LogAnalyticsViewEvent="True" UseSharedDataProvider="False" OverwriteResultPath="False" DataProviderJSON="{&amp;#34;QueryTemplate&amp;#34;:&amp;#34;ListItemID:{URLTOKEN.1}&amp;#34;,&amp;#34;SourceID&amp;#34;:&amp;#34; ResultSourceID&amp;#34;,&amp;#34;PropertiesJson&amp;#34;:&amp;#34;{&amp;#39;Scope&amp;#39;:&amp;#39;  CatalogURL&amp;#39;,&amp;#39;Tag&amp;#39;:&amp;#39;{Term}&amp;#39;}&amp;#34;}" ResultsPerPage="1"  SelectedPropertiesJson="[&amp;#34;ManagedPropertyName&amp;#34;]" Title="$Resources:Microsoft.Office.Server.Search,CBSItem_Title;" Description="$Resources:Microsoft.Office.Server.Search,CBSItem_Description;" MissingAssembly="Cannot import this web part." ID="g_d63eebe7_207f_4e8c_9566_7381acc80cc7" __WebPartId="{d63eebe7-207f-4e8c-9566-7381acc80cc7}">-->
            <!--SPM:<RenderFormat>-->
            <!--DC:Renders value from search without any additional formatting.-->
            <!--SPM:</RenderFormat>-->
            <!--SPM:</cc1:CatalogItemReuseWebPart>-->
        <!--ME:</ZoneTemplate>-->
    <!--ME:</WebPartPages:WebPartZone>-->
    <!--CE:End Catalog-Item Reuse Snippet-->
</div>

Wenn das Katalogelement-Seitenlayout automatisch bei der Verbindung der Veröffentlichungswebsite mit dem Katalog erstellt wurde oder indem ein Remotekatalog bei der Erstellung des Seitenlayouts ausgewählt wurde, enthält die restliche Seite Codeausschnitte zur Wiederverwendung von Katalogelementen, die den verwalteten Eigenschaften des Katalogs auf der Erstellungsseite entsprechen. Über diese verwalteten Eigenschaften werden die Details zu einem bestimmten Katalogelement unter Verwendung des Seitenlayouts für Katalogelemente angezeigt. Diese Catalog-Item Codeausschnitte wiederverwenden werden außerhalb der Webpartzone angezeigt und direkt auf der Seite gerendert, wenn ein Element auf einer Kategorieseite ausgewählt wird. In Tabelle 2 sind die verwalteten Eigenschaften aufgeführt, die automatisch im Katalogelement-Seitenlayout enthalten sind.

Hinweis

Einige verwaltete Eigenschaften sind nur enthalten, wenn der Katalog eine Bibliothek für Seiten ist. In Tabelle 2 wird in der Spalte Verwendet von angegeben, welche verwalteten Eigenschaften von Bibliotheken für Seiten und von Listen verwendet werden und welche ausschließlich von Bibliotheken für Seiten.

Tabelle 2. Standardmäßige verwaltete Eigenschaften für Codeausschnitte zur Wiederverwendung von Katalogelementen

Verwaltete Eigenschaft Beschreibung Verwendet von
AuthorOWSUSER
Der Name des Benutzers, der die Seite erstellt hat.
Nur Bibliothek für Seiten
CreatedOWSDATE
Das Datum, an dem die Seite oder das Listenelement erstellt wurde.
Bibliothek für Seiten und Liste
EditorOWSUSER
Der Name des Benutzers, der die Seite oder das Listenelement zuletzt geändert hat.
Bibliothek für Seiten und Liste
ListItemID
Die ID der Seite oder des Listenelements.
Bibliothek für Seiten und Liste
ModifiedOWSDATE
Das Datum, an dem die Seite oder das Listenelement zuletzt geändert wurde.
Bibliothek für Seiten und Liste
PublishingContactOWSUSER
„Kontakt" ist eine Websitespalte, die von der Veröffentlichungsfunktion erstellt wird. Sie wird für den Seiteninhaltstyp als Kontaktperson oder -organisation für die Website verwendet.
Nur Bibliothek für Seiten
PublishingIsFurlPageOWSBOOL
Ein boolescher Wert, der angibt, ob der Seite eine benutzerfreundliche URL zugeordnet ist.
Nur Bibliothek für Seiten
PublishingPageContentOWSHTML
Der HTML-Inhalt der Seite.
Nur Bibliothek für Seiten
PublishingPageLayoutOWSURLH
Die URL zum Seitenlayout, das zum Erstellen der Seite verwendet wurde.
Nur Bibliothek für Seiten
Title
Der Titel der Seite oder des Listenelements.
Bibliothek für Seiten und Liste

Die verwalteten Eigenschaften für benutzerdefinierte Spalten, die Sie der Bibliothek für Seiten oder der Liste hinzufügen, werden ebenfalls in Codeausschnitte zur Wiederverwendung von Katalogelementen eingeschlossen. Der Name der verwalteten Eigenschaft variiert je nach dem Typ der Website, die Sie beim Erstellen der Websitespalte verwenden. Weitere Informationen finden Sie unter Automatisch erstellte verwaltete Eigenschaften in SharePoint und Übersicht über das Suchschema in SharePoint.

Wichtig: Die Websitespalte Seitenbild Websitespalte in einer Bibliothek für Seiten wird der verwalteten Eigenschaft PublishingImage zugeordnet. Die verwaltete Eigenschaft PublishingImage wird aber nicht automatisch in das Kategorieelement-Seitenlayout eingeschlossen. Um das Bild in das Seitenlayout einzuschließen, müssen Sie einen Codeausschnitt zur Wiederverwendung von Katalogelementen für die verwaltete Eigenschaft PublishingImage hinzufügen. Verwenden Sie den folgenden HTML-Code, um einen Codeausschnitte zur Wiederverwendung von Katalogelementen hinzuzufügen, um den Wert der verwalteten Eigenschaft PublishingImage im Seitenlayout anzuzeigen. Ersetzen Sie UniqueID mit einer GUID, die für jede Instanz des Codeausschnitts eindeutig ist.


<div>
<!--CS: [PublishingImage] Start Catalog-Item Reuse Snippet-->
<!--SPM:<cc1:CatalogItemReuseWebPart runat="server" UseServerSideRenderFormat="True" 
ResultType="" NumberOfItems="1" UseSharedDataProvider="True" OverwriteResultPath="False" 
ResultsPerPage="1"  SelectedPropertiesJson="[&amp;#34;PublishingImage&amp;#34;]" 
Title="$Resources:Microsoft.Office.Server.Search,CBSItem_Title;" 
Description="$Resources:Microsoft.Office.Server.Search,CBSItem_Description;" 
MissingAssembly="Cannot import this web part." ID="g_UniqueID" __WebPartId="{UniqueID}">-->
<!--SPM:<RenderFormat>-->
<!--SPM:<Format Type="HTML"> -->
<!--SPM:<Picture>-->True<!--SPM:</Picture>-->
<!--SPM:</Format> -->
<!--SPM:</RenderFormat>-->
<!--SPM:</cc1:CatalogItemReuseWebPart>-->
<!--CE:End Catalog-Item Reuse Snippet-->
</div>

Wenn Sie mit dem Entwurfs-Manager ein neues Katalogelement-Seitenlayout erstellen und einen Inhaltstyp anstellen eines Remotekatalogs auswählen, können Sie Codeausschnitte zur Wiederverwendung von Katalogelementen im Codeausschnittkatalog auswählen. Das folgende Codebeispiel zeigt das Markup der Codeausschnitte zur Wiederverwendung von Katalogelementen für die verwalteten Eigenschaften Title, PublishingPageContentOWSHTML, CreatedOWSDATE und owstaxIdPageCategory.

Hinweis

Die GUIDS für ID und __WebPartId werden von SharePoint nach dem Zufallsprinzip generiert, wenn dem Seitenlayout Codeausschnitte hinzugefügt werden.


<div>
    <!--CS: [Title] Start Catalog-Item Reuse Snippet-->
    <!--SPM:<cc1:CatalogItemReuseWebPart runat="server" UseServerSideRenderFormat="True" 
ResultType="" NumberOfItems="1" UseSharedDataProvider="True" OverwriteResultPath="False" 
ResultsPerPage="1"  SelectedPropertiesJson="[&amp;#34;Title&amp;#34;]" 
Title="$Resources:Microsoft.Office.Server.Search,CBSItem_Title;" 
Description="$Resources:Microsoft.Office.Server.Search,CBSItem_Description;" 
MissingAssembly="Cannot import this web part." ID="g_0dc23bb8_8d34_4f9f_8085_5a6ac286cb9e" 
__WebPartId="{0dc23bb8-8d34-4f9f-8085-5a6ac286cb9e}">-->
    <!--SPM:<RenderFormat>-->
    <!--DC:Renders value from search without any additional formatting.-->
    <!--SPM:</RenderFormat>-->
    <!--SPM:</cc1:CatalogItemReuseWebPart>-->
    <!--CE:End Catalog-Item Reuse Snippet-->
</div>
<div>
    <!--CS: [PublishingPageContentOWSHTML] Start Catalog-Item Reuse Snippet-->
    <!--SPM:<cc1:CatalogItemReuseWebPart runat="server" UseServerSideRenderFormat="True" 
ResultType="" NumberOfItems="1" UseSharedDataProvider="True" OverwriteResultPath="False" 
ResultsPerPage="1"  SelectedPropertiesJson="[&amp;#34;PublishingPageContentOWSHTML&amp;#34;]" 
Title="$Resources:Microsoft.Office.Server.Search,CBSItem_Title;" 
Description="$Resources:Microsoft.Office.Server.Search,CBSItem_Description;" 
MissingAssembly="Cannot import this web part." ID="g_25253a49_a9a6_4277_bf9d_416961024cee" 
__WebPartId="{25253a49-a9a6-4277-bf9d-416961024cee}">-->
    <!--SPM:<RenderFormat>-->
    <!--DC:Renders value from search without any additional formatting.-->
    <!--SPM:</RenderFormat>-->
    <!--SPM:</cc1:CatalogItemReuseWebPart>-->
    <!--CE:End Catalog-Item Reuse Snippet-->
</div>
<div>
    <!--CS: [CreatedOWSDATE] Start Catalog-Item Reuse Snippet-->
    <!--SPM:<cc1:CatalogItemReuseWebPart runat="server" UseServerSideRenderFormat="True" 
ResultType="" NumberOfItems="1" UseSharedDataProvider="True" OverwriteResultPath="False" 
ResultsPerPage="1"  SelectedPropertiesJson="[&amp;#34;CreatedOWSDATE&amp;#34;]" 
Title="$Resources:Microsoft.Office.Server.Search,CBSItem_Title;" 
Description="$Resources:Microsoft.Office.Server.Search,CBSItem_Description;" 
MissingAssembly="Cannot import this web part." 
ID="g_4e1f180b_12f8_4e50_84d7_c72b0ee3793f" 
__WebPartId="{4e1f180b-12f8-4e50-84d7-c72b0ee3793f}">-->
    <!--SPM:<RenderFormat>-->
    <!--SPM:<Format Type="DateTime"> -->
    <!--DC:To render Date and Time, change this value to False.-->
    <!--SPM:<DateOnly>-->True<!--SPM:</DateOnly>-->
    <!--SPM:</Format> -->
    <!--SPM:</RenderFormat>-->
    <!--SPM:</cc1:CatalogItemReuseWebPart>-->
    <!--CE:End Catalog-Item Reuse Snippet-->
</div>
<div>
    <!--CS: [owstaxIdPageCategory] Start Catalog-Item Reuse Snippet-->
    <!--SPM:<cc1:CatalogItemReuseWebPart runat="server" UseServerSideRenderFormat="True" 
ResultType="" NumberOfItems="1" UseSharedDataProvider="True" OverwriteResultPath="False" 
ResultsPerPage="1"  SelectedPropertiesJson="[&amp;#34;owstaxIdPageCategory&amp;#34;]" 
Title="$Resources:Microsoft.Office.Server.Search,CBSItem_Title;" 
Description="$Resources:Microsoft.Office.Server.Search,CBSItem_Description;" 
MissingAssembly="Cannot import this web part." ID="g_22e39e9d_1b25_42c7_bf2a_7ebca37616d4" 
__WebPartId="{22e39e9d-1b25-42c7-bf2a-7ebca37616d4}">-->
    <!--SPM:<RenderFormat>-->
    <!--DC:Renders value from search without any additional formatting.-->
    <!--SPM:</RenderFormat>-->
    <!--SPM:</cc1:CatalogItemReuseWebPart>-->
    <!--CE:End Catalog-Item Reuse Snippet-->
</div>

Siehe auch