SharePoint 2013 : Attention au répertoire virtuel _layouts

 Tout gestionnaire d’environnement SharePoint connaît ce répertoire virtuel “_layouts” utilisé pour les contenus mutualisés dans la ferme. Ainsi les images et objets de style de base de SharePoint sont disponibles directement depuis des adresses du type :

• http://mySharePointWebApp/_layouts/images/SEARCH.PNG

Ou encore en depuis tout point d’un site :

• http://mySharePointWebApp/sites/mySiteCollection/_layouts/images/SEARCH.PNG

Ce type d’adresse fonctionne parfaitement pour SharePoint 2003, 2007 et 2010. En revanche pour la version 2013, il y a une petite astuce du fait du changement de version entre 2010 et 2013.

Ainsi, comme nous l’avons vu dans les précédent messages sur la migration, SharePoint 2013 supporte de manière native le design de SharePoint 2010 alors que son design propre est totalement différent.

Pour effectuer cette astuce, sans tout casser, Microsoft a choisi d’ajouter une subtilité, le sous répertoire virtuel qui pointe vers un nouveau point de stockage des serveurs.

Ainsi dans IIS, on trouve bien le répertoire de base “_layouts” et ses sous-répertoires virtuels qui pointent vers les répertoires physique tels que :

• /_layouts/ : C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\template\layouts\
• /_layouts/images/ : C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\template\images\

On comprend par le chemin du répertoire physique, que cette URL est uniquement pour les sites sous le design SharePoint 2010.

Pour SharePoint 2013, tout se passe dans un nouveau sous-répertoire virtuel, le “15” (et non Renaud, pas le 15 de France).

Ce nouveau répertoire contient donc aussi un autre sous-répertoire virtuel pour les images pointant vers le chemin physique :

• /_layouts/15/ : C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\15\template\layouts\
• /_layouts/15/images/ : C:\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\IMAGES\

Ainsi, il faut vraiment faire attention dans vos applications ou personnalisations pour pointer dans le bon répertoire virtuel, sous peine de ne pas avoir le bon rendu et chercher des heures pourquoi.

Lien annexe :

• http://yalla.itgroove.net/2013/02/sharepoint-2013-_layouts15-vs-_layouts-folder-differences/

Romelard Fabrice [MVP] - MBA Risk Management