Problèmes de personnalisation pouvant se produire lors de la mise à niveau vers SharePoint 2013

Article
03/08/2023

S’APPLIQUE À : yes-img-13 2013 no-img-16 2016 no-img-19 2019 no-img-se Subscription Edition no-img-sop SharePoint dans Microsoft 365

SharePoint 2013 présente une nouvelle interface utilisateur légère, rapide et fluide. Cette interface utilisateur est intégrée à l'aide de nouveaux styles CSS, de nouveaux thèmes et de nouvelles pages maîtres. Pour obtenir cette nouvelle expérience, vous devez effectuer une mise à niveau vers la nouvelle interface utilisateur. Toutefois, les modifications importantes qui ont été apportées pour la prise en charge de la nouvelle interface utilisateur peuvent interrompre le processus de mise à niveau pour certains scénarios dans lesquels vous utilisez la personnalisation.

Dans Produits SharePoint 2010, vous avez pu personnaliser votre site de différentes manières :

En appliquant une feuille de style personnalisée à votre site, pour remplacer les styles par défaut de SharePoint.
En appliquant un thème personnalisé (fichier THMX) à votre site.
En copiant et modifiant une page maître qui est incluse avec SharePoint 2013.
En créant une toute nouvelle page maître personnalisée dans un site de publication, où la page maître personnalisée utilise des styles personnalisés et est référencée par des mises en page personnalisées.

Lorsque vous mettez à niveau votre collection de sites vers SharePoint 2013, ces types de personnalisations ne fonctionnent pas tels quels, car les styles CSS, les thèmes et les pages maîtres par défaut ont été modifiés. Vous devez donc créer à nouveau votre personnalisation. Vous devez utiliser les nouveaux styles, thèmes ou pages maîtres disponibles dans SharePoint 2013, puis appliquez la conception nouvellement recréée à la collection de sites mise à niveau.

Les modifications apportées aux styles, thèmes et pages maîtres SharePoint par défaut étaient nécessaires afin de créer une interface utilisateur plus rapide et plus fluide, et pour rendre plus prévisibles les mises à niveau ultérieures.

Pour cette raison, si votre collection de sites contient une personnalisation, nous vous recommandons, avant la mise à niveau, de créer une collection de sites d'évaluation où vous pouvez tester et recréer votre personnalisation dans un environnement SharePoint 2013. Pour plus d’informations sur une collection de sites d’évaluation, consultez Mettre à niveau une collection de sites.

Les sections suivantes répertorient les problèmes de personnalisation pouvant se produire lors de la mise à niveau vers SharePoint 2013.

Styles CSS personnalisés

La façon la plus courante pour appliquer une personnalisation à un site Produits SharePoint 2010 consiste à créer un fichier CSS contenant des styles qui viennent remplacer les styles SharePoint par défaut.

Pour rendre la nouvelle interface utilisateur plus rapide et plus fluide, SharePoint 2013 apporte des modifications fondamentales au niveau de l'implémentation des feuilles de style CSS :

La taille des fichiers CSS est réduite.
L’imbrication des sélecteurs CSS est limitée.
L’héritage CSS est utilisé dès que possible.
Les classes sont définies en un seul endroit.
Les classes liées sont regroupées dans le fichier CSS.
Les styles inline et la déclaration !important ne sont pas utilisés, car ils ne peuvent pas être remplacés.
Les styles utilisent une structure cohérente et une convention d’affectation de noms.

Dans SharePoint 2013, les styles utilisent une structure cohérente et une convention d'affectation de noms.

PARTIE DE LA DÉNOMINATION	ms	<FONCTIONNALITÉ> -	<NOM>
Explication	Indique qu’il s’agit d’une classe Microsoft.	Le nom de la fonctionnalité à laquelle est associé cet élément, ou « principal » s'il est utilisé en tant qu'élément de l'interface utilisateur principale.	Un nom descriptif de l’élément, par exemple le titre, lien, etc.

En raison de ces modifications dans la façon dont SharePoint 2013 implémente les CSS, lors d'une mise à niveau, les styles CSS personnalisés ne seront pas appliqués à votre site. Pour résoudre ce problème, vous devez tout d'abord créer une collection de sites d'évaluation, puis utiliser ce site en tant qu'environnement dans lequel vous pouvez identifier les nouveaux styles SharePoint 2013 que vous devez remplacer. Créez un fichier CSS pour ces styles et appliquez ces CSS à votre site mis à niveau.

Thème personnalisé

Dans Produits SharePoint 2010, vous pouvez utiliser un programme Office tel que PowerPoint 2010 pour créer un fichier THMX. Vous pouvez ensuite télécharger ce fichier de thème vers Produits SharePoint 2010 et appliquer ce thème à votre site.

Dans SharePoint 2013, le moteur de thème a été amélioré pour que les thèmes soient plus rapides et plus souples, et pour que les thèmes puissent être plus facilement mis à niveau par la suite. Le modèle de thèmes utilise le balisage de style commentaire dans la feuille de styles CSS, puis remplace les éléments de la feuille de styles CSS en fonction des paramètres, tels que les polices et les couleurs, sélectionnés par les utilisateurs. Les thèmes dans SharePoint 2013 sont définis par les fichiers XML :

SPColor.xml définit la palette de couleurs, dans laquelle les emplacements ont maintenant des noms sémantiques afin qu'apparaissent plus clairement les éléments d'interface utilisateur qui sont affectés lorsque vous modifiez une valeur de couleur. En outre, les thèmes prennent désormais en charge la définition de l'opacité.
SPFont.xml définit le jeu de polices et prend en charge plusieurs langues, polices web et polices adaptées au web.

Mais il n'existe aucune prise en charge pour la mise à niveau d'un fichier THMX à partir de Produits SharePoint 2010 vers SharePoint 2013. Si vous avez appliqué un thème personnalisé pour le site Produits SharePoint 2010, lorsque vous effectuez une mise à niveau vers SharePoint 2013, les fichiers de thème restent en place. Mais le thème n'est plus appliqué au site et celui-ci adopte le thème par défaut.

Pour résoudre ce problème, vous devez tout d'abord créer une collection de sites d'évaluation, puis utiliser les nouvelles fonctionnalités de thème disponibles dans SharePoint 2013 pour recréer le thème. Pour plus d'informations sur les nouveaux thèmes, consultez les articles suivants sur MSDN :

Importante

Plus tard, si vous souhaitez utiliser une personnalisation, et si vous voulez que cette personnalisation fonctionne après les prochaines mises à niveau, nous vous recommandons d’utiliser des thèmes pour implémenter votre conception. Les thèmes bénéficieront d'une prise en charge de mise à niveau lorsque les futures mises à jour seront disponibles. Si les thèmes ne fonctionnent pas pour votre scénario ou si votre personnalisation doit être étendue, nous vous recommandons d'utiliser un site de publication avec le Gestionnaire de conception. Toutefois, notez que si vous vous lancez dans la création de pages maîtres et de mises en page personnalisées, il se peut que vous deviez recréer ou mettre à jour vos fichiers de conception pendant et après chaque mise à niveau de SharePoint.

Copier et modifier une page maître fournie avec SharePoint 2013

Dans Produits SharePoint 2010, une façon courante d'apporter des personnalisations mineures à l'interface utilisateur consiste à copier et modifier une page maître qui est fournie avec Produits SharePoint 2010. Par exemple, vous pouvez modifier la page maître pour supprimer ou masquer des fonctionnalités aux utilisateurs.

Lorsque vous mettez à niveau un site Produits SharePoint 2010 vers SharePoint 2013, la page maître est réinitialisée pour utiliser la page maître par défaut dans SharePoint 2013. Par conséquent, après la mise à niveau, votre site affiche sa personnalisation. La page maître personnalisée qui a été créée dans Produits SharePoint 2010 est toujours présente dans le site, mais vous ne devez pas appliquer l'ancienne page maître sur le nouveau site, car ce dernier ne s'affichera pas comme prévu.

Pour prendre en charge la nouvelle interface utilisateur dans SharePoint 2013, des modifications ont été apportées aux pages maîtres par défaut. Pour cette raison, vous ne pouvez pas appliquer une page maître qui a été créée dans Produits SharePoint 2010 à un site dans SharePoint 2013.

Pour résoudre ce problème, vous devez tout d'abord créer une collection de sites d'évaluation, puis créer à nouveau la page maître dans le site SharePoint 2013. Après avoir vérifié que la nouvelle page maître fonctionne comme prévu, déplacez-la vers la nouvelle collection de sites et appliquez-la au site. Si les sites sont des sites de publication, vous pouvez utiliser le Gestionnaire de conception pour exporter, puis importer la page maître en tant qu’élément d’un package de conception. Dans le cas contraire, vous pouvez déplacer la page maître en tant qu’élément d’une solution bac à sable (sandbox) ou via le téléchargement du fichier vers la galerie de pages maîtres.

Importante

SharePoint Foundation 2013 ne prend pas en charge les sites de publication. Vous avez besoin de SharePoint 2013 pour utiliser les sites de publication.

Page maître personnalisée dans un site de publication

Si vous souhaitez un site entièrement personnalisé tel qu’un site intranet pour les communications au sein de l’entreprise, utilisez un site de publication avec une page maître entièrement personnalisée et des mises en page personnalisées attachées à cette page maître.

Lorsque vous mettez à niveau un site Produits SharePoint 2010 vers SharePoint 2013, la page maître est réinitialisée pour utiliser la page maître par défaut dans SharePoint 2013. Par conséquent, après la mise à niveau, votre site n'affiche pas sa personnalisation. La page maître et les mises en page personnalisées créées dans Produits SharePoint 2010 existent toujours dans le site, mais vous ne devez pas appliquer l'ancienne page maître sur le nouveau site, car le nouveau site ne s'affichera pas comme prévu.

Pour résoudre ce problème, vous devez tout d'abord créer une collection de sites d'évaluation, qui est un site de publication, puis créer à nouveau la page maître dans le site SharePoint 2013. Après avoir vérifié que la nouvelle page maître fonctionne comme prévu, procédez comme suit :

Exportez la page maître en tant qu’élément d’un package de conception.
Importez le package de conception dans la nouvelle collection de sites.
Appliquez la nouvelle page maître au site.

Espaces réservés de contenu personnalisés sur une page maître personnalisée

Importante

Si votre page maître personnalisée contient un espace réservé de contenu personnalisé et que des mises en pages personnalisées contiennent également cet espace réservé de contenu personnalisé, une erreur risque d'empêcher l'affichage de la page d'accueil de votre site après la mise à niveau. Le message d'erreur « Une erreur inattendue s'est produite » risque de s'afficher.

Pour déterminer si vous avez ce problème, vous pouvez créer une collection de sites d'évaluation qui est également un site de publication, puis définissez la page maître sur celle qui est fournie avec SharePoint 2013. Si le site s'affiche toujours, vous n'avez pas ce problème. Si le site ne s'affiche pas et que vous obtenez une « erreur inattendue » avec un ID de corrélation, vous rencontrez probablement ce problème.

Pour résoudre ce problème, procédez comme suit :

Créez une collection de sites d’évaluation qui est une collection de sites de publication.
Créez une page maître SharePoint 2013.
Ajoutez l’espace réservé de contenu personnalisé à la page maître 2013.
Appliquez la nouvelle page maître au site.
Créez une mise en page qui ne contient pas l’espace réservé de contenu personnalisé.

La mise en page sera associée à la nouvelle page maître qui a été appliquée au site.
Modifiez toutes les pages qui utilisent l’ancienne mise en page de sorte qu’elles utilisent la nouvelle mise en page.

Vous pouvez manuellement modifier chaque page individuellement dans le navigateur et utiliser l’option du ruban, ou vous pouvez utiliser le modèle objet côté client pour SharePoint afin de mettre à jour les pages par programme.
Supprimez l’ancienne mise en page qui contient l’espace réservé de contenu personnalisé.