Utilisation du modèle objet Migration de contenu
Dernière modification : vendredi 2 octobre 2009
S’applique à : SharePoint Foundation 2010
En règle générale, les scénarios pour la migration de contenu appartiennent à l'une des catégories suivantes :
Déplacer le contenu d'une collection de sites d'un emplacement vers un autre.
Migrer uniquement les fichiers de contenu sélectionnés d'un site vers un autre en fonction de critères spécifiés.
Exporter du contenu dans le but d'y appliquer des traitements, puis le réimporter.
Synchroniser des serveurs
Quel que soit le scénario, les étapes de base sont cependant les mêmes. Voici les principales étapes effectuées dans une opération standard de migration, ainsi que quelques liens vers les membres du modèle objet concernés, qui permettent d'obtenir plus d'informations.
La première étape consiste à décider du contenu que vous voulez d'exporter. Vous utilisez la classe SPExportSettings pour définir ces valeurs pour votre opération d'exportation.
Déterminez les objets à migrer.
À l'aide du modèle objet de migration de contenu, vous pouvez exporter une collection de sites Web, une liste, une bibliothèque, un dossier, un fichier ou un élément de liste.
Pour plus d'informations, voir la classe SPExportObjectCollection.
Déterminez la quantité de données d'un objet que vous souhaitez exporter. Par défaut, l'ensemble des données d'un objet et ses dépendances sont exportées. Toutefois, vous pouvez choisir d'exporter uniquement des modifications incrémentielles.
Pour exporter des modifications incrémentielles, vous devez décider s'il faut exporter des données sur une des bases suivantes :
Une date particulière.
Des modifications apportées à un fichier depuis cette dernière exportation (à l'aide du journal des modifications de SharePoint Foundation)
Pour plus d'informations, voir la propriété ExportMethod.
Identifiez un emplacement pour le fichier de sortie (le fichier *.cmp, également appelé content migration package).
Pour plus d'informations, voir les propriétés BaseFileName et FileLocation.
Déterminez les métadonnées que vous souhaitez inclure lors de l'exportation des données. Par exemple, quel type d'informations de contrôle de version voulez-vous exporter (la version par défaut est la dernière version principale) ? Voulez-vous exporter des informations sur les utilisateurs et les groupes (aucune de ces informations n'est incluse par défaut) ?
Pour plus d'informations, voir les propriétés IncludeVersions et IncludeSecurity.
Vous pouvez fixer des limites de taille pour vos fichiers de package (.cmp) de migration de contenu. Si les fichiers de contenu dans une opération de migration dépassent la limite de taille spécifiée, l'opération crée automatiquement des fichiers .cmp supplémentaires, le cas échéant.
Pour plus d'informations, voir la propriété FileMaxSize.
Indiquez comment gérer les avertissements et les erreurs au cours de l'opération d'exportation (par défaut, l'opération d'exportation ne s'arrête pas lorsqu'elle rencontre un avertissement ou une erreur récupérable).
Pour plus d'informations, voir les propriétés HaltOnNonfatalError et HaltOnWarning.
Une fois ces décisions prises et après avoir défini les valeurs dans la classe SPExportSettings, passez-la en tant que paramètre à SPExport, puis exécutez la tâche d'exportation.
Une fois l'exportation terminée, un package de migration de contenu est créé à l'emplacement que vous avez défini dans SPExportSettings. Il se compose d'un ensemble de fichiers qui contiennent le contenu inclus dans l'opération d'exportation et les métadonnées qui décrivent la structure du contenu.
Tout comme vous avez défini des paramètres pour l'exportation dans l'objet SPExportSettings, vous définissez maintenant des valeurs dans l'objet SPImportSettings pour l'importation.
Déterminez les métadonnées à inclure lors de l'importation des données. Par exemple :
Comment voulez-vous que les informations de contrôle de version apparaissent (par défaut, les versions sont ajoutées aux fichiers sur l'emplacement de destination) ?
Pour plus d'informations, voir la propriété UpdateVersions.
Voulez-vous que les objets conservent leur GUID d'origine (l'identité de l'objet n'est pas conservée par défaut) ?
Pour plus d'informations, voir la propriété RetainObjectIdentity.
Important
Utilisez cette propriété avec précaution, car les bases de données ne permettent pas les GUID en double. Cette propriété sert généralement dans le cas de deux sites Web qui sont des images miroir l'un de l'autre ou, dans un scénario de publication, pour indiquer si un fichier sur un ordinateur est le même que sur un autre ordinateur.
Cette fonctionnalité est disponible seulement dans le modèle objet. Vous ne pouvez pas conserver les GUID à l'aide de Stsadm.exe ou du [Sites Web service]Web service.
Indiquez comment gérer les avertissements et les erreurs au cours de l'opération d'importation (par défaut, l'opération d'importation ne s'arrête pas lorsqu'elle rencontre un avertissement ou une erreur récupérable).
Pour plus d'informations, voir les propriétés HaltOnNonfatalError et HaltOnWarning.
Une fois ces décisions prises et après avoir défini les valeurs dans la classe SPImportSettings, passez-la en tant que paramètre à SPImport, et exécutez la tâche d'importation.
Voir aussi
Tâches
Procédure : effectuer une migration d'un site Web d'un emplacement vers un autre emplacement
Concepts
Vue d'ensemble de la migration de contenu
Migration des informations de sécurité