Procédure pas à pas : importation d'éléments d'un site SharePoint existant
Cette procédure pas à pas montre comment importer des éléments à partir d'un site SharePoint existant dans un projet SharePoint Visual Studio.
Cette procédure pas à pas présente les tâches suivantes :
Personnalisation d'un site SharePoint en ajoutant une colonne de site personnalisée (également appelé un champ).
Exportation d'un site SharePoint vers un fichier .wsp.
Importation du fichier .wsp dans SharePoint Visual Studio par l'intermédiaire du projet d'importation .wsp.
-
Notes
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio 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 Paramètres Visual Studio.
Composants requis
Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :
Éditions de Microsoft Windows et de SharePoint prises en charge. Pour plus d'informations, consultez Configuration requise pour développer des solutions SharePoint.
Visual Studio 2010.
Personnalisation d'un site SharePoint
Dans cet exemple, vous serez amené à concevoir et à personnaliser un sous-site SharePoint en y incorporant une nouvelle colonne de site, puis en créant un autre sous-site en vue d'une utilisation ultérieure. Vous serez chargé ensuite d'exporter le premier sous-site vers un fichier .wsp, puis d'importer la colonne de site personnalisée dans le deuxième sous-site par l'intermédiaire du projet d'importation .wsp.
Pour concevoir et personnaliser un site SharePoint
Ouvrez un site SharePoint dans un navigateur Web, comme par exemple http://nom du système/SitePages/Home.aspx.
Créez un sous-site hors du site SharePoint principal en cliquant sur Nouveau site dans l'onglet Actions du site.
Dans la boîte de dialogue de création du site, cliquez sur Site vide.
Dans la zone Titre, entrez Test de la colonne de site 1, dans la zone Nom d'URL, tapez TestColonne1, conservez les autres paramètres par défaut, puis cliquez sur Créer.
Après avoir créé le site, revenez au site principal (http://nom du système/SitePages/Home.aspx) dans le navigateur Web.
Créez à nouveau un sous-site vide hors du site SharePoint principal en cliquant sur Nouveau site dans l'onglet Actions du site, puis en sélectionnant Site vide.
Dans la zone Titre, entrez Test de la colonne de site 2, dans la zone Nom d'URL, tapez TestColonne2, conservez les autres paramètres par défaut, puis cliquez sur Créer.
Revenez au premier sous-site (http://nom du système/TestColonne1/SitePages/Home.aspx).
Cliquez sur Paramètres du site dans l'onglet Actions du site pour afficher la page Paramètres du site.
Cliquez sur le lien Colonnes de site dans la section Galeries.
Cliquez sur le bouton Créer en haut de la page Galerie des colonnes de sites.
Dans la zone Nom de la colonne, tapez Colonne test. Gardez les autres valeurs par défaut, puis cliquez sur OK.
La Colonne test s'affiche sous l'en-tête Colonnes personnalisées dans la galerie des colonnes de sites.
Exportation du site SharePoint
Vous avez besoin, à présent, d'un fichier d'installation SharePoint (.wsp) dans lequel figurent les éléments SharePoint à importer dans votre projet SharePoint Visual Studio. Si vous ne disposez d'aucun fichier .wsp, vous devez alors en créer un à partir d'un site SharePoint existant. Cet exemple suppose que vous exportiez le site SharePoint par défaut dans un fichier .wsp.
Important
Si une erreur d'exécution s'affiche au cours de la procédure suivante, cela signifie que vous devez exécuter la procédure sur un système ayant accès au site SharePoint.
Pour exporter un site SharePoint existant
Sous SharePoint, cliquez sur Paramètres du site dans l'onglet Actions du site afin d'afficher la page Paramètres du site.
Cliquez sur le lien Enregistrer le site en tant que modèle dans la section Actions du site de la page Paramètres du site.
Dans la zone Nom de fichier, tapez SiteExemple, et dans la zone Nom du modèle, tapez Site exemple.
Dans cet exemple, n'activez pas la case à cocher Inclure le contenu.
Si vous activez cette option, Visual Studio enregistre toutes les listes et bibliothèques de documents, ainsi que leur contenu, dans le fichier .wsp. Si cela présente un intérêt dans certaines circonstances, cela n'est pas le cas ici.
Une fois l'opération d'exportation terminée, cliquez sur le lien galerie des solutions utilisateur pour consulter le fichier .wsp.
Pour afficher la page de la galerie des solutions par la suite, cliquez sur Actions du site dans l'onglet Paramètres du site, cliquez sur Accéder aux paramètres du site de niveau supérieur dans la section Administration de la collection de sites, puis sur le lien Solutions dans la section Galeries.
Dans la galerie de solutions, cliquez sur le lien SiteExemple pour afficher la boîte de dialogue Téléchargement de fichier.
Cliquez sur le bouton Enregistrer dans la boîte de dialogue Téléchargement de fichier et sauvegardez le fichier sur le système.
Importation du fichier .wsp
Pour accéder au fichier .wsp contenant l'élément que vous avez l'intention de réutiliser (c'est-à-dire la colonne de site personnalisée Colonne test), il convient d'importer ce fichier.
Pour importer un fichier .wsp
Sous Visual Studio, affichez la boîte de dialogue Nouveau projet en pointant sur Nouveau dans le menu Fichier, puis en cliquant sur Nouveau projet.
Développez le nœud SharePoint sous Visual C# ou Visual Basic, puis cliquez sur 2010.
Cliquez sur Importer le package de solution SharePoint dans le volet Modèles, conservez le nom du projet WspImportProject1, puis cliquez sur 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. Ajoutez ensuite le nouvel élément de champ personnalisé, http://nom du système/columntest2, à ce sous-site.
Dans la section Quel est le niveau de confiance de cette solution SharePoint ?, conservez l'option sélectionnée Déployer en tant que solution bac à sable (sandbox).
Dans la page Spécifier la nouvelle source de projet, accédez à l'emplacement du système où vous avez précédemment enregistré le fichier .wsp, puis cliquez sur Suivant.
Notes
Le fait de cliquer sur Terminer sur cette page aurait pour effet d'importer tous les éléments disponibles dans le fichier .wsp.
Dans la zone Sélectionner les éléments à importer, retirez tous les éléments de la liste à l'exception de Colonne test, puis cliquez sur Terminer.
Étant donné que la liste comporte de nombreux éléments, le moyen le plus simple est d'appuyer sur CTRL + A afin de sélectionner tous les éléments de la liste, puis d'appuyer sur ESPACE pour effacer la sélection et enfin d'activer la case à cocher en regard de l'élément Colonne test.
Une fois l'opération d'importation terminée, un nouveau projet appelé WspImportProject1 dans lequel figure un dossier nommé Champs est alors créé. Ce dossier contient la colonne de site personnalisée (Colonne test) ainsi que son fichier de définition Elements.xml.
Déploiement du projet
La dernière étape consiste à déployer WspImportProject1 sur le deuxième sous-site SharePoint que vous avez créé précédemment pour afficher la colonne de site personnalisée.
Pour déployer le projet
Dans Visual Studio, appuyez sur F5 pour déployer et exécuter le projet d'importation .wsp.
Cliquez sur Paramètres du site dans l'onglet Actions du site pour afficher la page Paramètres du site.
Cliquez sur le lien Colonnes de site dans la section Galeries.
Faites défiler l'écran vers le bas jusqu'à la section Colonnes personnalisées.
La colonne de site personnalisée que vous avez importée à partir du premier site SharePoint figure, à présent, dans la liste.
Voir aussi
Concepts
Importation d'éléments d'un site SharePoint existant
Autres ressources
Développement de solutions SharePoint
Création de contrôles réutilisables pour les composants WebPart ou les pages d'application