Fichiers de définition de mise à niveau
Dernière modification : mardi 6 avril 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Comment SharePoint Foundation choisit entre plusieurs définitions de mise à niveau
Application de la mise à niveau de définition de site
Références d'assembly
Packs de langue et définition de mise à niveau de site
Une définition de mise à niveau de site fournit un moyen de transformer des sites personnalisés dans une version antérieure du produit SharePoint pour leur permettre de tirer parti des nouvelles fonctionnalités disponibles dans la dernière version. Un fichier de définition de mise à niveau mappe (ou « met en relation ») les données des fichiers et des listes d’une build ou d’une version avec une build ou une version d’une génération suivante, et spécifie des éléments supplémentaires qui doivent être inclus dans un site Web mis à niveau.
Vous pouvez inscrire une définition de mise à niveau pour une définition de site en lui donnant un nom de fichier unique, commençant généralement par le nom de la définition de site, et en la plaçant dans le dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config\Upgrade du répertoire d’installation. Les définitions de mise à niveau de site sont inscrites pour chaque définition de site, mais il peut exister plusieurs définitions de mise à niveau pour la même définition de site. Une définition de mise à niveau de site inclut également la liste des modèles de mise à niveau de liste, qui décrivent comment les colonnes particulières d’une liste sont mappées aux types de contenu dans la nouvelle version de SharePoint Foundation 2010.
Un bon moyen pour comprendre les définitions de mise à niveau consiste à examiner les fichiers de définition de mise à niveau qui figurent dans une installation de SharePoint Foundation ; ils se trouvent dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config\Upgrade. Ce répertoire inclut deux modèles de mise à niveau : un modèle pour la mise à niveau de la version précédente vers la version actuelle et un modèle pour la mise à niveau entre les builds de SharePoint Foundation vers sa version finale.
Comment SharePoint Foundation choisit entre plusieurs définitions de mise à niveau
Pour déterminer si un site peut être mis à niveau, SharePoint Foundation utilise l'algorithme suivant pour choisir la définition de mise à niveau à utiliser quand plusieurs définitions sont disponibles :
Si le site Web ne correspond pas à la version du produit actuelle, SharePoint Foundation choisit une définition de mise à niveau qui effectue la mise à niveau pour les versions successives du produit et met à jour le site vers la version la plus récente du modèle. Les définitions de mise à niveau effectuent des actions de mise à niveau à travers les versions ou à travers les modèles, mais pas les deux : cela signifie que les attributs FromProductVersion et BeginFromSchemaVersion/EndFromSchemaVersion ne peuvent pas être définis tous les deux pour une même définition. Si un site Web ne correspond pas à la version du produit actuelle et qu’aucune définition de mise à niveau ne peut effectuer la mise à niveau du site Web entre les différentes versions, le site Web ne peut pas être mis à niveau.
Si la condition 1 ne s’applique pas, SharePoint Foundation choisit une définition de mise à niveau dans laquelle la valeur de l’attribut ToSchemaVersion correspond au mieux à la version de modèle actuelle de la définition de site (sans aller au-delà), et dans laquelle la version du modèle de l’instance de site existante se trouve dans la plage comprise entre BeginFromSchemaVersion et EndFromSchemaVersion.
Si plusieurs définitions de mise à niveau satisfont aux critères de la condition 2, SharePoint Foundation choisit la définition de mise à niveau dont la valeur de BeginFromSchemaVersion est la plus élevée.
S’il existe à la fois une langue générique et un modèle de paramètres régionaux spécifiques pour une définition de site spécifiée, SharePoint Foundation choisit le modèle de paramètres régionaux spécifiques.
Application de la mise à niveau de définition de site
SharePoint Foundation utilise une définition de mise à niveau pour configurer des sites convertis. Le processus d’application d’une mise à niveau de définition de site doit effectuer des substitutions pour les éléments par défaut, comme suit :
Si les nœuds de navigation pour une définition de site n’ont pas été modifiés, les nœuds de navigation existants d’une version antérieure sont supprimés et remplacés par des nœuds de navigation de la définition de site de la version actuelle.
La section <ListTemplates> d’un fichier Onet.xml ou Feature.xml détermine les modèles de liste à partir desquels un choix est effectué sur la page Créer. Lorsqu’une définition de mise à niveau de site est appliquée, SharePoint Foundation utilise l’ensemble des modèles de liste de la version actuelle du fichier Onet.xml ou Feature.xml, et non pas des fichiers de la version précédente, pour déterminer l’ensemble des modèles de liste.
De même, après la mise à niveau, SharePoint Foundation utilise la section <DocumentTemplates> du nouveau fichier Onet.xml pour déterminer l’ensemble de modèles de documents libres qui sont disponibles, au lieu de l’ensemble de fichiers <DocumentTemplate> de la version précédente.
Notes
Il est recommandé d’associer la plupart des modèles de documents à des types de contenu et de ne pas les laisser libres.
Par défaut, lors de la mise à niveau d’un site Web existant, une mise à niveau de définition de site ne configure pas les modules ou les instances de listes à partir de la nouvelle définition de site. SharePoint Foundation s’appuie sur un ensemble d’éléments <File> pour spécifier comment les fichiers d’une version précédente seront mappés à la version actuelle ; il s’appuie également sur un ensemble de balises de modules et d’instances de listes dans la définition de mise à niveau qui spécifient des fichiers et des données de liste différentiels de la version antérieure à la version actuelle.
L’utilisation d’une définition de mise à niveau permet la mise à niveau cohérente d’un site Web pour lui permettre d’utiliser des types de contenu, des formulaires, des listes et des pages de remplacement. S’il n’existe pas de définition de mise à niveau disponible, SharePoint Foundation met à niveau les sites Web basés sur la version de produit antérieure, en donnant autant que possible la priorité à la migration des données et à l’interopérabilité, au détriment de l’exposition potentielle de Composants fonctionnels de la version actuelle (telles que les types de contenu) aux utilisateurs. Il s’agit de l’état par défaut de tous les sites Web après que les tâches principales de mise à niveau de version à version (par exemple les transformations de base de données) ont été configurées.
Références d'assembly
Le fichier web.config contient des redirections de stratégie qui mappent les versions antérieures des assemblys du produit (tels que les assemblys Microsoft.SharePoint.dll dans Windows SharePoint Services 3.0), vers leurs équivalents dans la version du produit actuelle (la plus récente).
Packs de langue et définition de mise à niveau de site
Dans la mise à niveau de version à version, si un module linguistique de version antérieure particulier est installé mais que l’équivalent dans la version actuelle n’est pas installé avant la mise à niveau, le journal de mise à niveau enregistre des erreurs. L’opération de mise à niveau est néanmoins effectuée.
Voir aussi
Concepts
Approches architecturales de la mise à niveau d’une définition de site
Mise à niveau d’une définition de site personnalisée