Cette documentation est archivée et n’est pas conservée.

Migration de contenu : importation de contenu

Windows SharePoint Services 3

La migration de contenu se déroule en deux étapes. Tout d'abord, vous exportez le contenu à partir de la source vers un package de migration, puis vous importez ce package de migration vers la destination.

Vue d'ensemble de l'opération d'importation

Le diagramme ci-dessous illustre le flux conceptuel d'une opération d'importation typique utilisant les API de migration dans l'espace de noms de déploiement. À première vue, l'importation d'un contenu est simplement l'opération inverse de l'exportation. Ceci dit, il y a un flux plus complexe et un plus grand nombre de décisions au cours d'une opération d'importation.

Migration sélective : diagramme de l'exportation
Importer le diagramme de flux des opérations

Lorsque vous spécifiez vos paramètres d'importation (SPImportSettings), assurez-vous qu'ils correspondent aux paramètres d'exportation associés (SPExportSettings). Par exemple, si la propriété FileCompression de l'objet SPExportSettings a la valeur true, la propriété FileCompression correspondante de l'objet SPImportSettings doit également avoir la valeur true.

Le flux du processus présente les points de décision, où le flux crée des branches. La première décision à prendre concerne la conservation ou non de l'identité de vos objets. La valeur de cette propriété détermine si l'objet d'importation est détecté par son GUID (si l'identité des objets est conservée) ou par URL. (Pour plus d'informations sur l'identité des objets et d'autres concepts de la migration, voir Concepts clés de la migration sélective.)

La décision suivante porte sur la réaffectation des parents. Si l'objet est au niveau supérieur de la hiérarchie et si vous ne conservez pas l'identité des objets, vous devez réaffecter un objet parent. En revanche, s'il ne s'agit pas d'un objet du niveau supérieur et que vous ne conservez pas l'identité des objets, cette réaffectation n'est pas nécessaire.

Si l'opération ne trouve pas l'objet d'importation, un nouveau est créé. Toutefois, si l'objet est trouvé et que vous le déplacez simplement (comme dans une opération de copie/déplacement), l'opération affecte une nouvelle URL à l'objet. S'il s'agit d'une mise à jour (d'un fichier par exemple), l'opération conserve l'URL d'origine.

Propriétés des paramètres d'importation (SPImportSettings)

La classe SPDeploymentSettings sert de classe de base d'où sont dérivées SPExportSettings et SPImportSettings. Ses membres se retrouvent donc dans ces deux classes dérivées, tandis que la classe SPImportSettings contient des membres spécifiques, liés à l'importation.

Les propriétés de la classe Microsoft.SharePoint.Deployment.SPImportSettings, ainsi que celles de la classe de base, se classent en quatre groupes :

  • Obligatoires : paramètres de propriété obligatoires pour l'importation.

  • Importants : paramètres de propriété extrêmement importants, à ne pas oublier dans la planification de l'importation.

  • Spécifiques : paramètres de propriété spécifiquement liés aux opérations d'importation dans une migration sélective.

  • Mineurs : paramètres de propriété mineurs ou rarement utilisés.

Paramètres d'importation obligatoires

  • WebId

    Définit ou récupère un GUID qui identifie le site de destination pour l'importation.

  • WebId

    Définit ou récupère une URL qui situe le site de destination pour l'importation.

  • BaseFileName (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Définit ou récupère le nom du ou des fichiers de package de migration de contenu (fichier .cmp). Ceux-ci consistent en un ou plusieurs fichiers .cab (avec l'extension .cmp). La valeur provient du paramètre baseFileName du constructeur de classe SPDeploymentSettings (SPDeploymentSettings).

    Lorsqu'il y a plusieurs fichiers .cmp, un numéro est ajouté à leur nom. Par exemple, si le paramètre baseFileName est « MyWeb » et que l'exportation produit plusieurs fichiers .cmp, les packages de migration portent les noms « MyWeb1.cmp », « MyWeb2.cmp », et ainsi de suite.

  • SiteUrl (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Définit ou récupère l'URL de la collection de sites de destination lors de l'importation. La valeur est une URL absolue sur le site. Cette valeur est fournie dans le paramètre siteUrl du constructeur de classe SPDeploymentSettings (SPDeploymentSettings).

  • FileLocation (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Définit ou récupère le chemin du fichier et l'emplacement du répertoire où sont placés le ou les packages de migration de contenu au niveau de la destination de l'importation. Cette valeur est fournie dans le paramètre fileLocation du constructeur de classe SPDeploymentSettings (SPDeploymentSettings).

Paramètres d'importation importants

  • UserInfoDateTime

    Définit ou récupère une valeur à partir de l'énumération SPImportUserInfoDateTimeOption qui spécifie le niveau d'informations utilisateur à conserver lors de l'importation. Les valeurs admises sont les suivantes :

    • ImportAll : conserve toutes les informations originales sur le créateur et les auteurs de modifications, y compris l'horodatage et les valeurs de recherches de l'utilisateur.

    • None : (par défaut) remplace les données sur le créateur et les auteurs de modifications par le compte système ; crée un horodatage actuel (moment de l'importation) et remplace les valeurs de recherches de l'utilisateur par une chaîne vide ("").

    • ReplaceUserWithSystemAccount : conserve l'horodatage original, mais remplace les données sur le créateur et les auteurs de modifications par le compte système et remplace les valeurs de recherches de l'utilisateur par une chaîne vide ("").

    La valeur par défaut est None.

  • UpdateVersions

    Définit ou récupère une valeur à partir de l'énumération SPUpdateVersions qui spécifie la gestion des informations de version à l'importation :

    • Append : ajoute des versions d'éléments lors de l'importation.

    • Overwrite : supprime l'élément existant lors de l'importation, puis réinsère la version importée.

    • Ignore : ignore la gestion des versions.

  • CommandLineVerbose (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Récupère ou définit une valeur booléenne qui indique si vous souhaitez que les informations sur la migration soient affichées sur une console de ligne de commande. La valeur par défaut est false.

  • FileCompression (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Récupère ou définit une valeur booléenne qui indique si le package de migration de contenu doit être compressé à l'aide du protocole de compression CAB. La valeur par défaut est true ; autrement dit, par défaut le package de migration de contenu est compressé.

    Le paramètre d'importation de cette propriété doit correspondre à celui fourni dans la propriété SPExportSettings.FileCompression.

  • IncludeSecurity (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Récupère ou définit une valeur d'énumération SPIncludeSecurity qui spécifie la quantité de rôles de sécurité d'utilisateur et de données d'appartenance aux rôles à inclure dans le package de migration. L'énumération fournit trois options : All, None et WssOnly. La valeur sélectionnée doit correspondre à celle fournie dans la propriété SPExportSettings.IncludeSecurity.

  • LogFilePath (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Récupère ou définit une valeur qui spécifie le chemin d'accès complet au fichier journal pour l'opération de migration de contenu.

Paramètres d'importation sélectifs liés à la migration

  • RetainObjectIdentity

    Définit ou récupère une valeur booléenne qui indique s'il faut conserver les GUID des objets au cours de l'importation. La valeur true fait que l'importation conserve les GUID des objets ; la valeur par défaut est false.

    SPImportSettings.RetainObjectIdentity est l'élément essentiel de la migration sélective, dont le concept de base est l'importation de versions mises à jour des fichiers existants. Au niveau de la destination, le seul moyen de savoir si un élément est une version mise à jour d'un élément existant consiste à comparer l'identité des objets à l'aide de leur GUID.

    Étant donné que les bases de données n'acceptent pas les GUID en double, restez vigilent si vous utilisez cette propriété. Elle n'est utile que dans les scénarios de migration sélective. De plus, pour prendre en charge la suppression de champ (c'est-à-dire la suppression des versions précédentes des éléments au niveau de la source de l'exportation lorsqu'ils sont mis à jour et la suppression du même fichier au niveau de la destination de l'importation), cette valeur doit être définie à true. Notez également que pour prendre en charge les migrations sélectives, vous devez définir la propriété ExportMethod avec la valeur de champ ExportChanges.

Paramètres d'importation mineurs

  • IgnoreWebParts

    Définit ou récupère une valeur booléenne qui détermine si l'opération d'importation ignore les composants WebPart associés à un fichier. Choisissez true pour désactiver l'importation des composants WebPart ; la valeur par défaut est false.

    Notez que cette propriété est utilisée principalement pour prendre en charge la fonctionnalité des variantes dans CMS.

  • SuppressAfterEvents

    Définit ou récupère une valeur booléenne qui détermine si l'opération de migration ignore les événements After qui se déclenchent lors de la création ou de la modification de fichiers ou d'éléments de liste. Choisissez true pour ignorer les événements After ; la valeur par défaut est false.

    La suppression de la gestion des événements After peut améliorer légèrement les performances lors de l'importation. De plus, même si les performances ne sont pas un facteur essentiel, le fait de choisir true contribue à éviter d'éventuels problèmes dus aux erreurs du gestionnaire d'événements.

  • HaltOnWarning (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Définit ou récupère une valeur booléenne qui indique s'il faut interrompre la migration en cas d'avertissement détecté. Choisissez false pour ignorer les avertissements et continuer la migration. La valeur par défaut est false.

  • HaltOnNonfatalError (hérité de Microsoft.SharePoint.Deployment.SPDeploymentSettings)

    Définit ou récupère une valeur booléenne qui indique s'il faut interrompre la migration si une erreur (non fatale) est détectée. Choisissez false pour ignorer les erreurs non fatales et continuer la migration. La valeur par défaut est false.

Voir aussi

Afficher: