Mise à niveau d’une définition de site personnalisée

Dernière modification : mardi 6 avril 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Mise à jour des pages ASPX
Modification du fichier Onet.xml
Considérations finales

Dans les versions antérieures de SharePoint Foundation, de nombreux types de personnalisation nécessitaient la personnalisation des définitions de site, qui impliquait généralement la copie de la définition de site STS et la modification des schémas de liste, des pages et d’autres éléments structurels dans la copie de la définition. Des parties importantes de la définition de site personnalisée n’étaient pas personnalisées, ce qui signifie qu’elles conservaient la plupart des caractéristiques de base de la définition de site STS.

La méthode permettant d’obtenir un équivalent actuel pour une définition de site personnalisée d’une version antérieure varie en fonction de la définition de site et des types de personnalisation que vous avez effectués. Si vous n’avez pas beaucoup personnalisé la définition de site par rapport à la définition de site sur laquelle elle reposait, la meilleure solution peut être de créer un équivalent actuel pour cette définition de site et de moderniser la nouvelle définition afin d’inclure les personnalisations antérieures. Par exemple, si votre seule personnalisation d’une définition de site d’une version antérieure consistait à utiliser un Composant fonctionnel pour ajouter une liste personnalisée ou à personnaliser la page Default.aspx pour personnaliser l’apparence, vous devez probablement utiliser la définition de site de la version actuelle comme base de la nouvelle définition de site personnalisée et mettre à niveau votre Composant fonctionnel (voir Mise à niveau des fonctionnalités). Toutefois, si vos personnalisations étaient plus poussées, il vaut mieux convertir la définition de site antérieure en un équivalent pour la définition de site actuelle. Le reste de cette rubrique explique comment faire pour convertir une définition de site personnalisée de la version antérieure en définition de site de la version actuelle.

Mise à jour des pages ASPX

Lors de l’hébergement d’un site Web basé sur une définition de site de la version antérieure, SharePoint Foundation exécute les pages dans un mode de compatibilité pour garantir leur fonctionnement dans le déploiement. Toutefois, lorsque vous exécutez des pages d’une définition de site de la version actuelle, SharePoint Foundation ne les exécute pas en mode de compatibilité pour des raisons de performance. C’est pourquoi, lorsque vous créez votre définition de site SharePoint Foundation, vous devez modifier vos pages Microsoft ASP.NET dans une certaine mesure.

Si vous n’avez pas personnalisé les pages ASPX dans votre définition de site de la version antérieure, il est conseillé de copier la page Default.aspx de la définition de site de la version actuelle. Par exemple, si le site reposait sur une définition de site personnalisée initialement basée sur la définition de site STS, cette page se trouve dans le dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\SiteTemplates\sts\xml.

Toutes les pages de composants WebPart doivent contenir un gestionnaire de composants WebPart ASP.NET pour fonctionner correctement. Par conséquent, si vous avez personnalisé les pages ASPX, vous devez ajouter un gestionnaire de composants WebPart à celles-ci, en insérant <WebPartPages:SPWebPartManager id="m" runat="Server" /> dans les pages.

Modification du fichier Onet.xml

La structure du fichier Onet.xml a été modifiée de manière fondamentale. Si vous n’avez pas personnalisé le fichier Onet.xml dans votre définition de site personnalisée de la version antérieure, il est conseillé de copier le fichier Onet.xml de la version actuelle situé dans le dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\SiteTemplates\sts\xml dans votre définition de site.

Dans SharePoint Foundation, tous les fichiers XML du répertoire d’installation utilisent des expressions de ressource ($Resources) afin qu’ils fonctionnent dans n’importe quelle langue pour laquelle les modules linguistiques ont été installés. Pour qu’une définition de site de la version antérieure fonctionne pour plusieurs langues, et pour bénéficier de cette utilisation étendue de ressources, vous devez apporter plusieurs modifications dans les fichiers XML de la version antérieure. Dans ce cas, il est préférable de copier la définition de site de la version actuelle et d’y ajouter vos personnalisations.

Si vous avez personnalisé le fichier Onet.xml dans une définition de site de la version antérieure, vous devez modifier le fichier pour utiliser la version actuelle. Les étapes de base suivantes peuvent vous aider à améliorer la cohérence d’un fichier Onet.xml antérieur avec une définition de site actuelle.

1. Pour vous assurer que les sites Web créés à l’aide de votre définition utilisent les types de liste de base SharePoint Foundation actuels de façon cohérente, supprimez la section <BaseTypes> du fichier Onet.xml. Les types de liste de base sont inclus par défaut dans les sites SharePoint Foundation et vous n’avez pas besoin de les définir dans votre fichier.

2. Supprimez les listes standard éventuellement présentes du fichier Onet.xml de la version antérieure. Nombre de listes qui étaient nécessaires aux fonctionnalités de SharePoint sont désormais incluses par défaut dans SharePoint Foundation et il n’est pas nécessaire de les définir dans votre fichier Onet.xml. Pour plus d’informations, voir Mise à niveau des définitions de liste standard.

3. Si elle est présente, supprimez la balise <ListTemplate> des listes pour lesquelles l’attribut Name a la valeur webtemp, listtemp, wplib ou datasrcs. Supprimez aussi les définitions de liste sous-jacentes éventuellement présentes pour ces listes en supprimant les dossiers LISTS\WEBTEMP, LISTS\LISTTEMP, LISTS\wplib et LISTS\DATASRCs. Supprimez les balises <List> de la section <Configurations> dans laquelle l’attribut Type a la valeur 113 (galerie de modèles Web), 114 (galerie de modèles de listes) ou 111 (galerie de composants WebPart).

4. Envisagez le mappage de la section <DocumentTemplates> sur les modèles de document actuels. Le système d’expression des modèles de document dans une définition de site n’a pas changé de manière significative d’une version à l’autre et les modèles de document sont toujours stockés dans un répertoire par paramètres régionaux.

Pour votre définition de site, vous devez veiller à disposer du jeu de modèles de document correspondant dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\<Identificateur de paramètres régionaux>\<nom de définition du site>. Toutefois, si vos fichiers ne sont pas personnalisés, il est possible que votre définition de site réutilise les modèles de document. Pour ce faire, annotez les nœuds <DocumentTemplate> dans votre fichier Onet.xml pour spécifier Path="STS".

Considérations finales

Une fois que vous avez personnalisé votre définition de site, testez-la dans SharePoint Foundation 2010 pour vous assurer que les sites Web sont créés par le biais de la fonction de définition comme prévu. Après avoir créé la définition de site SharePoint Foundation appropriée, l’étape suivante consiste à créer une définition de mise à niveau pour mapper votre définition de site depuis la version antérieure sur la version actuelle.

Voir aussi

Concepts

Mise à niveau des définitions de liste standard

Autres ressources

Mise à niveau de SharePoint Foundation