Développement de solutions SharePoint

Article
08/10/2011

Pour créer vos sites et éléments de sites SharePoint, vous disposez de plusieurs modèles de type de projet SharePoint dans Visual Studio. Pour obtenir la liste des types de projet disponibles, consultez Modèles de projets et d'éléments de projet SharePoint. Les éléments et propriétés d'un projet SharePoint sont décrits ci-après.

Éléments d'un projet SharePoint

Les nœuds sous un projet SharePoint sont appelés éléments SharePoint. Les éléments SharePoint peuvent contenir également un ou plusieurs sous-fichiers, connus sous le nom de fichiers d'éléments SharePoint, tels que les fichiers de configuration XML, les formulaires .aspx, etc.

Au lieu de créer des projets à l'aide de modèles de projet préremplis avec des fichiers d'éléments de projet, vous pouvez sélectionner le modèle Projet vide pour commencer un projet SharePoint à partir de zéro et ajouter manuellement les différents éléments de projet. Un projet SharePoint peut également être composé d'un ou plusieurs fichiers de fonctionnalités (pour l'activation dans SharePoint) et d'un fichier de package permettant de distribuer le projet.

Nœuds spéciaux

Chaque projet SharePoint contient deux nœuds qu'il est impossible de renommer, supprimer, couper, copier ou déplacer du projet. Il s'agit des nœuds suivants :

Fonctionnalités
Package

Ces deux nœuds s'affichent systématiquement dans tous les projets SharePoint même si aucune fonctionnalité ou package n'est défini pour le projet.

Nœud Fonctionnalités

Le nœud Fonctionnalités comprend une ou plusieurs fonctionnalités de projet SharePoint. Une fonctionnalité est un conteneur d'extensions pour SharePoint. Une fois déployée sur un serveur SharePoint, la fonctionnalité peut être ajoutée à des définitions de site ou activée individuellement par les administrateurs SharePoint sur les sites SharePoint. Pour plus d'informations, consultez Utilisation des fonctionnalités.

Lorsque vous ajoutez un élément (type de contenu ou instance de liste, par exemple) à un projet SharePoint, cet élément figure dans une fonctionnalité au sein du nœud Fonctionnalités. La portée de l'élément détermine s'il est ajouté à une fonctionnalité nouvelle ou existante. Si le nouvel élément a la même portée qu'une fonctionnalité existante, il est ajouté à cette fonctionnalité. Sinon, il est intégré à une nouvelle fonctionnalité.

Pour insérer manuellement une fonctionnalité, choisissez la commande Ajouter une fonctionnalité dans le menu contextuel du nœud Fonctionnalités. Pour afficher ou modifier le contenu d'une fonctionnalité, servez-vous du Concepteur de fonctionnalités. Pour plus d'informations, consultez Comment : personnaliser une fonctionnalité SharePoint.

Lorsqu'une fonctionnalité est ajoutée à un projet SharePoint, elle s'affiche dans l'Explorateur de solutions sous forme de nœud et prend le nom par défaut Featurex.feature, où x représente un nombre unique. Une fois déployée sur le serveur SharePoint, l'administrateur SharePoint peut décider de l'activer pour la mettre à la disposition des utilisateurs du site SharePoint.

Nœud Package

Le nœud Package contient un fichier unique servant de mécanisme de distribution pour le projet SharePoint. Ce fichier, appelé package de solution, est basé sur le format .CAB et est reconnaissable à son extension .WSP. Un package de solution est un fichier réutilisable prévu pour être déployé. Il contient un ensemble de fonctionnalités, définitions de site et assemblys (activables ou désactivables individuellement) s'appliquant aux sites SharePoint. Le nœud Package comprend également un fichier nommé Package.wspdef, c'est-à-dire un fichier de définition XML pour le package. Une fois le package déployé sur le serveur SharePoint, l'administrateur SharePoint peut l'installer et activer ses fonctionnalités.

Il suffit de double-cliquer sur le nœud Package pour l'ouvrir dans le Concepteur de packages afin d'afficher ou de modifier son contenu. Pour plus d'informations, consultez Création de packages de solution SharePoint.

Propriétés des projets et des éléments de projet SharePoint

Les propriétés des projets SharePoint, à l'instar de tout autre projet Visual Studio, sont récapitulées dans la fenêtre Propriétés et dans la page Propriétés. Les propriétés affichées dépendent du nœud sélectionné.

Lorsqu'un projet, élément de projet, ou nœud de fichier d'élément de projet SharePoint est sélectionné dans l'Explorateur de solutions, les propriétés suivantes s'affichent dans la fenêtre ou la page Propriétés :

Propriétés du projet

Nom de la propriété	Description
Configuration de déploiement active	Spécifie la série d'étapes exécutée pendant le déploiement. Pour plus d'informations, consultez Comment : modifier une configuration de déploiement SharePoint.
Cible de déploiement d'assembly	Détermine à quel endroit sont stockés les assemblys d'application SharePoint. Les valeurs d'emplacement autorisées sont GlobalAssemblyCache (valeur par défaut) ou WebApplication. Si la propriété Sandboxed Solution a la valeur true, cette propriété est désactivée.
Retrait automatique après le débogage	Spécifie si la solution déployée est automatiquement retirée de SharePoint une fois l'application exécutée en mode débogage dans Visual Studio. Lorsque cette option est activée, la solution est retirée lorsque l'IDE repasse en mode Design après le débogage. Lorsqu'elle est désactivée, la solution n'est pas retirée. Pour plus d'informations, consultez Retrait d'une solution.
Modifier les configurations	Spécifie la configuration de déploiement à utiliser pour le projet. Pour plus d'informations, consultez Comment : modifier une configuration de déploiement SharePoint et Déploiement de packages de solution SharePoint.
Activer le débogage Silverlight (au lieu du débogage de script)	Lorsque cette option est activée, le débogueur Silverlight s'attache au processus de débogage. Lorsqu'elle est désactivée, le débogueur de script s'attache au processus de débogage. Pour plus d'informations, consultez Vue d'ensemble du débogage Silverlight (page éventuellement en anglais).
Inclure un assembly dans le package	Spécifie si l'assembly de projet est empaqueté au moment de la génération ou non.
Ligne de commande de post-déploiement	Spécifie les commandes à exécuter après le déploiement de la solution SharePoint. Cette ligne prend en charge n'importe quelle commande batch ainsi que la résolution des variables MSBuild. Pour plus d'informations, consultez Comment : définir des commandes de déploiement SharePoint.
Ligne de commande de prédéploiement	Spécifie les commandes à exécuter avant le déploiement de la solution SharePoint. Cette ligne prend en charge n'importe quelle commande batch ainsi que la résolution des variables MSBuild. Pour plus d'informations, consultez Comment : définir des commandes de déploiement SharePoint.
Fichier projet	Nom du fichier qui contient les informations de build, de configuration et d'autres informations relatives au projet.
Dossier du projet	Emplacement du fichier projet sur le système. (En lecture seule.)
Solution bac à sable (sandbox)	Indique si le projet doit être déployé en tant que solution bac à sable (sandbox) (on parle aussi de solution utilisateur). Les solutions bac à sable ne sont pas nécessairement dignes de confiance. La valeur true signifie que le projet est déployé comme une solution bac à sable, alors que la valeur false signifie qu'il est déployé comme une solution de batterie. Pour plus d'informations, consultez Considérations sur les solutions bac à sable (sandbox) et Différences entre les solutions bac à sable (sandbox) et les solutions de batterie.
URL du site	Spécifie l'URL du site cible de ce projet.
Élément de démarrage	Spécifie le premier élément exécuté dans le projet.

En cas de sélection de fichiers d'éléments SharePoint (flux de travail ou fonctionnalité du nœud Fonctionnalités, par exemple), voici les informations affichées dans la fenêtre Propriétés :

Propriétés des éléments de projet

Nom de la propriété	Description
Résolution des conflits de déploiement	Spécifie l'action à entreprendre lors du déploiement d'un élément de projet dont les propriétés sont identiques à celles d'un élément figurant déjà sur le serveur. Pour plus d'informations, consultez Dépannage de la création de packages et du déploiement SharePoint.
Propriétés de la fonctionnalité	Spécifie un jeu de valeurs (stockées sous la forme de paires clé/valeur) inclus avec une fonctionnalité lors de son déploiement sur SharePoint. Une fois la fonctionnalité déployée, vous pouvez accéder aux valeurs de propriété dans votre code. Pour plus d'informations, consultez Fourniture d'informations de création de packages et de déploiement dans des éléments de projet.
Récepteur de fonctionnalité	Fournit le code qui s'exécute lorsque certains événements se produisent pour une fonctionnalité contenant un élément de projet. Pour plus d'informations, consultez Fourniture d'informations de création de packages et de déploiement dans des éléments de projet.
Nom du dossier	Nom du dossier contenant les éléments de projet SharePoint.
Références de sortie de projet	Spécifie une dépendance, telle qu'un assembly, que votre élément de projet doit exécuter. Pour plus d'informations, consultez Fourniture d'informations de création de packages et de déploiement dans des éléments de projet.
Entrées de contrôle sécurisé	Spécifie les contrôles que les utilisateurs non fiables peuvent modifier en toute sécurité. Pour plus d'informations, consultez Fourniture d'informations de création de packages et de déploiement dans des éléments de projet.

Propriétés des fichiers d'éléments de projet

Nom de la propriété	Description
Action de génération	Indique le lien entre le fichier et les processus de génération et de déploiement. Pour plus d'informations, consultez Propriétés des fichiers.
Copier dans le répertoire de sortie	Indique si le ou les fichiers source seront copiés vers le répertoire de sortie. Peut avoir l'une des valeurs suivantes : Do not copy Copy always Copy if newer Pour plus d'informations, consultez Propriétés des fichiers.
Outil personnalisé	Spécifie le nom de l'outil utilisé (le cas échéant) pour transformer le fichier au moment du design et placer le résultat de la transformation dans un autre fichier. Par exemple, un fichier de groupe de données (.XSD) est associé à un outil personnalisé par défaut. Pour plus d'informations, consultez Propriétés des fichiers.
Espace de noms de l'outil personnalisé	Espace de noms dans lequel la sortie de l'outil personnalisé est copiée. Pour plus d'informations, consultez Propriétés des fichiers.
Emplacement de déploiement	Chemin d'accès qualifié complet du fichier sur le serveur SharePoint. Ce chemin d'accès est composé des sous-propriétés Racine du déploiement et Chemin d'accès du déploiement.
Chemin d'accès du déploiement	Chemin d'accès relatif au fichier sur le serveur de fichiers SharePoint, tel que Workflow1\. Le chemin d'accès qualifié complet du fichier est obtenu par concaténation de la valeur Deployment Path à la fin de la valeur Deployment Root. Si vous sélectionnez la valeur RootFile pour la propriété Deployment Type, la propriété Deployment Root prend la valeur {SharePointRoot}\, ce qui permet d'obtenir le chemin d'accès qualifié complet suivant : {SharePointRoot} \Workflow1\. Pour plus d'informations, consultez Empaquetage et déploiement de solutions SharePoint.
Racine du déploiement	Chaîne. Dossier racine dans lequel le fichier est déployé sur le serveur SharePoint. Par exemple, {SharePointRoot}\Template\Features\{NomFonctionnalité}\. La valeur de la propriété Deployment Root est déterminée par le paramètre Deployment Type.
Type de déploiement	Type de déploiement du fichier lequel détermine sa valeur Deployment Root. Peut avoir l'une des valeurs suivantes : Valeur EnumValeur Deployment Root NoDeployment<aucune valeur> ElementManifest{SharePointRoot}\Template\Features\{NomFonctionnalité}\ ElementFile{SharePointRoot}\Template\Features\{NomFonctionnalité}\ TemplateFile{SharePointRoot}\Template\ RootFile{SharePointRoot}\ GlobalResource{SharePointRoot}\Resources\ ClassResource{ClassResourcePath}\ Pour plus d'informations, consultez DeploymentType.
Nom de fichier	Nom du fichier ou du dossier pour le fichier d'élément.
Chemin d'accès complet	Emplacement du fichier pour l'élément. (En lecture seule.)

Rubriques connexes

Titre	Description
Modèles de projets et d'éléments de projet SharePoint	Décrit le projet SharePoint et les modèles d'élément de projet disponibles dans Visual Studio.
Comment : ajouter des éléments à un projet SharePoint	Explique comment ajouter de nouveaux éléments ou des éléments existants à un projet SharePoint Visual Studio.
Procédure pas à pas : création d'un champ personnalisé, d'un type de contenu, d'une définition de liste et d'une instance de liste	Montre comment créer, étape par étape, un champ client, un type de contenu, une définition de liste et une instance de liste.
Comment : créer un récepteur d'événements	Explique comment ajouter un récepteur d'événements pour le projet créé dans Procédure pas à pas : création d'un champ personnalisé, d'un type de contenu, d'une définition de liste et d'une instance de liste.
Création de solutions de flux de travail SharePoint	Explique comment créer des projets de flux de travail mettant en jeu des formulaires d'association et des formulaires d'initiation de flux de travail.
Création de pages pour SharePoint	Explique comment créer des pages telles que des pages d'application, pages de site, pages maîtres et mises en page pour SharePoint.
Création de composants WebPart pour SharePoint	Explique comme ajouter des contrôles pour permettre aux utilisateurs de modifier directement le contenu, l'apparence et le comportement des pages d'un site SharePoint à l'aide d'un navigateur.
Création de contrôles réutilisables pour les composants WebPart ou les pages d'application	Explique comment créer des contrôles utilisateur pouvant être consommés par les pages d'application et les composants WebPart qui s'exécutent dans SharePoint.
Intégration de données métiers dans SharePoint	Explique comment intégrer les données des services Web et des applications serveur principales à une application SharePoint.
Création de définitions de site pour SharePoint	Explique comment créer des définitions de site, c'est-à-dire les modèles utilisés pour concevoir des sites SharePoint.
Importation d'éléments d'un site SharePoint existant	Explique comment importer les éléments (tels que des types de contenu et des modules) d'un site SharePoint existant vers un projet SharePoint Visual Studio.
Utilisation de modules pour inclure des fichiers dans la solution	Explique comment utiliser des modules pour déployer les fichiers de votre projet Visual Studio sur le site SharePoint.
Parcours des connexions SharePoint à l'aide de l'Explorateur de serveurs	Explique comment parcourir les sites SharePoint locaux à l'aide de l'Explorateur de serveurs.
Fourniture d'informations de création de packages et de déploiement dans des éléments de projet	Explique comment utiliser les propriétés d'élément de projet pour fournir des informations d'empaquetage et de déploiement pour les projets, telles que les entrées de contrôle sécurisé, les références de sortie de projet et les propriétés de fonctionnalité.
Comment : ajouter et supprimer des dossiers mappés	Explique comment ajouter des dossiers mappés à votre projet afin de faciliter l'accès aux ressources SharePoint.
Considérations sur les solutions bac à sable (sandbox)	Décrit les problèmes ayant trait aux solutions bac à sable (sandbox).
Sécurité pour les solutions SharePoint	Décrit les règles de sécurité à respecter pour le développement de solutions SharePoint dans Visual Studio.
Boîte de dialogue du sélecteur d'URL (développement SharePoint dans Visual Studio)	Décrit une boîte de dialogue que vous pouvez utiliser pour ajouter des références de chemin de fichier aux ressources dans votre projet ou sur le serveur SharePoint local.