Packager et déployer des solutions SharePoint
En règle générale, une solution SharePoint est déployée sur un serveur SharePoint en utilisant un fichier de package de solution (.wsp). Vous pouvez utiliser Visual Studio pour organiser vos éléments de projet SharePoint en fonctionnalités et pour créer un package afin de déployer vos fonctionnalités SharePoint.
Cette rubrique fournit les informations suivantes :
Créer des fonctionnalités et des packages
Vous pouvez utiliser Visual Studio pour regrouper des éléments SharePoint associés dans une fonctionnalité. Par exemple, une fonctionnalité pour une définition de liste Contacts peut comprendre l’instance de liste et la définition de liste. Vous pouvez combiner ces deux éléments en une seule fonctionnalité pour le déploiement. Pour plus d’informations sur les fonctionnalités, consultez Composants : fonctionnalités.
Ensuite, vous pouvez créer un package de solution SharePoint (.wsp) pour regrouper plusieurs fonctionnalités, définitions de site, assemblys et d’autres fichiers dans un seul package, qui stocke les fichiers au format demandé par SharePoint pour déployer les fichiers sur le serveur. Pour plus d’informations, consultez Composants : solutions.
Prise en charge des outils de package et de fonctionnalité
Vous pouvez utiliser les outils de développement SharePoint dans Visual Studio pour organiser rapidement vos fichiers SharePoint en fonctionnalités et packages de solution afin de faciliter le déploiement. Vous pouvez utiliser les outils suivants pour configurer la fonctionnalité et le package de solution.
Concepteur de fonctionnalités et concepteur de package.
Explorateur de packages, fenêtre Outil.
Explorateur de solutions.
Concepteur de fonctionnalités et concepteur de package
Vous pouvez créer des fonctionnalités, définir des étendues et marquer d’autres fonctionnalités comme des dépendances en utilisant le Concepteur de fonctionnalités. Le concepteur affiche également le fichier XML final qui décrit chaque fonctionnalité. Pour plus d’informations, consultez Créer des fonctionnalités SharePoint.
Appliquez la fonctionnalité à un site web spécifique ou à un groupe de sites web en définissant son étendue dans le Concepteur de fonctionnalités. Si une fonctionnalité est activée pour un site web individuel, la fonctionnalité fonctionne uniquement dans ce site web particulier. Si une fonctionnalité est activée pour une collection de sites, les éléments de la fonctionnalité s’appliquent à l’ensemble de la collection de sites. Pour plus d’informations, consultez Étendue d’élément.
Si votre fonctionnalité dépend d’autres fonctionnalités, vous pouvez définir une dépendance d’activation de fonctionnalité pour marquer les fonctionnalités dépendantes avant de rendre votre fonctionnalité disponible. Une dépendance d’activation de fonctionnalité vérifie si les fonctionnalités dépendantes sont déjà activées dans cette étendue. Pour plus d’informations, consultez Dépendances d’activation et étendue.
Dans le Concepteur de package, vous pouvez regrouper des éléments SharePoint dans un seul package de solution et configurer s’il faut réinitialiser le serveur web pendant le déploiement. Pour définir le type de serveur de déploiement, utilisez la fenêtre Propriétés. Le concepteur génère également le fichier XML qui décrit le contenu du package. Pour plus d’informations, consultez Créer des packages de solution SharePoint.
Pendant le déploiement, le service IIS (Internet Information Services) est arrêté pour copier les fichiers solution sur le serveur SharePoint. En utilisant le Concepteur de package dans Visual Studio, vous pouvez sélectionner si le serveur web doit être redémarré. Pour configurer si la solution est déployée sur un serveur web front-end ou un serveur d’applications, utilisez la fenêtre Propriétés. Pour plus d’informations, consultez Élément de solution (solution).
Explorateur de packages
Pour compléter le concepteur de fonctionnalités et le concepteur de package, vous pouvez utiliser l’Explorateur de packages afin de regrouper vos fichiers SharePoint en fonctionnalités et packages. Par ailleurs, vous pouvez voir la vue hiérarchique du package, des fonctionnalités, des éléments de projet SharePoint et des fichiers. L’Explorateur de packages est une fenêtre Outil que vous pouvez utiliser pour effectuer les tâches suivantes :
Ouvrir des éléments et fichiers de projet SharePoint.
Faire un glisser-déposer des éléments de projet SharePoint entre des fonctionnalités.
Faire un glisser-déposer des éléments de projet SharePoint et des fonctionnalités entre des packages.
Ajouter une nouvelle fonctionnalité à un package.
Ouvrir le concepteur de fonctionnalités ou de package.
Valider des fonctionnalités et des packages.
Les outils de développement SharePoint dans Visual Studio ont des règles de validation pour vérifier que le package de solution est correctement formé. Par ailleurs, les règles vérifient que le fichier solution .wsp peut être déployé et activé sur un serveur SharePoint. Pour plus d’informations sur le schéma XML des fonctionnalités, consultez Schémas de fonctionnalité.
Vous pouvez ajouter des règles de validation de fonctionnalité et de package personnalisées au système de projet SharePoint. Pour plus d’informations, consultez Guide pratique pour créer des règles de validation de fonctionnalité et de package personnalisées pour les solutions SharePoint.
Pour plus d’informations sur l’Explorateur de packages, consultez Guide pratique pour ajouter et supprimer des fonctionnalités et des éléments dans un package en utilisant l’Explorateur de packages.
Explorateur de solutions
Vous pouvez utiliser l’Explorateur de solutions pour rechercher et ouvrir les fichiers du projet SharePoint. Utilisez le menu contextuel de l’Explorateur de solutions pour ajouter des fonctionnalités, des récepteurs d’événements de fonctionnalité et des ressources de fonctionnalité. Par ailleurs, vous pouvez ouvrir les concepteurs de fonctionnalités et les concepteurs de package pour configurer les fonctionnalités et les packages pour le déploiement.
Déployer des solutions SharePoint
Après avoir personnalisé les fonctionnalités et le package dans Visual Studio, vous pouvez créer un fichier .wsp à déployer sur des serveurs SharePoint. Vous pouvez utiliser Visual Studio pour déboguer et tester le fichier .wsp uniquement sur le serveur SharePoint de l’ordinateur de développement. Pour plus d’informations sur le déploiement de vos solutions SharePoint sur un serveur SharePoint distant, consultez Déploiement d’une solution.
Vous pouvez également personnaliser les étapes de déploiement sur l’ordinateur de développement. Pour plus d’informations, consultez Déployer, publier et mettre à niveau des packages de solution SharePoint.
Déployer des fichiers dans des solutions SharePoint
En règle générale, quand vous ajoutez un élément de projet SharePoint à votre solution SharePoint, tous les fichiers nécessaires sont inclus. Les fichiers qui peuvent être compilés (fichiers de code) sont intégrés à l’assembly de sortie de la solution. Toutefois, vous devez peut-être également ajouter des fichiers non compilables, par exemple, des fichiers .xml, .txt ou des fichiers de ressources à un projet SharePoint. Ces fichiers ne sont pas automatiquement packagés dans votre solution. Pour qu’ils soient packagés, ajoutez-les à un dossier mappé ou à un élément de projet SharePoint.
Les fichiers ajoutés aux dossiers mappés sont automatiquement copiés dans la ruche SharePoint pendant le déploiement de la solution. Les fichiers ajoutés à un élément de projet SharePoint sont déployés à l’emplacement spécifié dans la propriété Emplacement de déploiement pour chaque fichier, qui est partiellement défini en fonction de la propriété Type de déploiement. Par défaut, la valeur de la propriété Type de déploiement est NoDeployment, ce qui signifie que le fichier n’est pas déployé avec la solution. Vous devez définir une autre valeur pour la propriété afin d’ajouter le fichier au package.
Par exemple, pour ajouter un fichier .xml à un projet SharePoint, effectuez l’une des actions suivantes :
Ajoutez un dossier mappé SharePoint « Layouts » à votre projet. Cela crée dans l’Explorateur de solutions un dossier nommé Layouts qui a un sous-dossier pour le projet. Ajoutez le fichier .xml au nouveau sous-dossier. Par défaut, le fichier est déployé sur le système de fichiers SharePoint sous ..\TEMPLATE\LAYOUTS\<Nom du dossier>. Pour plus d’informations sur l’ajout de dossiers mappés, consultez Guide pratique pour ajouter et supprimer des dossiers mappés.
Ajoutez le fichier .xml au dossier d’un élément de projet SharePoint, puis changez la propriété Type de déploiement du fichier .xml en remplaçant NoDeployment par un autre paramètre de type RootFile ou ElementFile. Le paramètre Type de déploiement approprié dépend du fichier et du projet. Pour plus d’informations sur les paramètres de la propriété Type de déploiement, consultez Développer des solutions SharePoint.
Si un fichier ajouté ne s’applique à aucun projet spécifique dans la solution, vous pouvez ajouter un projet SharePoint vide à votre solution, puis y ajouter les fichiers supplémentaires. Une autre alternative pour déployer des fichiers sur SharePoint, en particulier dans la base de données de contenu, est d’ajouter un module au projet, puis d’ajouter les fichiers au module. Pour plus d’informations, consultez Utiliser des modules pour ajouter des fichiers à la solution.