Procédure : Personnaliser des mises en page pour un site de catalogue dans SharePoint

Article
03/21/2023

Découvrez comment créer et personnaliser des mises en page de catégorie et d’élément de catalogue pour un site SharePoint de publication intersites.

Conditions préalables à la création et la personnalisation de mises en page pour un site de catalogue

Pour suivre les étapes décrites dans cet exemple, vous devez disposer des éléments suivants :

un éditeur HTML ;
un environnement de publication intersites SharePoint.

Pour plus d’informations sur la configuration d’un environnement de publication intersites SharePoint, voir Configurer la publication intersites dans SharePoint.

Concepts fondamentaux pour la création et la personnalisation de mises en page pour un site de catalogue

Le tableau 1 répertorie des articles utiles qui peuvent vous aider à comprendre les concepts et les étapes nécessaires à la création et la personnalisation de mises en page pour un site de catalogue.

Tableau 1. Concepts fondamentaux pour la création et la personnalisation de mises en page pour un site de catalogue

Titre d’article	Description
Vue d’ensemble de la publication intersite dans SharePoint	Découvrez comment utiliser la publication intersites et les composants WebPart de recherche pour créer des sites Internet, intranet et extranet SharePoint adaptatifs.
Procédure : Créer une mise en page dans SharePoint	Découvrez comment créer des mises en page dans SharePoint.
Procédure : Résoudre les erreurs et avertissements lors de l’aperçu d’une page dans SharePoint	Découvrez comment résoudre les problèmes qui empêchent l’aperçu côté serveur de rendre votre page.
Extraits de code du Gestionnaire de conception SharePoint	Découvrez comment utiliser des extraits de code pour ajouter des fonctionnalités SharePoint à votre page maître HTML ou mise en page.

Introduction aux mises en page de catégorie et d’élément de catalogue

Les pages de catégorie et les pages d’élément de catalogue sont des mises en page que vous pouvez utiliser pour afficher un contenu de catalogue structuré de manière cohérente dans le site. Par défaut, SharePoint peut créer automatiquement une mise en page de catégorie et une mise en page d’élément de catalogue par connexion de catalogue. Les pages basées sur ces mises en page sont créées dans la bibliothèque de pages d’un site de publication lorsque vous connectez le site à un catalogue. Pour plus d’informations sur les mises en page, voir Guide pratique pour créer une mise en page dans SharePoint. Pour plus d’informations sur les fonctionnalités propres aux mises en page de catégorie et aux mises en page d’éléments de catalogue, voir Vue d’ensemble de la publication intersites dans SharePoint.

Par défaut, les mises en page de catégorie et d'élément de catalogue sont créées automatiquement lorsque vous connectez un site de publication à un catalogue. Vous pouvez également utiliser le gestionnaire de conception pour créer des mises en page de catégorie et d’élément de catalogue que vous pouvez sélectionner lorsque vous connectez un site de publication à un catalogue, ou lorsque vous configurez le terme de navigation défini sur un site de publication.

Création d’une mise en page de catégorie

Avant de créer ou personnaliser une mise en page de catégorie, nous vous recommandons de créer un lecteur réseau mappé qui pointe vers la galerie de pages maîtres. Pour plus d’informations, voir Guide pratique pour mapper un lecteur réseau à la galerie de pages maîtres SharePoint.

Le moyen le plus simple pour créer une mise en page de catégorie consiste à laisser SharePoint créer la mise en page automatiquement lorsque vous connectez le site de publication à un catalogue, pour ensuite personnaliser la mise en page de catégorie existante afin de modifier le balisage comme indiqué dans la conception de page. Vous pouvez également créer une mise en page de catégorie en partant de zéro à l’aide du gestionnaire de conception.

Personnalisation d’une mise en page de catégorie existante qui a été créée automatiquement par SharePoint

À l’aide de l’Explorateur Windows, ouvrez le lecteur réseau mappé à la galerie de pages maîtres.
Pour personnaliser une mise en page de catégorie, modifiez le fichier HTML qui réside directement sur le serveur à l'aide d'un éditeur HTML afin d'ouvrir et de modifier le fichier HTML dans le lecteur mappé. Chaque fois que vous enregistrez le fichier HTML, toutes les modifications sont synchronisées sur le fichier .aspx associé.
Remplacez le balisage à l’intérieur de l’espace réservé de contenu comportant l’élément id="PlaceHolderMain" par le balisage que vous souhaitez utiliser dans la mise en page.

Important : vous devez conserver le balisage de l’extrait de code de recherche de contenu afin que la page de catégorie puisse afficher les résultats de la recherche.
Pour configurer et copier le code HTML des extraits de code que vous souhaitez ajouter à la page, suivez les étapes 1 à 11 de la section « Insérer un extrait de code à partir de la galerie d’extraits de code » des extraits de code du Gestionnaire de conception SharePoint.
Apportez toute autre modification requise au balisage, puis enregistrez le fichier.
Suivez les étapes 9 à 11 de la section « Créer une mise en page » de Comment : créer une mise en page dans SharePoint pour vérifier l’état du fichier, afficher un aperçu de la mise en page et corriger les erreurs éventuelles.

Création d’une mise en page de catégorie à l’aide du gestionnaire de conception

Suivez les étapes 1 à 6 de la section « Créer une mise en page » de Guide pratique pour créer une mise en page dans SharePoint.
À l'étape 7, choisissez le type de contenu Page d'article.
Sélectionnez OK.

À ce stade, SharePoint crée un fichier HTML et un fichier .aspx portant le même nom.

Dans le gestionnaire de conception, votre fichier HTML apparaît désormais avec une colonne Statut indiquant l'un des deux statuts possibles :

Erreurs
La conversion a réussi

À l'aide de l'Explorateur Windows, ouvrez le lecteur réseau mappé à la galerie de pages maîtres.
Pour personnaliser la mise en page de catégorie, modifiez le fichier HTML qui réside directement sur le serveur à l'aide d'un éditeur HTML afin d'ouvrir et de modifier le fichier HTML dans le lecteur mappé. Chaque fois que vous enregistrez le fichier HTML, toutes les modifications sont synchronisées sur le fichier .aspx associé.
Dans la balise <head>, remplacez l’espace réservé de contenu comportant l’élément id="PlaceHolderPageTitle" par :

  
<!--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>-->

Recherchez l’espace réservé de contenu comportant l’élément id="PlaceHolderPageTitleInTitleArea" et remplacez-le par :

  
<!--MS:<asp:ContentPlaceHolder id="PlaceHolderPageTitleInTitleArea" runat="server">-->
<!--SPM:<asp:SiteMapPath runat="server" ParentLevelsDisplayed="1" SiteMapProvider="CurrentNavigationSwitchableProvider"/>-->
<!--ME:</asp:ContentPlaceHolder>-->

Remplacez le balisage à l'intérieur de l'espace réservé de contenu comportant l'élément id="PlaceHolderMain" par le balisage que vous souhaitez utiliser dans la mise en page.
Pour configurer et copier le code HTML de l’extrait de code de recherche de contenu et tous les autres extraits de code que vous souhaitez ajouter à la page, suivez les étapes 1 à 11 de la section « Insérer un extrait de code à partir de la galerie d’extraits de code » des extraits de code du Gestionnaire de conception SharePoint.

Remarque

Quand vous ajoutez l’extrait de code de recherche de contenu à la mise en page, pensez à modifier la requête pour utiliser l’origine des résultats créée quand vous avez connecté le site de publication à un catalogue. Pour plus d’informations, voir Configurer des sources de résultats pour la gestion de contenu web dans SharePoint.
Apportez toute autre modification requise au balisage, puis enregistrez le fichier.
Suivez les étapes 9 à 11 de la section « Créer une mise en page » de Comment : créer une mise en page dans SharePoint pour vérifier l’état du fichier, afficher un aperçu de la mise en page et corriger les erreurs éventuelles.

Présentation du balisage dans la mise en page de catégorie HTML

Lorsque vous créez une mise en page, un fichier .aspx que SharePoint utilise est créé, et un balisage HTML est ajouté à la version HTML de la mise en page. Les mises en page de catégorie disposent de composants de balisage qui sont ajoutés à la mise en page selon la fonctionnalité de publication de collections intersites, et qui sont propres aux mises en page de catégorie. Lorsque vous modifiez la mise en page de catégorie HTML dans votre éditeur HTML, il peut être utile de comprendre une partie de ce balisage.

Titre de la page de la fenêtre du navigateur

Le composant qui apparaît à l'intérieur de l'espace réservé de contenu avec l'élément id="PlaceHolderPageTitle" comporte un balisage qui indique à SharePoint d'utiliser une propriété de terme comme titre de page dans la fenêtre du navigateur, plutôt que la valeur du champ de page standard. Le code suivant affiche le balisage pour le titre de la page de la fenêtre du navigateur.


<!--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>-->

Titre de la page

Le composant qui apparaît à l'intérieur de l'espace réservé de contenu avec l'élément id="PlaceHolderPageTitleInTitleArea" comporte un balisage qui indique à SharePoint d'utiliser une propriété de terme comme titre de page sur la page, plutôt que l'extrait de code SPTitleBreadcrumb et la valeur de champ de titre de page standard. Le code suivant affiche le balisage du titre de la page.


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

Extrait de code de recherche de contenu

Les composants qui s’affichent après l’extrait de code de contenu de la page, au sein de l’espace réservé de contenu avec id ="PlaceHolderMain", contiennent des marques de révision pour un extrait de code de zone de composants WebPart contenant quatre zones de composants WebPart. La première zone de composants WebPart contient un extrait de code de recherche de contenu qui affiche sur la page un composant WebPart de recherche de contenu. Cet extrait contient également des informations qui aident le composant WebPart de recherche de contenu à demander l’origine des résultats et à afficher les résultats sur la page. Les trois dernières zones de composants WebPart sont vides. Si vous choisissez de créer votre propre mise en page de catégorie, vous devez inclure les marques de révision pour l’extrait de code de recherche de contenu dans le fichier HTML de votre mise en page. Le code suivant montre les marques de révision pour l’extrait de code de recherche de contenu. Remplacez ResultSourceID par le GUID de la source de résultats et catalogURL par l’URL du catalogue.

Remarque

Les GUID pour ID et __WebPartId sont générés de façon aléatoire par SharePoint quand les extraits de code sont ajoutés à la mise en page.

<!--
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-->

Création d’une mise en page d’élément de catalogue

Avant de créer ou personnaliser une mise en page d'élément de catalogue, nous vous recommandons de créer un lecteur réseau mappé qui pointe vers la galerie de pages maîtres. Pour plus d’informations, voir Guide pratique pour mapper un lecteur réseau à la galerie de pages maîtres SharePoint.

De la même manière qu'avec la mise en page de catégorie, le moyen le plus simple de créer une mise en page d'élément de catalogue consiste à laisser SharePoint créer la mise en page automatiquement lorsque vous connectez le site de publication à un catalogue, pour ensuite personnaliser la mise en page d'élément de catalogue existante afin d'ajouter tout balisage supplémentaire requis par la conception de page. Vous pouvez également créer une mise en page d’élément de catalogue en partant de zéro à l’aide du gestionnaire de conception.

Personnalisation d’une mise en page d’élément de catalogue existante qui a été créée automatiquement par SharePoint

À l’aide de l’Explorateur Windows, ouvrez le lecteur réseau mappé à la galerie de pages maîtres.
Pour personnaliser une mise en page d'élément de catalogue, modifiez le fichier HTML qui réside directement sur le serveur à l'aide d'un éditeur HTML afin d'ouvrir et de modifier le fichier HTML dans le lecteur mappé. Chaque fois que vous enregistrez le fichier HTML, toutes les modifications sont synchronisées sur le fichier .aspx associé.
À l'intérieur de l'espace réservé de contenu comportant l'élément id="PlaceHolderMain", ajoutez le balisage que vous souhaitez utiliser dans la mise en page.
Supprimez les extraits de code que vous ne souhaitez pas utiliser dans la mise en page et déplacez les extraits de code restants vers des emplacements au sein du balisage où vous souhaitez que les valeurs de propriété apparaissent.

Attention : par défaut, un extrait de code de zone de composants WebPart contenant un extrait de code de réutilisation d’élément de catalogue est ajouté à la mise en page. Cet extrait de code contient le fournisseur de données qui renvoie les résultats de requête utilisés par tous les autres extraits de code de la page. Nous vous conseillons de conserver l’extrait de code de réutilisation d’élément de catalogue dans cet extrait de code de zone de composants WebPart par défaut. (Vous pouvez déplacer l'Catalog-Item Réutiliser l’extrait de code en dehors de la zone du composant WebPart et modifier la propriété qu’il affiche. Toutefois, vous devez conserver l'Catalog-Item Réutiliser l’extrait de code dans la mise en page.) Pour plus d’informations, consultez Champs de page, plus loin dans cet article.
Pour configurer et copier l’extrait de code HTML pour tous les extraits de code que vous souhaitez utiliser dans la page, suivez les étapes 1 à 11 de la section « Insérer un extrait de code à partir de la galerie d’extraits de code » des extraits de code du Gestionnaire de conception SharePoint.
Apportez toute autre modification requise au balisage, puis enregistrez le fichier.
Suivez les étapes 9 à 11 de la section « Créer une mise en page » de Comment : créer une mise en page dans SharePoint pour vérifier l’état du fichier, afficher un aperçu de la mise en page et corriger les erreurs éventuelles.

Création d’une mise en page d’élément de catalogue à l’aide du gestionnaire de conception

Suivez les étapes 1 à 6 de la section « Créer une mise en page » de Guide pratique pour créer une mise en page dans SharePoint.
À l'étape 7, choisissez Catalogue distant, puis sélectionnez le catalogue qui contient les données supposées s'afficher sur la page.
Sélectionnez OK.

À ce stade, SharePoint crée un fichier HTML et un fichier .aspx portant le même nom.

Dans le gestionnaire de conception, votre fichier HTML apparaît désormais avec une colonne Statut indiquant l'un des deux statuts possibles :

Erreurs
La conversion a réussi

À l'aide de l'Explorateur Windows, ouvrez le lecteur réseau mappé à la galerie de pages maîtres.
Pour personnaliser la mise en page d'élément de catalogue, modifiez le fichier HTML qui réside directement sur le serveur à l'aide d'un éditeur HTML afin d'ouvrir et de modifier le fichier HTML dans le lecteur mappé. Chaque fois que vous enregistrez le fichier HTML, toutes les modifications sont synchronisées sur le fichier .aspx associé.
À l'intérieur de l'espace réservé de contenu comportant l'élément id="PlaceHolderMain", ajoutez le balisage que vous souhaitez utiliser dans la mise en page.
Supprimez les extraits de code que vous ne souhaitez pas utiliser dans la mise en page et déplacez les extraits de code restants vers des emplacements au sein du balisage où vous souhaitez que les valeurs de propriété apparaissent.

Attention : par défaut, un extrait de code de zone de composants WebPart contenant un extrait de code de réutilisation d’élément de catalogue est ajouté à la mise en page. Cet extrait de code contient le fournisseur de données qui renvoie les résultats de requête utilisés par tous les autres extraits de code de la page. Nous vous conseillons de conserver l’extrait de code de réutilisation d’élément de catalogue dans cet extrait de code de zone de composants WebPart par défaut. (Vous pouvez déplacer l'Catalog-Item Réutiliser l’extrait de code en dehors de la zone du composant WebPart et modifier la propriété qu’il affiche. Toutefois, vous devez conserver l'Catalog-Item Réutiliser l’extrait de code dans la mise en page.) Pour plus d’informations, consultez Champs de page, plus loin dans cet article.
Pour configurer et copier l’extrait de code HTML pour tous les extraits de code que vous souhaitez utiliser dans la page, suivez les étapes 1 à 11 de la section « Insérer un extrait de code à partir de la galerie d’extraits de code » des extraits de code du Gestionnaire de conception SharePoint.
Apportez toute autre modification requise au balisage, puis enregistrez le fichier.
Suivez les étapes 9 à 11 de la section « Créer une mise en page » de Comment : créer une mise en page dans SharePoint pour vérifier l’état du fichier, afficher un aperçu de la mise en page et corriger les erreurs éventuelles.

Présentation du balisage dans la mise en page d’élément de catalogue HTML

Lorsque vous créez une mise en page, un fichier .aspx que SharePoint utilise est créé, et un balisage HTML est ajouté à la version HTML de la mise en page. Les mises en page d'élément de catalogue disposent de composants de balisage qui sont ajoutés à la mise en page selon la fonctionnalité de publication de collections intersites, et qui sont propres aux mises en page d'élément de catalogue. Lorsque vous modifiez la mise en page d’élément de catalogue HTML dans votre éditeur HTML, il peut être utile de comprendre une partie de ce balisage.

Titre de la page de la fenêtre du navigateur

Le composant qui apparaît à l'intérieur de l'espace réservé de contenu avec l'élément id="PlaceHolderPageTitle" comporte un extrait de code de réutilisation de l'élément de catalogue qui indique à SharePoint d'utiliser le nom de l'élément de catalogue comme titre de page dans la fenêtre du navigateur, plutôt que la valeur du champ de page standard. Le code suivant affiche le balisage pour le titre de la page de la fenêtre du navigateur.

Remarque

Les GUID pour ID et __WebPartId sont générés de façon aléatoire par SharePoint quand les extraits de code sont ajoutés à la mise en page.


<!--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-->

Champs de page

Les composants qui s'affichent à l'intérieur de l'espace réservé de contenu avec l'élément id="PlaceHolderMain" contiennent des extraits de code pour les champs Title, Page Content et Catalog-Item URL. Vous pouvez supprimer l'un de ces extraits de code de la mise en page. Le code suivant illustre le balisage de ces champs de page.


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

Si la mise en page de l’élément de catalogue a été créée automatiquement lorsque le site de publication a été connecté à un catalogue, ou si elle a été créée en sélectionnant un catalogue distant lors de la création de la mise en page, la mise en page contient également un extrait de code de zone du composant WebPart qui contient un extrait de code de réutilisation Catalog-Item qui inscrit un fournisseur de données pour la page. L'extrait de code de réutilisation de l'élément de catalogue contient une propriété UseSharedDataProvider qui est définie sur False. L’extrait de code de zone du composant WebPart peut être supprimé de la mise en page. Toutefois, l'extrait de code de réutilisation de l'élément de catalogue doit être conservé dans le balisage de la mise en page pour que la page puisse afficher les éléments de catalogue. Lorsque vous créez une page qui utilise cette mise en page, vous pouvez configurer le composant WebPart afin qu’il soit masqué lorsqu’un utilisateur consulte la page.

Important : si vous créez une nouvelle mise en page d’élément de catalogue et choisissez un type de contenu au lieu d’un catalogue distant, vous devez inclure un extrait de code de réutilisation d’élément de catalogue dans la mise en page. Le code suivant montre les marques de révision de l’extrait de code de réutilisation d’élément de catalogue telles qu’elles apparaissent dans l’extrait de code de zone de composants WebPart. Remplacez ManagedPropertyName par le nom de la propriété managée à afficher, resultSourceID par le GUID de la source de résultat et catalogURL par l’URL du catalogue.


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

Si la mise en page d'élément de catalogue a été créée automatiquement lorsque le site de publication a été connecté à un catalogue, ou lorsqu'il a été créé en sélectionnant un catalogue distant lors de la création de la mise en page, le reste de la page contient des extraits de code de réutilisation de l'élément de catalogue qui correspondent aux propriétés gérées provenant du catalogue sur le site de création. Ces propriétés gérées affichent les détails de l'élément de catalogue spécifique qui s'affiche à l'aide de la mise en page d'élément de catalogue. Ces Catalog-Item Réutiliser les extraits de code apparaissent en dehors de la zone du composant WebPart et sont affichés directement sur la page lorsqu’un élément est choisi dans une page de catégorie. Le tableau 2 répertorie les propriétés gérées qui sont automatiquement incluses dans la mise en page d'élément de catalogue.

Remarque

Certaines propriétés gérées sont incluses uniquement si le catalogue est une bibliothèque de pages. La colonne Utilisateur dans le tableau 2 indique les propriétés gérées qui sont utilisées à la fois par une bibliothèque de pages et une liste, et celles qui proviennent d’une bibliothèque de pages uniquement.

Tableau 2. Extraits de code de réutilisation de l’élément de catalogue de propriétés gérées par défaut

Propriété gérée	Description	Utilisateur
AuthorOWSUSER	Nom de l’utilisateur qui a créé la page.	Bibliothèque de pages uniquement
CreatedOWSDATE	Date de création de l’élément de liste ou de page.	Liste et bibliothèque de pages
EditorOWSUSER	Nom de l’utilisateur qui a modifié l’élément de liste ou de page.	Liste et bibliothèque de pages
ListItemID	ID de l’élément de liste ou de page.	Liste et bibliothèque de pages
ModifiedOWSDATE	Date de la dernière modification de l’élément de liste ou de page.	Liste et bibliothèque de pages
PublishingContactOWSUSER	Contact est une colonne de site créée par la fonctionnalité de publication. Cet élément est utilisé sur le type de contenu de page en tant que la personne ou le groupe qui est le contact pour la page.	Bibliothèque de pages uniquement
PublishingIsFurlPageOWSBOOL	Valeur booléenne qui indique si la page est associée à une URL conviviale.	Bibliothèque de pages uniquement
PublishingPageContentOWSHTML	Contenu HTML de la page.	Bibliothèque de pages uniquement
PublishingPageLayoutOWSURLH	URL vers la mise en page utilisée pour créer la page.	Bibliothèque de pages uniquement
Titre	Titre de l’élément de liste ou de la page.	Liste et bibliothèque de pages

Les propriétés gérées des colonnes personnalisées que vous ajoutez à la liste ou à la bibliothèque de pages sont également incluses dans les extraits de code de réutilisation d’élément de catalogue. Le nom de la propriété gérée varie en fonction du type de colonne de site que vous utilisez lorsque vous créez la colonne de site. Pour plus d’informations, voir Propriétés managées créées automatiquement dans SharePoint et Vue d’ensemble du schéma de recherche dans SharePoint.

Important : la colonne de site Image de la page dans une bibliothèque de pages est mappée à la propriété gérée PublishingImage. Cependant, la propriété gérée PublishingImage n’est pas incluse automatiquement dans la mise en page d’article de catégorie. Pour inclure l’image dans votre mise en page, vous devez ajouter un extrait de code de réutilisation d’élément de catalogue pour la propriété gérée PublishingImage. Utilisez le code HTML suivant pour ajouter un extrait de code de réutilisation d’élément de catalogue et afficher la valeur de la propriété gérée PublishingImage dans votre mise en page. Remplacez UniqueID par un GUID unique à chaque instance de l'extrait de code.


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

Si vous créez une mise en page d'élément de catalogue à l'aide du gestionnaire de conception et que vous choisissez un type de contenu au lieu d'un catalogue distant, vous pouvez ajouter des extraits de code de réutilisation de l'élément de catalogue à la page à l'aide de la galerie d'extraits de code. Le code suivant illustre le balisage pour les extraits de code de réutilisation de l'élément de catalogue pour les propriétés gérées Title, PublishingPageContentOWSHTML, CreatedOWSDATE et owstaxIdPageCategory.

Remarque

Les GUID pour ID et __WebPartId sont générés de façon aléatoire par SharePoint quand les extraits de code sont ajoutés à la mise en page.


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

Share via

Procédure : Personnaliser des mises en page pour un site de catalogue dans SharePoint

Conditions préalables à la création et la personnalisation de mises en page pour un site de catalogue

Concepts fondamentaux pour la création et la personnalisation de mises en page pour un site de catalogue

Introduction aux mises en page de catégorie et d’élément de catalogue

Création d’une mise en page de catégorie

Personnalisation d’une mise en page de catégorie existante qui a été créée automatiquement par SharePoint

Création d’une mise en page de catégorie à l’aide du gestionnaire de conception

Présentation du balisage dans la mise en page de catégorie HTML

Titre de la page de la fenêtre du navigateur

Titre de la page

Extrait de code de recherche de contenu

Création d’une mise en page d’élément de catalogue

Personnalisation d’une mise en page d’élément de catalogue existante qui a été créée automatiquement par SharePoint

Création d’une mise en page d’élément de catalogue à l’aide du gestionnaire de conception

Présentation du balisage dans la mise en page d’élément de catalogue HTML

Titre de la page de la fenêtre du navigateur

Champs de page

Voir aussi

Ressources supplémentaires