Développer des solutions SharePoint
Pour créer des sites et des éléments de sites SharePoint, vous disposez de plusieurs modèles de type de projet Visual Studio. Pour obtenir la liste des types de projets disponibles, consultez Modèles de projet et d’élément de projet SharePoint. Les éléments et propriétés d'un projet SharePoint sont décrits ci-après.
Pour plus d’informations sur les compléments SharePoint, consultez Créer des compléments SharePoint.
É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, appelés 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 utiliser le modèle Projet vide pour créer un projet SharePoint vide et ajouter manuellement des éléments de projet. Les projets SharePoint peuvent également contenir un ou plusieurs fichiers de fonctionnalités (pour l'activation dans SharePoint) et un fichier de package permettant de distribuer le projet.
Nœuds spéciaux
Chaque projet SharePoint contient deux nœuds qui ne peuvent pas être renommés, supprimés, coupés, copiés ou déplacés du projet. Il s'agit des nœuds suivants :
Fonctionnalités
Paquet
Ces deux nœuds apparaissent toujours 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 contient 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.
Quand vous ajoutez un élément, comme un type de contenu ou une instance de liste, à un projet SharePoint, il est ajouté à une fonctionnalité dans le 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, l'élément est ajouté à une nouvelle fonctionnalité.
Pour ajouter manuellement une fonctionnalité, exécutez la commande Ajouter une fonctionnalité dans le menu contextuel du nœud Fonctionnalités. Vous pouvez afficher ou modifier le contenu d'une fonctionnalité à l'aide du Concepteur de fonctionnalités. Pour plus d’informations, consultez Guide pratique pour personnaliser une fonctionnalité SharePoint.
Quand une fonctionnalité est ajoutée à un projet SharePoint, elle apparaît dans l' Explorateur de solutions sous la forme d'un nœud ayant pour nom par défaut Featurex.feature, où x est un nombre unique. Une fois déployée sur le serveur SharePoint, un administrateur SharePoint peut l'activer et la mettre ainsi à la disposition des utilisateurs du site SharePoint.
Nœud Package
Le nœud Package contient un fichier unique qui sert de mécanisme de distribution pour le projet SharePoint. Ce fichier, appelé package de solution, est basé sur le format .CAB et porte l’extension .WSP. Un package de solution est un fichier réutilisable destiné à ê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 contient é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 qui exécute SharePoint, l'administrateur SharePoint peut l'installer et activer ses fonctionnalités.
Vous pouvez afficher ou modifier le contenu du package dans le Concepteur de packages en double-cliquant sur le nœud Package ou en ouvrant le menu contextuel, puis en choisissant Ouvrir. Pour plus d’informations, consultez Créer des packages de solution SharePoint.
Propriétés des projets et des éléments de projet SharePoint
Les projets SharePoint, tout comme les autres projets Visual Studio, présentent les propriétés 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é.
Quand 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 d’un projet
| Nom de la propriété | Description |
|---|---|
| Configuration de déploiement active | Spécifie la série d'étapes effectuée au cours du déploiement. Pour plus d’informations, consultez How to: Edit a SharePoint Deployment Configuration. |
| Cible de déploiement d'assembly | Détermine où se trouvent les assemblys d'application SharePoint . Les valeurs d'emplacement autorisées sont GlobalAssemblyCache (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. Quand cette option est activée et que l'IDE repasse en mode Design après le débogage, la solution est retirée. Quand 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 Guide pratique pour modifier une configuration de déploiement SharePoint et Déployer, publier et mettre à niveau des packages de solution SharePoint. |
| Activer le débogage Silverlight (au lieu du débogage de script) | Quand cette option est activée, le débogueur Silverlight s'attache au processus de débogage. Quand cette option 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 de Silverlight. |
| 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 toute commande de traitement par lots, ainsi que la résolution des variables MSBuild. Pour plus d'informations, consultez How to: Set SharePoint Deployment Commands. |
| 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 toute commande de traitement par lots, ainsi que la résolution des variables MSBuild. Pour plus d'informations, consultez How to: Set SharePoint Deployment Commands. |
| Fichier projet | Nom du fichier contenant la version, la configuration et d'autres informations sur le projet. |
| Dossier du projet | Emplacement du fichier projet sur le système. (En lecture seule.) |
| Sandboxed Solution | Spécifie si le projet doit être déployé en tant que solution bac à sable (sandbox), également appelée solution créée par l'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 Sandboxed Solution Considerations et Differences Between Sandboxed and Farm Solutions. |
| URL du site | Spécifie l’URL du site cible pour ce projet. |
| Élément de démarrage | Spécifie le premier élément à exécuter dans le projet. |
Quand vous choisissez un fichier d'élément SharePoint (comme un flux de travail ou une fonctionnalité du nœud Fonctionnalités), les propriétés suivantes s'affichent dans la fenêtre Propriétés :
Propriétés des éléments de projet
| Nom de la propriété | Description |
|---|---|
| Résolution de conflit 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 déjà présent sur le serveur. Pour plus d'informations, consultez Troubleshooting SharePoint Packaging and Deployment. |
| Propriétés de fonctionnalité | Spécifie un ensemble de valeurs (stockées sous forme de paires clé/valeur) inclus avec une fonctionnalité au moment 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 Providing Packaging and Deployment Information in Project Items. |
| Récepteur de fonctionnalité | Fournit le code qui s'exécute quand certains événements se produisent pour une fonctionnalité contenant un élément de projet. Pour plus d'informations, consultez Providing Packaging and Deployment Information in Project Items. |
| 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 Providing Packaging and Deployment Information in Project Items. |
| 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 Providing Packaging and Deployment Information in Project Items. |
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 du fichier. |
| 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 : - Ne pas copier - Toujours copier - Copier si plus récent Pour plus d’informations, consultez Propriétés du fichier. |
| 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 jeu de données (.XSD) est fourni avec un outil personnalisé par défaut. Pour plus d’informations, consultez Propriétés du fichier. |
| Espace de noms de l'outil personnalisé | Espace de noms dans lequel est copié le résultat de l'outil personnalisé. Pour plus d’informations, consultez Propriétés du fichier. |
| Emplacement de déploiement | Chemin d'accès 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é Type de déploiement, la propriété Racine de déploiement prend la valeur <SharePointRoot>\, ce qui génère le chemin d’accès qualifié complet <SharePointRoot>\Workflow1\. Pour plus d’informations, consultez Empaquetage et déploiement de solutions SharePoint. |
| Deployment Root | 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 : NoDeployment : <aucune valeur> ElementManifest : <SharePointRoot>\Template\Features\<FeatureName>\ ElementFile : <SharePointRoot>\Template\Features\<FeatureName>\ 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
| Intitulé | 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. |
| Guide pratique pour 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’une colonne de site, d’un type de contenu et d’une liste pour SharePoint | Montre comment créer, étape par étape, un champ personnalisé, un type de contenu, une définition de liste et une instance de liste. |
| Guide pratique pour créer un récepteur d’événements | Décrit comment ajouter un récepteur d’événements pour le projet créé dans Procédure pas à pas : création d’une colonne de site, d’un type de contenu et d’une liste pour SharePoint. |
| Créer des solutions de workflow SharePoint | Explique comment créer des projets de flux de travail comportant des formulaires d'association et des formulaires d'initiation de flux de travail. |
| Créer des pages pour SharePoint | Explique comment créer des pages telles que des pages d'application, pages de site, pages maîtres et des mises en page pour SharePoint. |
| Créer des 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éer des contrôles réutilisables pour des composants WebPart ou des 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égrer des données métier dans SharePoint | Explique comment intégrer les données des services web et des applications serveur principales à une application SharePoint. |
| Créer des 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. |
| Parcourir les connexions SharePoint à l’aide de l’Explorateur de serveurs | Explique comment parcourir les sites SharePoint locaux à l'aide de l'Explorateur de serveurs. |
| Fournir des informations d’empaquetage et de déploiement dans les é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é. |
| Guide pratique pour ajouter et supprimer des dossiers mappés | Explique comment ajouter des dossiers mappés à votre projet pour 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 des considérations au sujet de la sécurité 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 d'accès aux ressources dans votre projet ou sur le serveur SharePoint local. |