Importer des éléments à partir d’un site SharePoint existantImport items from an existing SharePoint site

Le modèle de projet Importer le package de solution SharePoint vous permet de réutiliser des éléments tels que des types de contenu et des champs à partir de sites SharePoint existants dans une nouvelle solution SharePoint Visual StudioVisual Studio .The Import SharePoint Solution Package project template lets you reuse elements such as content types and fields from existing SharePoint sites in a new Visual StudioVisual Studio SharePoint solution. Vous pouvez exécuter la plupart des solutions importées sans aucune modification, mais il existe certaines restrictions et complications à prendre en compte, en particulier si vous modifiez des éléments après les avoir importés.Although you can run most imported solutions without modification, there are certain restrictions and issues to consider, especially if you modify any items after importing them.

Note

Pour importer des flux de travail réutilisables, utilisez le modèle de projet Importer le flux de travail réutilisable.To import reusable workflows, use the Import Reusable Workflow project template. Pour plus d'informations, voirFor more information, see Directives pour l’importation de flux de travail réutilisables. Guidelines for importing reusable workflows.

Solutions SharePoint prises en chargeSupported SharePoint solutions

Visual Studio 2012Visual Studio 2012 prend entièrement en charge l’importation de solutions créées dans SharePoint Foundation 2010SharePoint Foundation 2010 et SharePoint Server 2010SharePoint Server 2010. fully supports the importing of solutions created in SharePoint Foundation 2010SharePoint Foundation 2010 and SharePoint Server 2010SharePoint Server 2010.

Visual Studio 2012Visual Studio 2012 ne prend pas en charge l’importation de solutions créées dans les applications suivantes : does not support the importing of solutions created in the following applications:

  • Windows SharePoint Services 3,0Windows SharePoint Services 3.0

  • Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007

  • Visual Studio 2008Visual Studio 2008

  • Microsoft SharePoint Designer 2007Microsoft SharePoint Designer 2007

  • Visual Studio 2010Visual Studio 2010

    Bien que vous puissiez généralement importer des solutions créées par ces applications, cette fonctionnalité n’est ni testée, ni prise en charge.Although you can often successfully import solutions created by these applications, that functionality is not tested and not supported.

Élément restrictions à l’importationItem import restrictions

Bien que la plupart des éléments SharePoint peuvent être importées à partir d’un existant .wsp fichier, les éléments suivants ne sont pas prises en charge et peuvent nécessiter des modifications pour fonctionner correctement :Although most SharePoint items can be imported from an existing .wsp file, the following items are not supported and may require modifications to work correctly:

  • Entités BDCBDC entities

  • Éléments d’association de flux de travail de codeCode workflow association elements

  • Flux de travail de codeCode workflows

  • Composants Visual Web Parts (.ascx)Visual Web parts (.ascx)

  • Services Web (.asmx)Web services (.asmx)

  • Liaisons de type de contenuContent type bindings

  • Récepteurs d’événementsEvent receivers

  • Définitions de listes (modèles)List definitions (templates)

  • Définitions de sitesSite definitions

    Lorsque vous exportez une solution à partir de SharePoint Foundation 2010SharePoint Foundation 2010 ou SharePoint Server 2010SharePoint Server 2010, ces éléments sont automatiquement exclus de la .wsp fichier.When you export a solution from SharePoint Foundation 2010SharePoint Foundation 2010 or SharePoint Server 2010SharePoint Server 2010, these items are automatically excluded from the .wsp file. Toutefois, autres .wsp fichiers générés à partir des outils non pris en charge peuvent contenir ces éléments.However, other .wsp files generated from unsupported tools may contain these items. (Voir « Solutions SharePoint prises en charge » plus haut dans cette rubrique.)(See "Supported SharePoint Solutions" earlier in this topic.)

Que se passe-t-il lorsque vous importez une solutionWhat happens when you import a solution

Lorsque vous importez une solution avec le modèle Importer un Package de Solution SharePoint, Visual StudioVisual Studio copie tout le contenu de la .wsp fichier et tente de rapprocher et de conserver autant d’associations et les références entre importés éléments et leurs fichiers que possible.When you import a solution with the Import SharePoint Solution Package template, Visual StudioVisual Studio copies all of the contents of the .wsp file and tries to reconcile and retain as many associations and references between imported elements and their files as possible.

Tous les éléments importés sont copiés dans des dossiers correspondants dans l’ Explorateur de solutions.All imported items copy to corresponding folders in Solution Explorer. Par exemple, les types de contenu apparaissent sous le dossier Types de contenu et les instances de listes apparaissent sous Instances de listes.For example, content types appear under the folder Content types and list instances appear under List instances. Les fichiers associés à un élément importé sont également copiés dans le dossier de l’élément.Files associated with an imported item are also copied to the item's folder. Par exemple, une instance de liste importée comprend ses modules, formulaires et pages ASPX.For example, an imported list instance includes its modules, forms, and ASPX pages.

Éléments dépendantsDependent items

Si vous sélectionnez un élément dans l’Assistant Importer le package de solution SharePoint, mais pas ses éléments dépendants, une boîte de message vous signale que les éléments dépendants doivent aussi être sélectionnés avant l’importation.If you select an item in the Import SharePoint Solution Package wizard, but not its dependent items, a message box informs you that the dependent items must also be selected before importing.

Quelles sont les fonctionnalités ?What are features?

Les utilisateurs de SharePoint Designer peuvent observer la présence de fichiers inattendus, appelés fonctionnalités, dans leurs solutions importées dans l’ Explorateur de solutions.SharePoint Designer users may see unexpected files, called features, appear in their imported solutions in Solution Explorer. Les fonctionnalités existaient dans la solution SharePoint Designer, mais elles étaient masquées.Although features existed in the SharePoint Designer solution, they were hidden from view. Elles sont désormais visibles dans Visual StudioVisual Studio.Features are now visible in Visual StudioVisual Studio.

Les fonctionnalités sont des conteneurs d’éléments SharePoint.Features are containers for SharePoint items. Chaque fonctionnalité conserve une référence à chaque élément qu’elle contient, comme les types de contenu et les définitions de listes.Each feature keeps a reference to each item, such as content types and list definitions, that it contains. Lorsque vous importez votre solution, Visual StudioVisual Studio configure des fonctionnalités pour tous les éléments importés et tente de conserver les relations entre les fonctionnalités et les éléments pour les fichiers.When you import your solution, Visual StudioVisual Studio sets up features for all of the imported elements and attempts to maintain the feature-to-element relationships for the files. Tous les fichiers dont les références n’ont pas pu être résolues sont placés dans le dossier Autres fichiers importés .Any files whose references could not be resolved are put in the Other Imported Files folder.

Pour plus d’informations sur les fonctionnalités, consultez SharePoint de développer des solutions et utilisation des fonctionnalités.For more information about features, see Develop SharePoint solutions and Working with Features.

Traiter les cas spéciauxHandle special cases

Dans certains cas, Visual Studio ne peut pas rapprocher un élément de ses fichiers dépendants.In some cases, Visual Studio cannot reconcile an item with its dependent files. Tous les fichiers que Visual StudioVisual Studio n’a pas pu résoudre apparaissent sous le dossier Autres fichiers importés.Any files that Visual StudioVisual Studio could not resolve appear under the folder Other Imported Files. En outre, leurs propriétés DeploymentType prennent la valeur NoDeployment pour qu’ils ne soient pas déployés avec la solution.In addition, their DeploymentType properties are set to NoDeployment so that they are not deployed with the solution.

Par exemple, si vous importez la définition de liste ExpenseForms, une définition de liste portant ce nom s’affiche sous le liste de définitions dossier dans l’Explorateur de solutions avec son Elements.XML et Schema.xml fichiers.For example, if you import the list definition ExpenseForms, a list definition with that name appears under the List definitions folder in Solution Explorer along with its Elements.xml and Schema.xml files. Toutefois, ses formulaires ASPX et HTML associés peuvent être placés dans un dossier nommé ExpenseForms sous le dossier Autres fichiers importés .However, its associated ASPX and HTML forms may be placed in a folder called ExpenseForms under the Other Imported Files folder. Pour terminer l’importation, déplacez ces fichiers sous la définition de liste ExpenseForms dans l’ Explorateur de solutions et modifiez la propriété DeploymentType de chaque fichier de NoDeployment en ElementFile.To complete the import, move these files under the ExpenseForms list definition in Solution Explorer and change the DeploymentType property for each file from NoDeployment to ElementFile.

Lorsque vous importez des récepteurs d’événements, le Elements.xml fichier est copié vers l’emplacement correct, mais vous devez inclure manuellement l’assembly dans le package de solution afin qu’il soit déployé avec la solution.When importing event receivers, the Elements.xml file is copied to the correct location, but you must manually include the assembly in the solution package so that it deploys with the solution. Pour plus d'informations surFor more information about comment procéder, consultez Comment : ajouter et supprimer des assemblys supplémentaires. how to do this, see How to: Add and remove additional assemblies.

Quand vous importez des flux de travail, les formulaires InfoPath sont copiés dans le dossier Autres fichiers importés .When importing workflows, InfoPath forms are copied to the Other Imported Files folder. Si le .wsp fichier contient un modèle Web, il est défini comme page de démarrage dans l’Explorateur de solutions.If the .wsp file contains a Web template, it is set as the startup page in Solution Explorer.

Champs d’importation et les conteneurs de propriétésImport fields and property bags

Lorsque vous importez une solution comportant plusieurs champs, toutes les définitions de champs distinctes sont fusionnées en un seul Elements.xml fichier sous un nœud de l’Explorateur de solutions appelé champs .When you import a solution that has multiple fields, all of the separate field definitions are merged into a single Elements.xml file under a node in Solution Explorer called Fields. De même, toutes les entrées de sac de propriétés sont fusionnées dans un Elements.xml fichier sous un nœud appelé PropertyBags.Similarly, all property bag entries are merged into an Elements.xml file under a node called PropertyBags.

Dans SharePoint, les champs sont des colonnes d’un type de données spécifié, tel que texte, valeur booléenne ou recherche.Fields in SharePoint are columns of a specified data type, such as a text, Boolean, or lookup. Pour plus d’informations, consultez Bloc de construction : Colonnes et types de champs.For more information, see Building Block: Columns and Field Types. Les conteneurs des propriétés vous permettent d’ajouter des propriétés à toutes sortes d’objets dans SharePoint, d’une batterie de serveurs entière à une simple liste sur un site SharePoint.Property bags enable you to add properties to objects in SharePoint, everything from a farm to a list on a SharePoint site. Ils sont implémentés en tant que table de hachage de noms et de valeurs de propriétés.Property bags are implemented as a hash table of property names and values. Pour plus d’informations, consultez Gestion de la configuration de SharePoint ou Paramètres des conteneurs des propriétés SharePoint.For more information, see Managing SharePoint Configuration or SharePoint Property Bag Settings.

Supprimer des éléments dans le projetDelete items in the project

La plupart des éléments dans les solutions SharePoint ont un ou plusieurs éléments dépendants.Most items in SharePoint solutions have one or more dependent items. Par exemple, les instances de listes dépendent des types de contenu et les types de contenu dépendent des champs.For example, list instances depend on content types and content types depend on fields. Une fois que vous avez importé une solution SharePoint, Visual StudioVisual Studio ne vous signale les éventuels problèmes de référence si vous supprimez un élément dans la solution, mais pas ses éléments dépendants, que lorsque vous tentez de déployer la solution.After you import a SharePoint solution, Visual StudioVisual Studio does not notify you of any reference problems if you delete an item in the solution, but not its dependent items, until you attempt to deploy the solution. Par exemple, si une solution importée comporte une instance de liste qui dépend d’un type de contenu et que vous supprimez ce type de contenu, une erreur peut se produire pendant le déploiement.For example, if an imported solution has a list instance that depends on a content type and you delete that content type, an error might occur on deployment. L’erreur se produit si l’élément dépendant n’est pas présent sur le serveur SharePoint.The error occurs if the dependent item is not present on the SharePoint server. De même, si un élément supprimé a également un conteneur de propriétés, puis supprimez ces entrées à partir de la PropertyBags Elements.xml fichier.Similarly, if a deleted item also has a related property bag, then delete those property bag entries from the PropertyBags Elements.xml file. Ainsi, si vous supprimez des éléments d’une solution importée et que des erreurs de déploiement se produisent, vérifiez si des éléments dépendants doivent également être supprimés.Therefore, if you delete any items from an imported solution and you get deployment errors, check to see if any dependent items need to also be deleted.

Restaurer les attributs de fonctionnalité manquantsRestore missing feature attributes

Lors de l’importation de solutions, certains attributs de fonctionnalités facultatifs sont omis du manifeste de fonctionnalité importé.When importing solutions, some optional feature attributes are omitted from the imported feature manifest. Si vous souhaitez restaurer ces attributs dans le nouveau fichier de fonctionnalité, identifiez les attributs manquants en comparant le fichier de fonctionnalité d’origine au nouveau manifeste de fonctionnalité et suivez les instructions de la rubrique Comment : personnaliser une fonctionnalité SharePoint.If you want to restore these attributes in the new feature file, identify the missing attributes by comparing the original feature file to the new feature manifest and follow the instructions in the topic How to: Customize a SharePoint feature.

Détection de conflit de déploiement n’est pas effectuée sur les instances de listes intégréesDeployment conflict detection is not performed on built-in list instances

Visual StudioVisual Studio n’effectue pas de détection de conflit de déploiement sur les instances de listes intégrées (autrement dit, les instances de listes par défaut fournies avec SharePoint). does not perform deployment conflict detection on built-in list instances (that is, default list instances that come with SharePoint). La non-détection des conflits a pour but d’éviter le remplacement des instances de listes intégrées dans SharePoint.Not performing conflict detection is done to avoid overwriting the built-in list instances on SharePoint. Les instances de listes intégrées sont toujours déployées ou mises à jour, mais ne sont jamais supprimées ou remplacées.The built-in list instances are still deployed or updated, but are never deleted or overwritten. Pour plus d'informations, voirFor more information, see Résoudre les problèmes d’empaquetage de SharePoint et de déploiement. Troubleshoot SharePoint packaging and deployment.

Importer des flux de travail SharePoint Server 2010Import SharePoint Server 2010 workflows

Si vous importez un flux de travail créé dans SharePoint Server 2010SharePoint Server 2010, il ne s’exécute pas correctement une fois déployé.If you import a workflow created in SharePoint Server 2010SharePoint Server 2010, it will not run correctly after you deploy it. Le flux de travail ne s’exécute pas correctement, car certains assemblys sont manquants et les flux de travail SharePoint Server 2010SharePoint Server 2010 contiennent des formulaires InfoPath qui ne sont pas pris en charge actuellement dans les solutions de flux de travail Visual StudioVisual Studio .The workflow does not run correctly because certain assemblies are missing and SharePoint Server 2010SharePoint Server 2010 workflows contain InfoPath forms which are not currently supported in Visual StudioVisual Studio workflow solutions. Toutefois, les flux de travail SharePoint Server 2010SharePoint Server 2010 importés peuvent fonctionner correctement après quelques corrections, comme l’ajout de références aux assemblys SharePoint Server 2010SharePoint Server 2010 et la reconnexion des formulaires InfoPath.However, imported SharePoint Server 2010SharePoint Server 2010 workflows can be made to work correctly after fixing some items, such as adding references to the SharePoint Server 2010SharePoint Server 2010 assemblies and reconnecting the InfoPath forms. Pour plus d'informations, voirFor more information, see Importation de flux de travail SharePoint Server 2010. Importing SharePoint Server 2010 Workflows.

Limite de caractères de nom élémentItem name character limit

Visual StudioVisual Studio a une limite de 260 caractères pour le nom de projet et les noms des éléments de projet, chemin d’accès compris. has a limit of 260 total characters for project and project item names, including the path. Pendant l’importation d’une solution, si un nom d’élément dépasse cette limite, l’erreur suivante s’affiche :When importing a solution, if an item name exceeds this limit, you get the error:

Le chemin d’accès spécifié, le nom de fichier ou les deux sont trop longs. Le nom complet du fichier doit être inférieur à 260 caractères, et le nom du répertoire à 248 caractères.The specified path, file name, or both are too long. The fully qualified file name must be less than 260 characters, and the directory name must be less than 248 characters.

Quand cette erreur se produit, l’élément n’est pas créé.When you get this error, the item is not created. Ce problème se produit le plus souvent avec les modules importés.This problem occurs most often with imported modules. Pour l’éviter, procédez comme suit :To avoid this problem, do the following:

  • Utilisez des noms courts pour vos projets quand vous les entrez dans la boîte de dialogue Ajouter un nouveau projet .Use short names for your project when you enter them in the Add New Project dialog box.

  • Créez le projet dans un emplacement le plus près possible du dossier racine, afin de raccourcir le chemin d’accès.Create the project in a location as close to the root folder as possible, so as to shorten the path.

L’attribut SharePointProductVersionThe SharePointProductVersion attribute

Si vous importez une solution créée dans une version antérieure de SharePoint telle que Windows SharePoint Services 3,0Windows SharePoint Services 3.0 ou Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007, vous devez soit remplacer la valeur de l’attribut SharePointProductVersion dans le manifeste du package par 12.0, soit insérer un contrôle de gestionnaire de scripts dans toutes les pages web importées et conserver la valeur 14.0 pour l’attribut SharePointProductVersion.If you import a solution created in an earlier version of SharePoint such as Windows SharePoint Services 3,0Windows SharePoint Services 3.0 or Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007, either change the SharePointProductVersion attribute value in the package manifest to 12.0, or insert a script manager control into all imported Web pages and leave SharePointProductVersion set to 14.0. Autrement, les formulaires web importés ne s’afficheront pas dans SharePoint.Otherwise, imported Web forms will not display in SharePoint.

PrésentationBackground

Les solutions dans SharePoint Foundation 2010SharePoint Foundation 2010 et SharePoint Server 2010SharePoint Server 2010 incluent un attribut nommé SharePointProductVersion.Solutions in SharePoint Foundation 2010SharePoint Foundation 2010 and SharePoint Server 2010SharePoint Server 2010 include an attribute called SharePointProductVersion. SharePoint utilise cet attribut dans ses manifestes de packages pour déterminer la version de SharePoint pour laquelle la solution est conçue.SharePoint uses this attribute in its package manifests to determine the version of SharePoint the solution is designed for. Les deux valeurs valides sont 12.0 et 14.0.The two valid values are 12.0 and 14.0. La valeur 12.0 indique que l’élément est conçu pour Windows SharePoint Services 3,0Windows SharePoint Services 3.0 ou Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007. La valeur 14.0 indique que l’élément est conçu pour SharePoint Foundation 2010SharePoint Foundation 2010 ou SharePoint Server 2010SharePoint Server 2010.A value of 12.0 indicates that the item is designed for Windows SharePoint Services 3,0Windows SharePoint Services 3.0 or Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007; a value of 14.0 indicates that the item is designed for SharePoint Foundation 2010SharePoint Foundation 2010 or SharePoint Server 2010SharePoint Server 2010.

Pour renforcer la sécurité lors du rendu des pages ASPX, SharePoint Foundation 2010SharePoint Foundation 2010 et SharePoint Server 2010SharePoint Server 2010 exigent que toutes les pages ASPX ou pages maîtres contiennent un contrôle de gestionnaire de scripts.For enhanced security when rendering ASPX pages, SharePoint Foundation 2010SharePoint Foundation 2010 and SharePoint Server 2010SharePoint Server 2010 require that all ASPX or master pages contain a script manager control. Pour plus d’informations sur le gestionnaire de scripts, consultez Vue d’ensemble du contrôle ScriptManager.For more information about script manager, see ScriptManager Control Overview. Le contrôle de gestionnaire de scripts n’étant pas disponible dans Windows SharePoint Services 3,0Windows SharePoint Services 3.0 et Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007, vous devez en ajouter un à toute page Windows SharePoint Services 3,0Windows SharePoint Services 3.0 ou Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007 qui est mise à niveau vers SharePoint Foundation 2010SharePoint Foundation 2010 ou SharePoint Server 2010SharePoint Server 2010.Because the script manager control was not available in Windows SharePoint Services 3,0Windows SharePoint Services 3.0 and Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007, one must be added to any Windows SharePoint Services 3,0Windows SharePoint Services 3.0 or Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007 page that is upgraded to SharePoint Foundation 2010SharePoint Foundation 2010 or SharePoint Server 2010SharePoint Server 2010. Les pages ASPX qui utilisent une page maître standard ne nécessitent pas de contrôle de gestionnaire de scripts, car un contrôle de ce type a déjà été ajouté à la page maître standard.ASPX pages that use a standard master page do not require a script manager control because one is already added to the standard master page. En revanche, les pages ASPX qui n’utilisent pas de page maître ou qui utilisent une page maître personnalisée doivent ajouter un contrôle de script pour fonctionner dans SharePoint Foundation 2010SharePoint Foundation 2010 ou SharePoint Server 2010SharePoint Server 2010.However, ASPX pages that do not use a master page or that use a custom master page must add a script control in order to work in SharePoint Foundation 2010SharePoint Foundation 2010 or SharePoint Server 2010SharePoint Server 2010.

L’absence de contrôle de gestionnaire de scripts peut être problématique quand vous importez un projet Windows SharePoint Services 3,0Windows SharePoint Services 3.0 ou Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007 dans Visual Studio 2010Visual Studio 2010, car l’attribut SharePointProductVersion de tous les nouveaux projets a la valeur 14.0.The absence of a script manager control can be a problem when you import a Windows SharePoint Services 3,0Windows SharePoint Services 3.0 or Microsoft Office SharePoint Server 2007Microsoft Office SharePoint Server 2007 project into Visual Studio 2010Visual Studio 2010, because the SharePointProductVersion attribute of all new projects is set to 14.0. Si vous déployez un projet mis à niveau comportant un formulaire web sans gestionnaire de scripts, le formulaire ne s’affichera pas dans SharePoint.If you deploy an upgraded project that has a Web form without a script manager, the form will not display in SharePoint.

Voir aussiSee also

Procédure pas à pas : Importation d’éléments d’un site SharePoint existant Walkthrough: Import items from an existing SharePoint site
Directives pour l’importation de flux de travail réutilisables Guidelines for importing reusable workflows
Procédure pas à pas : Importation d’un flux de travail réutilisable de SharePoint Designer dans Visual Studio Walkthrough: Import a SharePoint Designer reusable workflow into Visual Studio
Comment : ajouter un fichier de modèle BDC existant à un projet SharePointHow to: Add an existing BDC model file to a SharePoint project