Métadonnées, navigation de site et fonctionnalités de publication de site SharePoint
Cet article explique comment gérer les métadonnées et personnaliser la navigation du site et les fonctionnalités de publication de site dans SharePoint Online à l’aide du modèle de complément. Il décrit également les façons d’utiliser des modèles et des bibliothèques de programmation web courants pour personnaliser la personnalisation des sites de publication SharePoint.
Termes et concepts
Tableau 1. Termes et concepts clés relatifs aux métadonnées, à la navigation et à la publication
| Terme ou concept | Description et conseils |
|---|---|
| Composant WebPart de recherche de contenu | Composant WebPart SharePoint qui affiche le contenu de recherche dynamique sur les pages de manière à ce que vous puissiez facilement mettre en forme. Pour plus d’informations, voir : Configurer des composants WebPart de recherche dans SharePoint Server, Configurer un composant WebPart Recherche de contenu dans SharePoint, Fonctionnalités de recherche dans SharePoint Online |
| ContentTypeId | Identificateurs uniques des types de contenu conçus pour être récursifs. Pour plus d’informations, consultez ContentTypeId, classe (CSOM). |
| Type de contenu | Collection réutilisable et centralisée de métadonnées (colonnes), de flux de travail, de comportement et d’autres paramètres pour une catégorie d’informations. Pour plus d’informations, consultez : Colonnes, Création de types de contenu, Informations personnalisées dans les types de contenu |
| Concentrateur de type de contenu | Partie de l’application de service de métadonnées managées, qui est un site hub qui publie des types de contenu dans d’autres collections de sites. Vous permet de publier, de republier et d’annuler la publication de types de contenu à partir d’un emplacement central. Pour plus d’informations, consultez : - Publier un type de contenu à partir d’un hub de publication de contenu, Afficher les journaux des erreurs pour la publication du type de contenu |
| Canaux des périphériques | Méthode de rendu des pages de site de publication de plusieurs façons à l’aide de différentes conceptions qui ciblent plusieurs appareils. Pour plus d’informations, voir Ajouter un extrait de code du volet de canal d’appareil dans SharePoint. |
| Modèle d’affichage | Utilisés dans les composants WebPart qui utilisent la technologie de recherche, les modèles d’affichage contrôlent le rendu des résultats des requêtes effectuées sur l’index de recherche. Les modèles d’affichage sont disponibles pour tous les composants WebPart De recherche. Pour plus d’informations, voir Afficher les références de modèle dans SharePoint Server. |
| Navigation gérée | Navigation de site optimisée par le service de métadonnées managées SharePoint (taxonomie). Utilisez-la pour générer une navigation de site dérivée d’une taxonomie de métadonnées managées. La navigation managée fonctionne souvent mieux avec le catalogue de produits. |
| Métadonnées gérées | Collection hiérarchique de termes gérés de manière centralisée que vous pouvez utiliser pour définir et attribuer des éléments dans SharePoint. Vous pouvez utiliser des métadonnées managées pour gérer la publication de types de contenu et créer des taxonomies. Dans SharePoint et SharePoint Online, le service de métadonnées managées est utilisé pour créer une navigation managée, c’est-à-dire une navigation de site optimisée par la taxonomie. Pour plus d’informations, voir : Personnalisation des contrôles et fournisseurs de navigation dans SharePoint Server 2010 (ECM),Introduction aux métadonnées managées, Présentation des métadonnées managées dans SharePoint Server 2010, Administration des métadonnées managées (SharePoint Server 2010),Métadonnées gérées et navigation dans SharePoint, Navigation managée dans SharePoint, Migration des métadonnées gérées dans SharePoint Server 2010 |
| Espace de noms de navigation | Contient des classes de modèle objet client (CSOM) qui prennent en charge la navigation de site pour les sites de publication. |
| Espace de noms de taxonomie | Contient des classes CSOM qui prennent en charge les fonctionnalités de taxonomie. Pour plus d’informations, voir Exemple de complément SharePoint synchroniser des groupes de termes. |
| Épinglage | Comme pour réutiliser un terme, l’épinglage maintient une relation partagée entre le terme source et le instance de réutilisation. Par exemple, la relation partagée peut s’étendre sur plusieurs collections de sites dans un scénario de publication intersites. Chaque fois que le terme est ajouté ou supprimé, cette action est mise à jour dans la hiérarchie partout où le terme est épinglé. Pour plus d’informations, voir Utiliser du code pour épingler des termes à des ensembles de termes de navigation dans SharePoint. |
| Catalogue de produits | Pour plus d’informations, consultez les rubriques suivantes : - Publication intersites dans SharePoint, Configurer la publication intersites dans SharePoint Server |
| Extrait | Élément de fonctionnalité HTML que vous pouvez ajouter au fichier HTML généré par le Gestionnaire de conception. Par exemple, vous souhaiterez peut-être ajouter un panneau Canal d’appareil à votre page de publication. Il existe un extrait de code pour cela. Les articles suivants fournissent quelques exemples : Ajouter un extrait de code du volet de canal d’appareil dans SharePoint, Ajouter un extrait de zone de composant WebPart dans SharePoint, Ajouter un extrait de code de découpage de sécurité dans SharePoint |
| Navigation structurée | Pour plus d’informations sur l’utilisation de la navigation structurée, voir Guide pratique pour personnaliser la navigation dans SharePoint Server 2010 (ECM). |
Conditions préalables à l’utilisation du modèle CSOM pour les sites de publication de marque
Par défaut, le contenu web publié sur des sites web locaux SharePoint publics est disponible pour les utilisateurs anonymes. Par défaut, CSOM et REST ne sont pas disponibles pour les utilisateurs anonymes.
Importante
Ce scénario présente une menace potentiellement sérieuse pour les sites SharePoint locaux. Avant d’utiliser le modèle d’approvisionnement à distance décrit dans Utiliser l’approvisionnement à distance pour personnaliser les pages SharePoint afin d’approvisionner la personnalisation sur les sites de publication, assurez-vous que la sécurité et les autorisations de votre site sont correctement définies, et tenez compte des implications en matière de sécurité de l’accès anonyme.
Dans le cas où l’administrateur de site crée une application web qui inclut une collection de sites qui utilise le modèle de publication et active également l’accès anonyme, l’accès anonyme est disponible pour chaque utilisateur du site lorsque l’application est chargée dans le catalogue de compléments. Étant donné que l’accès anonyme est activé pour le site de publication SharePoint local, que se passe-t-il si un utilisateur qui n’est pas authentifié accède au site ?
Si vous créez un complément hébergé par SharePoint et que vous ajoutez un composant de complément client au projet, accédez à Compléments d’administration> centraleGérer le catalogue de compléments et créez un catalogue decompléments> pour l’application web, publiez le complément hébergé par SharePoint à l’aide de Visual Studio pour créer le package de complément, puis chargez le package de complément dans le catalogue de compléments. À ce stade, l’administrateur de collection de sites peut ajouter le complément au site de publication. Le complément peut désormais être ajouté à une page du site de publication.
Si vous modifiez la page main du site de publication et que vous y publiez le complément, le complément fonctionne comme prévu. Le choix du titre lié du complément charge l’expérience pleine page. Si SharePoint génère une erreur, cela signifie que l’utilisateur anonyme n’a pas accès à l’utilisation du modèle CSOM. Cela est logique, car CSOM et REST ne sont pas disponibles par défaut pour les utilisateurs anonymes.
N’oubliez pas que la désactivation des autorisations Utiliser les interfaces distantes peut introduire un risque pour la sécurité
Dans Autorisations de site, la zone Exiger l’utilisation de l’autorisation d’interfaces distantes case activée est sélectionnée par défaut. Vous pouvez décochez la zone d’autorisation Utiliser les interfaces distantes case activée pour permettre aux utilisateurs anonymes d’avoir accès à l’utilisation de CSOM et REST. Cela dissocie l’utilisateur des autorisations Utiliser les interfaces distantes, ce qui accorde à l’utilisateur l’accès à SOAP, WebDAV et CSOM. La désactivation de la zone case activée supprime également la possibilité d’utiliser SharePoint Designer.
Il peut arriver que vous souhaitiez supprimer la possibilité d’utiliser SharePoint Designer, tout en autorisant l’utilisation de CSOM. La zone Utiliser l’autorisation d’interfaces distantes case activée vous permet d’autoriser les utilisateurs anonymes à utiliser le modèle CSOM sans avoir à disposer des autorisations Utiliser les interfaces distantes. Lorsque la zone d’autorisation Utiliser les interfaces distantes case activée est désactivée et que vous choisissez le titre lié du complément pour charger l’expérience pleine page, SharePoint ne génère pas d’erreur. Le code de gestion des erreurs de base interprète ce cas comme un utilisateur anonyme.
Attention
- Lorsque vous ajoutez des applications à des sites SharePoint publics qui utilisent le modèle De publication, ne désactivez pas la zone Utiliser les autorisations d’interfaces distantes case activée dans Autorisations du site. L’activation du modèle CSOM pour les utilisateurs anonymes présente un risque de divulgation d’informations possible. il divulgue beaucoup plus d’informations que vous ne l’auriez prévu. Cela dit, même avec l’accès au modèle CSOM complet, les autorisations SharePoint s’appliquent toujours. Les utilisateurs anonymes ne pourront voir que les listes ou les éléments qui ont été explicitement mis à la disposition des utilisateurs anonymes. Plus que ce que vous voyez sur la page web est disponible pour les utilisateurs anonymes via CSOM et REST.
- Sauf si cela est absolument nécessaire, n’désactivez pas la zone d’case activée autorisation Exiger l’utilisation des interfaces distantes lorsque les autorisations d’accès anonyme sont activées sur un site de publication local SharePoint. Cela peut exposer le contenu du site publié et non publié à des utilisateurs anonymes, et laisser votre site ouvert à une attaque par déni de service.
Utiliser la fonctionnalité ViewFormPagesLockdown
Pour empêcher les utilisateurs d’accéder aux pages de formulaires (par exemple, Pages/Forms/AllItems.aspx) dans un site SharePoint public, utilisez la fonctionnalité ViewFormPagesLockdown . Il est conçu pour empêcher les utilisateurs de voir les informations Créées par et Modifiées par . Cette fonctionnalité supprime l’autorisation d’afficher les pages d’application ou d’utiliser des interfaces distantes. Lorsque cette fonctionnalité est active, les utilisateurs ne peuvent pas accéder à Pages/Forms/AllItems.aspx et afficher les éléments de cette bibliothèque.
Si CSOM et REST sont disponibles pour tous les utilisateurs anonymes(si la zone Utiliser les autorisations d’interfaces distantes case activée est désactivée), bien qu’ils ne puissent toujours pas voir les informations Créée par et Modifiée par dans le navigateur, ils peuvent utiliser CSOM ou REST pour accéder à ces informations.
Configurer l’accès anonyme (filtrage de sécurité)
En configurant l’accès anonyme pour l’application web, vous spécifiez la stratégie anonyme : Refuser l’écriture — N’a pas d’accès en écriture . Cela signifie que les utilisateurs disposant d’un accès anonyme ne peuvent pas écrire sur le site, même avec du code CSOM ou REST. Les utilisateurs anonymes peuvent uniquement voir les informations qui leur ont été accordées lors de la configuration de l’accès anonyme au site.
Par défaut, les pages non publiées ne sont pas visibles par les utilisateurs anonymes. Ils peuvent uniquement voir les listes qui activent l’accès anonyme.
Importante
Si la zone Utiliser les autorisations d’interfaces distantes case activée est désactivée, utilisez le modèle d’autorisations et d’autres précautions pour vous assurer que les utilisateurs anonymes n’ont pas accès à des éléments qu’ils ne devraient pas.
Empêcher les attaques par déni de service
Il n’y a pas de mise en cache avec CSOM. Cela signifie qu’un attaquant malveillant peut interroger des milliers d’éléments à partir de listes simultanément, tout en restant sous le seuil d’affichage de liste par défaut et en taxant la base de données SharePoint. Cela pourrait se propager et dégénérer en une attaque de déni de service complète.
Utiliser une stratégie d’application uniquement
Vous pouvez utiliser une stratégie d’application uniquement avec des compléments hébergés par un fournisseur. La stratégie d’application uniquement permet au complément d’effectuer des actions que l’utilisateur actuel n’est pas autorisé à effectuer. Par exemple, un utilisateur disposant d’autorisations en lecture seule qui est notable pour écrire dans une liste peut utiliser un complément avec des autorisations d’application uniquement pour écrire dans une liste.
Pour plus d’informations, voir Autorisation et authentification des compléments SharePoint et Présentation de l’authentification et des autorisations avec des applications pour SharePoint et Office (vidéo Channel 9).
Implémenter SSL
Lorsque vous utilisez le modèle de complément, implémentez le protocole SSL (Secure Sockets Layer) pour gérer la sécurité des transmissions de messages sur Internet. SSL fonctionne par le site web distant, en envoyant un jeton d’accès dans l’en-tête HTTP Authorization avec la valeur Bearer + une chaîne encodée en base64 (non chiffrée).
Importante
SSL protège votre site de publication SharePoint contre les attaquants qui souhaitent accéder à un jeton d’autorisation et exploiter cet accès.
Sites d’approvisionnement et de publication à distance
Vous pouvez utiliser des pratiques d’approvisionnement à distance pour provisionner la personnalisation et d’autres personnalisations sur les sites de publication SharePoint.
Les sites de publication dépendent des types de contenu et du ContentTypeId, qui lie les types de contenu aux mises en page et aux modèles d’affichage. La personnalisation et l’approvisionnement du contenu des pages de publication SharePoint dépendent de cette fonctionnalité. D’autres aspects du comportement d’approvisionnement de site de publication personnalisé, tels que les services de métadonnées managés et la navigation managée, ne dépendent pas de ContentTypeId et sont entièrement pris en charge dans CSOM.
Les autres options de personnalisation du site de publication, telles que les canaux d’appareils et les modèles d’affichage, ne nécessitent pas de modèle CSOM personnalisé. Ils dépendent des fonctionnalités du Gestionnaire de conception, css et HTML. Il s’agit de personnalisations postérieures à l’approvisionnement que vous générez à partir de zéro et que vous n’avez pas besoin de migrer.
Métadonnées gérées
La fonctionnalité de métadonnées managées, introduite pour la première fois dans SharePoint 2010, vous permet de définir une hiérarchie personnalisée, ou taxonomie, des balises de métadonnées à utiliser dans SharePoint. Si vous souhaitez créer une navigation de site personnalisée, vous pouvez utiliser la fonctionnalité de navigation managée, qui repose sur l’infrastructure de métadonnées managées.
Une taxonomie est une classification hiérarchique de mots, d’étiquettes ou de termes organisés en groupes basés sur des similitudes. La plus petite unité d’une taxonomie SharePoint est le terme . Les termes peuvent être regroupés dans des ensembles de termes. Les ensembles de termes peuvent être regroupés par affinité en groupes plus grands.
Pour une brève présentation de la taxonomie dans SharePoint, voir Brève introduction aux métadonnées managées d’entreprise dans SharePoint 2010 et Présentation des métadonnées managées dans SharePoint 2010.
SharePoint 2013 a introduit de nouvelles API et fonctionnalités pour l’ensemble de fonctionnalités de métadonnées managées.
Modèle de programmation de métadonnées managées
Pour SharePoint, le modèle de programmabilité .NET Server pour les métadonnées managées est défini dans l’ensemble d’espaces de noms suivant :
- Espace de noms de taxonomie
- Espace de noms ContentTypeSync
- Espace de noms générique
- Espace de noms CodeBehind
- Mettre à niveau l’espace de noms
- Espace de noms WebServices
Les classes CSOM équivalentes se trouvent dans l’espace de noms Client.Taxonomy .
Contrairement à d’autres zones du modèle objet SharePoint, pour les métadonnées managées, il existe une affinité étroite entre les classes et les membres du modèle de programmation .NET Server et les classes et membres CSOM.
Voici quelques différences clés :
- CSOM ne prend pas en charge la synchronisation de type de contenu.
- La classe Group, qui représente la couche supérieure de organization dans la classe TermStore, n’est disponible que dans le modèle objet .NET Server. Son équivalent dans CSOM est la classe TermGroup .
- La classe GroupCollection, qui représente une collection d’objets Group, est disponible uniquement dans le modèle objet .NET Server. Son équivalent dans CSOM est la classe TermGroupCollection .
- CSOM inclut les classes CustomPropertyMatchInformation et LabelMatchInformation qui conservent les données de propriété et d’étiquette personnalisées synchronisées avec le serveur.
Le tableau suivant compare les classes du modèle objet .NET Server et du modèle objet CSOM.
Tableau 2. Comparaison des classes dans les deux modèles
Mises en page
Pour les sites de publication, la mise en page définit la mise en page d’une classe spécifique de pages. Il définit également les régions personnalisables d’une page avec des espaces réservés de contenu, qui sont renseignés par le contenu des régions correspondantes sur les mises en page. Les mises en page sont généralement basées sur un type de contenu personnalisé. Les types de contenu définissent les champs de contenu personnalisés que vous souhaitez afficher sur une page. En règle générale, vous créez un type de contenu personnalisé qui inclut des champs qui correspondent à la conception de page que vous ou votre équipe de conception avez précédemment planifiée.
Les contrôles de champ personnalisés peuvent inclure du texte, des images, des vidéos ou d’autres types de contenu. SharePoint fournit des types de contenu pour Article, Catalogue, Page d’accueil, etc. Accédez aux types de contenu de mise en page en accédant à Paramètres> dusite Types de contenu de site. Ces types de contenu de mise en page par défaut peuvent servir de types de contenu parent pour un type de contenu personnalisé que vous créez.
Tous les types de contenu de mise en page héritent du type de contenu Page. Après avoir créé un type de contenu personnalisé, SharePoint affiche les colonnes que le nouveau type de contenu a héritées du type de contenu Page. Vous pouvez ajouter de nouvelles colonnes de site pour représenter les nouveaux champs personnalisés que vous souhaitez afficher dans votre mise en page. Spécifiez un type pour chaque colonne de site. Un type est une valeur telle que « ligne de texte unique » ou « HTML complet ». Tenez compte de facteurs tels que le degré de description ou de contrôle que l’utilisateur doit avoir avec le champ lorsque vous spécifiez son type.
Après avoir créé tous les champs qui stockent le contenu dans votre mise en page, vous pouvez créer la mise en page dans le Gestionnaire de conception. Pour obtenir plus d’informations, consultez l’article Procédure : créer une mise en page dans SharePoint.
Après avoir créé la mise en page, publiez-la en accédant à Paramètres >du sitePages maîtres et mises en page. Un fichier HTML et un fichier ASPX sont présents. Le fichier HTML est le master et vous pouvez utiliser n’importe quel éditeur HTML pour le modifier. Une fois le fichier enregistré et publié, le Gestionnaire de conception incorpore les modifications et convertit le fichier HTML mis à jour au format ASPX, que SharePoint utilise pour afficher la page. Pour publier la mise en page, sélectionnez le fichier HTML et choisissez Publier dans le ruban.
Pour créer une page basée sur la nouvelle mise en page, accédez à Miseen page nouvelle>> page pour afficher la nouvelle mise en page dans la liste des mises en page disponibles. Lorsque vous choisissez la nouvelle mise en page, vous devez voir tous les nouveaux champs que vous avez spécifiés lorsque vous avez créé un nouveau type de contenu pour la nouvelle mise en page. Si vous affichez la page et que le code HTML ne s’affiche pas comme prévu, vous pouvez modifier le code HTML, puis utiliser le Gestionnaire de conception pour charger le fichier mis à jour.
Navigation de site
Il existe quatre types de navigation de site :
- Navigation globale
- Navigation locale
- Navigation structurée
- Navigation gérée
La navigation globale fait référence aux éléments de navigation qui aident les utilisateurs à passer d’un site SharePoint à un autre.
La navigation locale fait référence à la navigation au sein d’un site SharePoint.
La navigation structurée et managée est un peu plus impliquée.
Navigation structurée
La navigation structurée est une approche statique de l’implémentation de la navigation sur les sites SharePoint. Il correspond généralement à la structure de l’entreprise, ce qui nécessite une restructuration de la navigation du site SharePoint. Le travail de restructuration implique souvent le déplacement de sous-sites et/ou de pages, et l’actualisation des liens pour pointer vers de nouvelles cibles.
La navigation structurée peut être suffisante pour des structures de site assez plates et peu profondes si la structure de votre entreprise (et par conséquent la structure du site) est stable pendant de longues périodes. Pour des structures de site plus profondes et plus complexes, ainsi que pour les entreprises avec des structures de navigation de site de publication qui doivent croître et changer dynamiquement, la navigation managée peut être une meilleure option.
Pour plus d’informations sur la navigation structurée, voir Guide pratique pour personnaliser la navigation dans SharePoint Server 2010.
Navigation gérée
La navigation managée repose sur le site de publication et l’infrastructure de taxonomie de base. La navigation managée est liée à une seule collection de sites. Il utilise des ensembles de termes et des termes pour définir la navigation globale et locale. Par exemple, vous pouvez créer un ensemble de termes qui définit la navigation globale, puis ajouter des termes à cet ensemble de termes pour des éléments de navigation spécifiques dans la navigation globale.
Vous trouverez plus d’informations sur la navigation managée dans les articles suivants :
Voici quelques points importants sur les classes, méthodes et propriétés dans le modèle d’extensibilité de navigation SharePoint pour les sites de publication :
- Les classes NavigationTerm et NavigationTermSet ajoutent des propriétés et des méthodes spécifiques à la navigation managée. Un état supplémentaire est stocké dans la propriété CustomProperties de la classe NavigationTerm .
- Les classes NavigationTerm et NavigationTermSet ont deux modes : modifiable et lecture seule. Dans le modèle objet .NET Server, les objets NavigationTerm sont stockés dans le cache de navigation de taxonomie, qui est accessible uniquement par les fonctions de la classe statique TaxonomyNavigation .
- Les objets PortalSiteMapNodeProvider dans le modèle objet .NET Server fournissent une interface entre les fonctionnalités de navigation de site pilotées par les données et les sources de données de plan de site. En règle générale, vous écrivez un fournisseur de nœuds de plan de site personnalisé pour stocker des mappages de site dans un fichier XML ou un format de données qui n’est pas pris en charge par SharePoint par défaut.
Le modèle CSOM comprend des classes et des énumérations uniques :
- L’énumération NavigationLinkType définit le type de nœud de navigation dans une arborescence de navigation. Vous pouvez spécifier un nœud en tant que nœud racine, URL conviviale ou lien standard.
- L’énumération StandardNavigationScheme identifie la navigation comme globale ou locale.
- L’énumération StandardNavigationSource comprend trois choix pour la navigation globale et la navigation locale. Chaque choix représente un état qui correspond à la configuration des fournisseurs sous-jacents.
- La classe StandardNavigationSettings gère les schémas de navigation globale et locale.
Le tableau suivant répertorie les classes de navigation de publication dans le modèle objet serveur et leurs équivalents CSOM.
Tableau 3. Publication de classes de navigation
Fonctionnalités du site de publication
SharePoint et SharePoint Online incluent quelques fonctionnalités spécifiques aux sites de publication SharePoint :
- Les canaux d’appareils vous permettent d’appliquer une conception de site de publication unique à plusieurs appareils et navigateurs.
- Les modèles d’affichage permettent de personnaliser et de personnaliser l’apparence des composants WebPart liés à la recherche.
- Les rendus d’image définissent les dimensions utilisées pour afficher les images sur les pages des sites de publication SharePoint.
Vous pouvez implémenter ces fonctionnalités à l’aide de classes dans l’espace de noms Publishing du modèle de programmation CSOM.
Canaux des appareils et volets Canaux des appareils
Vous pouvez utiliser des canaux d’appareil et des panneaux de canal d’appareil pour optimiser votre site pour les téléphones et les tablettes. En créant un canal unique pour chaque appareil que vous souhaitez cibler, vous pouvez afficher un site de publication SharePoint de plusieurs façons. Vous pouvez créer un seul site une seule fois, puis mapper le site et son contenu à différentes pages master et feuilles de style pour s’adapter à différentes cibles.
Vous créez des canaux à l’aide du Gestionnaire de conception. Après avoir créé un canal, mappez-le à l’appareil mobile ou au navigateur avec la chaîne d’agent utilisateur de l’appareil entrant.
Un appareil peut appartenir à plusieurs canaux. Dans ce cas, vous pouvez classer les canaux dans le cas où un appareil appartient. Par exemple, si vous créez un canal pour les smartphones et un canal pour une configuration d’appareil spécifique, vous pouvez classer les canaux afin que les appareils avec la configuration spécifique obtiennent le canal pour eux, et tous les autres smartphones obtiennent le canal des smartphones.
Vous pouvez créer jusqu’à 10 canaux (y compris le canal par défaut) dans le Gestionnaire de conception. Le canal par défaut capture tout le trafic non intercepté par l’un des autres canaux. Lorsque vous créez un canal, renseignez les champs répertoriés dans le tableau suivant.
Tableau 4. Canaux des périphériques
| Champ | Obligatoire ou facultatif ? | Description |
|---|---|---|
| Nom | Obligatoire | Identifie le canal pour le distinguer des autres. |
| Alias de canal | Obligatoire | Comment le code, la chaîne de requête, les cookies ou les panneaux de canaux d’appareil distinguent les différences entre les canaux. |
| Règles d’inclusion d’appareil | Obligatoire | Sous-chaînes d’agent utilisateur qui dirigent les requêtes des appareils (chacune doit se trouver sur une ligne différente). |
| Description | Facultatif | Décrit ce que fait ce canal. |
| Actif | Facultatif | Lorsqu’il est activé, le canal utilise les ressources associées pour le canal pour diriger le trafic. Sinon, la chaîne ?DeviceChannel=<alias> de requête affiche un aperçu du site dans le canal. |
Volets Canaux des appareils
Après avoir créé des canaux d’appareil, mappez une page master à chacun d’eux. Étant donné que les personnalisations de page master sont de plus en plus rares, il s’agit souvent de la page master par défaut (seattle.master). Si vous créez une page master unique pour un ou plusieurs canaux d’appareil, vous pouvez référencer un autre fichier CSS que la page master pour le canal par défaut. Les mises en page que vous créez fonctionnent avec chaque canal que vous créez. Vous pouvez utiliser le contrôle Device Channel Panel pour différencier les conceptions de mise en page entre les canaux.
Pour plus d’informations, voir Ajouter un extrait de code du volet de canal d’appareil dans SharePoint.
Le panneau de canal d’appareil est un contrôle de conteneur mappé à un ou plusieurs canaux. Vous pouvez ajouter un contrôle de panneau de canal d’appareil à une mise en page, et le panneau contrôle le contenu affiché dans chaque canal. Lorsqu’un ou plusieurs de ces canaux sont actifs lorsque la page est affichée, tout le contenu du panneau de canal d’appareil est affiché. Utilisez le panneau canal d’appareil pour déterminer quand inclure du contenu spécifique pour un ou plusieurs canaux spécifiques.
Prenons l’exemple d’une mise en page qui inclut dix champs. Certains de ces champs sont disponibles pour tous les canaux, et d’autres ne doivent être affichés que dans des canaux spécifiques. Par exemple, considérez un champ de bannière d’en-tête mobile qui s’affiche uniquement sur les smartphones, ou une grande barre latérale personnalisée qui s’affiche uniquement sur les ordinateurs de bureau et les tablettes.
Vous pouvez également utiliser le panneau canal d’appareil pour modifier le style et l’emplacement du contenu sur une page en ajoutant un css spécifique au canal.
Pour plus d’informations, voir Code de marque à l’aide de CSS dans SharePoint.
Chaînes d’agent utilisateur et canaux d’appareil
Une chaîne d’agent utilisateur est une petite chaîne de données qui identifie le navigateur. Ces informations peuvent être envoyées au serveur, qui identifie l’agent utilisateur. Les canaux d’appareil attribuent une requête à un canal d’appareil correspondant en fonction de la chaîne de l’agent utilisateur (ou des sous-chaînes) de l’appareil (ou du navigateur) à partir duquel l’utilisateur navigue. Le développeur web frontal crée et configure des canaux pour capturer le trafic.
Pour plus d’informations, consultez What Will Windows Internet Explorer Report as the User-Agent String ?
Ordre de résolution pour les canaux d’appareil
Lorsque vous créez plusieurs canaux, placez-les dans l’ordre dans lequel vous souhaitez qu’ils soient résolus. Le premier canal qui inclut une règle d’inclusion d’appareil correspondant à la chaîne de l’agent utilisateur est utilisé. Le tableau suivant montre un exemple de cette règle.
Tableau 5. Exemple de règle d’inclusion d’appareil
| Canal | Ordre 1 | Ordre 2 |
|---|---|---|
| 1 | Windows Phone 8 | Windows Phone |
| 2 | Windows Phone | Windows Phone 8 |
| 3 | Par défaut | Valeur par défaut |
Si la commande 1 est active, un utilisateur qui demande une page à partir d’un Windows Phone 8 reçoit le canal d’appareil 1 étiqueté Windows Phone 8. Un utilisateur disposant d’un autre téléphone Windows utilise le canal 2, et tout le reste utilise le canal 3. Toutefois, en utilisant l’ordre 2, un utilisateur demandant une page à partir d’un Windows Phone 8 recevait toujours le canal d’appareil 1 étiqueté Windows Phone et n’utiliserait jamais le canal d’appareil spécifié pour celui-ci.
Après avoir défini et ordonné des canaux d’appareil, vous pouvez appliquer différentes pages master à chaque canal. Par défaut, tous les canaux utilisent la page master du canal par défaut.
Remarque
CSOM n’inclut pas d’API publique pour la manipulation des canaux d’appareil et des panneaux de canal d’appareil.
Modèles d’affichage
Les sites de publication SharePoint utilisent des modèles d’affichage pour contrôler les propriétés gérées qui sont affichées dans les résultats de recherche et comment elles apparaissent dans le composant WebPart. Seuls les composants WebPart De recherche utilisent des modèles d’affichage ; Le composant WebPart Requête de contenu n’est pas un composant WebPart Recherche et n’utilise pas de modèles d’affichage.
Le tableau suivant répertorie les types de modèles d’affichage, dans l’ordre dans lequel SharePoint les applique.
Tableau 6 : Types de modèles d’affichage
| Modèle d’affichage | Description |
|---|---|
| Contrôler les modèles d’affichage | S’applique à l’ensemble du composant WebPart, donc SharePoint l’applique d’abord et une seule fois. Il fournit du code HTML qui structure la disposition globale pour la présentation des résultats de la recherche. Par exemple, un modèle d’affichage de contrôle peut fournir du code HTML pour le titre et le début et la fin d’une liste. Ce modèle n’est rendu qu’une seule fois dans le composant WebPart. |
| Modèles d’affichage de groupe | Appliqué en deuxième lieu, et est appliqué une fois par groupe au composant WebPart Résultats de la recherche. |
| Modèles d’affichage d’élément | Appliqué en dernier, sauf si un modèle d’affichage de filtre est appliqué. Les modèles d’affichage d’élément sont appliqués à chaque élément. Ce modèle détermine comment chaque élément du jeu de résultats est affiché dans le composant WebPart. Par exemple, il peut fournir le code HTML d’un élément de liste de texte brut, d’un élément de liste qui contient une image ou d’un élément de liste qui met en forme un bloc de liens supplémentaires et d’informations de description récapitulative pour aider à fournir plus de contexte pour les résultats de la recherche. |
SharePoint stocke les modèles d’affichage dans le dossier Modèles d’affichage de la galerie de pages maîtres. Chaque modèle d’affichage est associé à un type de contenu dans la page maître Gallery.To identifier le type de contenu de chaque fichier de modèle d’affichage lors de l’utilisation d’un lecteur mappé, utilisez le nom de fichier.
Les récepteurs d’événements qui convertissent et mettent à jour master pages et mises en page de HTML en JavaScript convertissent également les modèles d’affichage html en JavaScript. La conversion et la synchronisation sont unidirectionnelles ; il ne reconverti pas de JavaScript en HTML.
Remarque
CSOM n’inclut pas d’API publique pour la manipulation des modèles d’affichage.
Afficher la structure du modèle
Chaque modèle d’affichage contient les éléments suivants :
- Un titre.
- En-tête qui contient des éléments personnalisés limités par une
<mso:CustomDocumentProperties>balise. - Balise
<body>qui contient un bloc de script. - Une
<div>balise.
Les propriétés de document personnalisées fournissent des informations importantes à SharePoint sur le modèle d’affichage. Chaque modèle d’affichage est associé à un type de contenu, qui est identifié par <ContenTypeId>. Vous pouvez définir d’autres propriétés qui déterminent s’il faut masquer ou afficher le modèle dans la liste des modèles d’affichage disponibles pour le composant WebPart, le mappage de propriétés managées HTML vers JavaScript, le contexte dans lequel le modèle d’affichage est utilisé, si un fichier .js est actuellement associé au modèle d’affichage HTML et si la conversion de HTML en JavaScript a réussi ou si des avertissements et des erreurs ont été générés.
À partir de la <script> balise, vous pouvez référencer des fichiers CSS ou JavaScript externes en dehors du fichier HTML des modèles d’affichage main.
Si l’approbation du contenu est requise dans la galerie de pages maîtres, tous les fichiers CSS, JavaScript et autres ressources doivent être publiés avant d’être disponibles pour master pages et mises en page.
Pour plus d’informations, reportez-vous à Exiger l’approbation d’éléments dans une liste ou une bibliothèque de site.
La <div> balise contient un ID qui correspond au nom du fichier HTML du modèle d’affichage. Placez le code CSS ou JavaScript que vous souhaitez inclure pour personnaliser la façon dont ce composant WebPart est affiché dans le <div> bloc.
Traitement des modèles d’affichage
SharePoint définit des modèles d’affichage dans des fichiers HTML et JavaScript. Si, dans le Gestionnaire de conception, vous modifiez un fichier HTML qui contient une définition de modèle d’affichage et enregistrez les modifications, SharePoint compile les modifications dans un fichier JavaScript portant le même nom. SharePoint utilise ce fichier JavaScript pour afficher des composants WebPart sur des pages.
Importante
Ne modifiez pas le fichier JavaScript qui contient la définition du modèle d’affichage. Mettez uniquement à jour le fichier HTML. Le processus de conversion nécessite que le fichier HTML soit compatible XML. Par exemple, utilisez <br>, et non <br/>. Pour plus d’informations, voir Convertir un fichier HTML en page master dans SharePoint.
Création de modèles d’affichage
Le moyen le plus simple de créer un modèle d’affichage consiste à modifier un modèle existant. Différents modèles d’affichage modifient l’apparence de différents composants WebPart liés à la recherche, notamment le composant WebPart Recherche de contenu, le composant WebPart Affinement, le composant WebPart Affinement de taxonomie et le composant WebPart Résultats de la recherche.
Pour plus d’informations, consultez l’article suivant :
- Packages de conception du Gestionnaire de conception SharePoint
- Configurer des composants WebPart de recherche dans SharePoint Server
- Configurer les propriétés du composant WebPart d'affinement dans SharePoint Server
- Afficher la référence du modèle dans SharePoint Server
Propriétés qui peuvent être utilisées dans les modèles d’affichage
Avant de commencer à identifier les propriétés que vous pouvez utiliser dans un modèle d’affichage, recherchez un modèle d’affichage existant à partir duquel vous souhaitez créer, puis enregistrez-le sous un nouveau nom. Le code du modèle d’affichage se trouve dans la <mso:ManagedPropertyMapping> balise .
<mso:ManagedPropertyMapping msdt:dt="string">'Picture URL'{Picture URL}:'PublishingImage;PictureURL;PictureThumbnailURL','Link URL'{Link URL}:'Path','Line 1'{Line 1}:'Title','Line 2'{Line 2}:'Description','Line 3'{Line3}:'','SecondaryFileExtension','ContentTypeId'</mso:ManagedPropertyMapping>
Ensuite, ouvrezschéma de rechercheparamètres> du site, puis recherchez un nom de colonne dans la zone de filtre de propriété gérée que vous souhaitez inclure dans un modèle d’affichage. Sélectionnez la propriété gérée, puis modifiez et copiez le nom de la propriété.
<mso:ManagedPropertyMapping msdt:dt="string">'Picture URL'{Picture URL}:'PublishingImage;PictureURL;PictureThumbnailURL','Link URL'{Link URL}:'Path','Line 1'{Line 1}:'Title','Line 2'{Line 2}:'Description','Line 3'{Line3}:'','owsTXTPrice','owsTXTColor'</mso:ManagedPropertyMapping>
Remarque
Dans cet exemple, PictureURL est mappé à la première propriété managée présente lorsque la recherche obtient des résultats pour PublishingImage, PictureURL ou PictureThumbnailURL.
Rendus d’image
Un rendu d’image définit les dimensions utilisées pour afficher des images sur les pages des sites de publication SharePoint. Vous pouvez utiliser CSOM pour instancier et manipuler des rendus d’image. Vous pouvez spécifier des métadonnées telles que la hauteur, la largeur, le nom et la version d’un rendu d’image à l’aide de la classe ImageRendition . Vous pouvez utiliser des méthodes et des propriétés dans la classe SiteImageRenditions pour lire et écrire des rendus d’image à partir d’une collection de sites.
Pour plus d’informations, voir Rendus d’image du Gestionnaire de conception SharePoint.
Techniques de programmation Web et SharePoint
Les concepteurs et développeurs SharePoint souhaitent souvent utiliser des techniques de programmation web standard avec SharePoint lorsqu’ils conçoivent des sites de publication. Vous pouvez utiliser la conception réactive, la conception adaptative ou les deux canaux d’appareil et la conception réactive ensemble.
Conception réactive
Avec les canaux d’appareil, vous pouvez créer un site une seule fois, puis le cibler sur plusieurs appareils et navigateurs. La communauté de développement web utilise généralement la conception réactive et l’approche « fluid grid » pour gérer la façon dont les dispositions s’affichent et pour concevoir des sites pour qu’ils s’affichent correctement sur n’importe quel navigateur ou appareil. Dans une conception réactive, les éléments d’une page se réorganisent pour s’adapter à l’orientation de l’appareil et de l’écran de l’utilisateur.
La conception réactive est basée sur la fonctionnalité de requêtes multimédias dans CSS3. Il utilise des requêtes multimédias pour faire correspondre la largeur de l’affichage de l’appareil, puis applique des styles côté client pour afficher le contenu. Les requêtes de média permettent à un concepteur de cibler des propriétés de site spécifiques, telles que la largeur de l’écran. Vous pouvez utiliser des requêtes multimédias pour créer des dispositions et des images flexibles, et appeler de manière conditionnelle des alternatives de fichier CSS.
Pour plus d’informations et d’exemples, consultez :
- Interface utilisateur réactive SharePoint 2013/2016/Online (GitHub)
- SharePoint réactif
- Implémentation de vos conceptions réactives sur SharePoint 2013.
Conception adaptative
La conception web adaptative (parfois appelée livraison web adaptative) est similaire à la conception web réactive. Une conception adaptative écoute les appareils ou les navigateurs et choisit la méthode optimale pour afficher les pages.
La fonctionnalité canaux d’appareil dans SharePoint est une conception adaptative. Il fournit des dispositions adaptatives à chaque appareil en fonction de la mise en page, des spécifications de chaque canal d’appareil et de l’ordre défini dans le panneau canal d’appareil.
Canaux d’appareils et conception réactive ensemble
Vous pouvez utiliser des canaux d’appareil et des techniques de conception web réactive pour créer un site de publication SharePoint accessible au public. Envisagez de créer une page de master personnalisée unique pour les appareils, tels que les téléphones et les tablettes, et une autre pour les navigateurs web, et associez-les à un canal d’appareil. Ensuite, utilisez des grilles fluides, des images flexibles et des requêtes multimédias CSS3 pour créer la meilleure expérience d’affichage pour chaque appareil et navigateur que votre site doit prendre en charge.
Ajouter jQuery à un site SharePoint
Vous pouvez ajouter jQuery à un site SharePoint au niveau du site, au niveau de la page ou dans des sections d’une page, comme l’une des régions de page SharePoint ou un composant WebPart que vous avez ajouté à la mise en page.
Vous pouvez utiliser une action personnalisée pour charger jQuery à partir d’une bibliothèque de documents. Procédez ainsi si vous devez rendre jQuery disponible pour toutes les pages d’un site SharePoint. Cette approche est flexible, mais pas facile à contrôler, ce qui affecte le concepteur de site et l’administrateur. Vous pouvez stocker et gérer des fichiers JavaScript dans la bibliothèque de documents, mais ils peuvent également être modifiés ou supprimés accidentellement. Pour cette raison, nous ne recommandons pas cette approche.
Vous pouvez également charger jQuery à partir de la racine SharePoint à l’aide de ScriptLinkControl. Vous pouvez utiliser le contrôle pour insérer des scripts qui s’exécutent sur un site distant et modifier les scripts sans toucher à l’installation de SharePoint. L’approche ScriptLinkControl est logique lorsque vous souhaitez utiliser jQuery sur une page d’application ou dans un composant WebPart affiché sur une page. Bien que l’approvisionnement avec cette option soit lent et affecte les performances, car jQuery est ajouté à une page à la fois, le déploiement du fichier jQuery dans la règle SharePoint contourne d’autres exigences héritées. Cela est utile si vous avez besoin de migrer votre solution de code de confiance totale (FTC) SharePoint vers CSOM, et si la migration inclut le déplacement et la refactorisation des comportements JavaScript et jQuery personnalisés.
Enfin, vous pouvez utiliser le composant WebPart Éditeur de contenu pour charger jQuery à partir d’un réseau de distribution de contenu (CDN). Cela est utile si vous avez besoin d’ajouter jQuery à une ou plusieurs pages, y compris des pages wiki et de composants WebPart. Étant donné que vous chargez le fichier jQuery à partir d’un CDN, vous n’avez pas besoin de stocker des fichiers supplémentaires sur le serveur SharePoint, et les utilisateurs bénéficient d’une version distribuée et mise en cache des fichiers jQuery. SharePoint appelle le fichier jQuery à partir du CDN, et vous pouvez ajouter du code jQuery personnalisé que vous créez au composant WebPart Éditeur de contenu.
Créer des compléments hébergés par un fournisseur SharePoint avec ASP.NET MVC 5
Vous pouvez créer des compléments personnalisés hébergés par un fournisseur avec le modèle MVC (model-view-controller) dans SharePoint. Ce modèle sépare l’application en trois parties interconnectées. Cela sépare les représentations internes des informations de la façon dont elles sont vues et acceptées par l’utilisateur. Le modèle représente la structure sous-jacente du logiciel, la vue (généralement des éléments d’interface utilisateur) et le contrôleur, qui sont les classes qui connectent le modèle et la vue.
Vous pouvez encapsuler ASP.NET contenu MVC dans le contenu du site SharePoint master de la page. En fait, vous pouvez utiliser Office 365 API pour créer un complément SharePoint avec ASP.NET MVC 5.
Les API pour le développement MVC pour SharePoint sont définies dans Filters\SharePointContextFilterAttribute.cs et SharePointContext.cs. Ces API encapsulent les étapes que le projet web effectue pour communiquer en toute transparence avec SharePoint en un seul appel, ce qui simplifie la logique que vous devez implémenter.
L’attribut de filtre de contexte SharePoint effectue un traitement supplémentaire pour obtenir des informations standard lors de la redirection de SharePoint vers votre application web distante, telle que l’URL du site web hôte. Il détermine également si le complément doit être redirigé vers SharePoint pour que l’utilisateur se connecte (par exemple, signets). Vous pouvez appliquer ce filtre au contrôleur ou à une vue. Les classes de contexte SharePoint encapsulent toutes les informations de SharePoint afin que vous puissiez créer des contextes spécifiques pour le site web de complément et le site web hôte et communiquer avec SharePoint.
Pour plus d’informations, voir En savoir plus sur ASP.NET MVC et Présentation de la prise en charge de MVC pour les compléments SharePoint.
Voir aussi
- Appliquer des styles aux champs de page dans SharePoint
- Procédure : créer une mise en page dans SharePoint
- Procédure : Personnaliser des mises en page pour un site de catalogue dans SharePoint
- Mapper un lecteur réseau vers la Galerie de Pages maîtres de SharePoint
- Solutions de personnalisation et de mise en service du site pour SharePoint