Procédure pas à pas : Importer des éléments d’un site SharePoint existant
Cette procédure pas à pas montre comment importer des éléments d’un site SharePoint existant dans un projet SharePoint Visual Studio.
Cette procédure pas à pas décrit les tâches suivantes :
Personnalisation d’un site SharePoint en ajoutant une colonne de site personnalisée (également appelée champ).
Exportation d’un site SharePoint vers un fichier .wsp.
Importation du fichier .wsp dans Visual Studio SharePoint en utilisant le projet d’importation .wsp.
Notes
Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE.
Prérequis
Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :
Éditions prises en charge de Microsoft Windows et SharePoint.
Visual Studio.
Personnaliser un site SharePoint
Pour cet exemple, vous créez et personnalisez un sous-site SharePoint en y ajoutant une nouvelle colonne de site et en créant un autre sous-site pour l’utiliser plus tard. Par la suite, vous exportez le premier sous-site dans un fichier .wsp, puis importez la colonne de site personnalisée dans le deuxième sous-site en utilisant le projet d’importation .wsp.
Pour créer et personnaliser un site SharePoint
Ouvrez un site SharePoint dans un navigateur web, comme http://nom du système/SitePages/Home.aspx.
Créez un sous-site hors du site SharePoint principal en ouvrant le menu Actions de site, puis en choisissant Nouveau site.
Dans la boîte de dialogue Créer du site, choisissez le type Site vide.
Dans la zone Titre, entrez Site Column Test 1, dans la zone Nom de l’URL, entrez columntest1, laissez les autres paramètres avec leurs valeurs par défaut, puis choisissez le bouton Créer.
Une fois le site créé, revenez dans le navigateur sur le site principal, http:// nom du système/SitePages/Home.aspx.
Là encore, créez un sous-site vide hors du site SharePoint principal en ouvrant le menu Actions de site, en choisissant Nouveau site, puis en choisissant le type Site vide.
Dans la zone Titre, entrez Site Column Test 2, dans la zone Nom de l’URL, entrez columntest2, laissez les autres paramètres avec leurs valeurs par défaut, puis choisissez le bouton Créer.
Revenez au premier sous-site, http:// SystemName/columntest1/default.aspx.
Dans le menu Actions de site, choisissez Paramètres du site pour afficher la page Paramètres du site.
Dans la section Galeries, choisissez le lien Colonnes de site.
En haut de la page Galerie de colonnes de site, choisissez le bouton Créer.
Dans la zone Nom de la colonne, entrez Test Column, conservez les autres valeurs par défaut, puis choisissez le bouton OK.
La colonne Test Column s’affiche sous l’en-tête Colonnes personnalisées dans la galerie de colonnes de site.
Exportation du site SharePoint
Ensuite, obtenez un fichier de configuration SharePoint (.wsp) qui contient les éléments SharePoint que vous souhaitez importer dans votre projet SharePoint Visual Studio. Si vous n’avez pas encore de fichier .wsp, vous devez en créer un à partir d’un site SharePoint existant. Pour cet exemple, vous exportez le site SharePoint par défaut dans un fichier .wsp.
Important
Si vous recevez une erreur d’exécution en effectuant la procédure suivante, vous devez effectuer la procédure sur un système qui a accès au site SharePoint.
Pour exporter un site SharePoint existant
Dans le site SharePoint, choisissez Paramètres du site sous l’onglet Actions de site pour afficher la page Paramètres du site.
Dans la section Actions de site de la page Paramètres du site, choisissez le lien Enregistrer le site comme modèle.
Dans la zone Nom de fichier, entrez ExampleSite, puis dans la zone Nom du modèle, entrez Example Site.
Pour cet exemple, laissez la case Inclure le contenu décochée.
Si vous sélectionnez cette case, Visual Studio enregistre toutes les listes et bibliothèques de documents, ainsi que leur contenu, dans le fichier .wsp. Bien que cela soit utile dans certaines circonstances, ce n’est pas nécessaire pour cet exemple.
Une fois l’opération terminée, choisissez le lien galerie de solutions pour voir le fichier .wsp.
Pour voir la page de la galerie de solutions par la suite, ouvrez le menu Actions de site, choisissez Paramètres du site, choisissez le lien Accéder aux paramètres de site de niveau supérieur dans la section Administration de la collection de sites, puis choisissez le lien Solutions dans la section Galeries.
Dans la galerie de solutions, choisissez le lien ExampleSite.
Dans la boîte de dialogue Téléchargement de fichier, choisissez le bouton Enregistrer pour enregistrer le fichier sur votre système local, par défaut, dans votre dossier Téléchargements.
Importer le fichier .wsp
Maintenant que vous avez un fichier .wsp qui contient un élément que vous souhaitez réutiliser (la colonne de site personnalisée Test Column), importez le fichier .wsp pour y accéder.
Pour importer un fichier .wsp
Dans Visual Studio, dans la barre de menus, choisissez Fichier>Nouveau>Projet pour afficher la boîte de dialogue Nouveau projet. Si votre IDE est défini pour utiliser les paramètres de développement Visual Basic, dans la barre de menu, choisissez Fichier>Nouveau projet.
Développez le nœud SharePoint sous Visual C# ou Visual Basic, puis choisissez le nœud 2010.
Choisissez le modèle Importer le package de solution SharePoint 2010 dans le volet Modèles, laissez WspImportProject1 comme nom du projet, puis choisissez le bouton OK.
L’Assistant Personnalisation de SharePoint s’affiche.
Dans la page Spécifier le site et le niveau de sécurité pour le débogage, entrez l’URL du deuxième sous-site SharePoint que vous avez créé précédemment. Vous ajoutez le nouvel élément Field personnalisé, http://nom du système/columntest2, à ce sous-site.
Dans la section Quel est le niveau de confiance de cette solution SharePoint ?, laissez la valeur par défaut Déployer comme une solution bac à sable.
Dans la page Spécifier la nouvelle source de projet, accédez à l’emplacement du système où vous avez enregistré le fichier .wsp précédemment, puis choisissez le bouton Suivant.
Notes
Si vous choisissez le bouton Terminer dans cette page, tous les éléments disponibles dans le fichier .wsp sont importés.
Dans la zone Sélectionner les éléments à importer, décochez toutes les cases de la liste, sauf Test Column, puis choisissez le bouton Terminer.
Comme la liste contient de nombreux éléments, vous pouvez utiliser les touches Ctrl+A pour choisir tous les éléments de la liste, la touche Espace pour décocher toutes les cases, puis cochez uniquement la case à côté de l’élément Test Column.
Une fois l’opération d’importation terminée, un nouveau projet nommé WspImportProject1 est créé avec un dossier nommé Fields. Dans ce dossier se trouve la colonne de site personnalisée Test Column et son fichier de définition Elements.xml.
Déployer le projet
Enfin, déployez WspImportProject1 sur le deuxième sous-site SharePoint que vous avez créé précédemment pour voir la colonne de site personnalisée.
Pour déployer le projet
Dans Visual Studio, utilisez la touche F5 pour déployer et exécuter le projet d’importation .wsp.
Dans le site SharePoint, ouvrez le menu Actions de site, puis choisissez Paramètres du site pour afficher la page Paramètres du site.
Dans la section Galeries, choisissez le lien Colonnes de site.
Faites défiler jusqu’à la section Colonnes personnalisées.
Notez que la colonne de site personnalisée que vous avez importée à partir du premier site SharePoint s’affiche dans la liste.