Déploiement et installation de compléments pour SharePoint : méthodes et options
Dans cet article, vous allez découvrir les solutions pour publier votre complément SharePoint, et apprendre à l’installer et à le désinstaller.
Publier sur Office Store ou le catalogue de compléments d’une organisation
Vous pouvez charger votre complément SharePoint dans l’Office Store public ou dans le catalogue de compléments privés d’une organisation. Un catalogue de compléments privés est une collection de sites dédiée dans une application web SharePoint (ou une location SharePoint Online) qui héberge des bibliothèques de documents pour les compléments SharePoint et les compléments Office. Le fait de placer le catalogue dans sa propre collection de sites permet à l’administrateur d’application web ou à l’administrateur client de limiter plus facilement les autorisations sur le catalogue.
Si le complément est téléchargé sur le Office Store, Microsoft exécute des contrôles de validation sur celui-ci. Par exemple, il vérifie si le balisage du manifeste du complément est valide et complet, et il vérifie qu'aucun des packages de solution SharePoint (fichiers .wsp) inclus ne comporte d'éléments non autorisés ni de fonctionnalités d'étendue plus large que Web. Le package est également inspecté pour vérifier qu'il ne comporte pas de contenu répréhensible. Si le complément satisfait à tous ces tests, le package de compléments est encapsulé dans un fichier et signé par Microsoft.
Remarque
Quand vous développez votre complément et le déployez avec les Outils de développement Microsoft Office pour Visual Studio, le complément est installé directement sur le site SharePoint de test cible. Comme il ne passe pas par l’Office Store, le contrôle de validation décrit ci-dessus ne se produit pas.
Le chargement d’un complément SharePoint dans un catalogue de compléments d’une organisation est aussi simple que le chargement de n’importe quel fichier dans une bibliothèque de documents SharePoint Foundation. Vous devez remplir un formulaire contextuel dans lequel vous indiquez l’URL locale du package du complément et d’autres informations comme le nom du complément. Quand le complément est chargé dans le catalogue de compléments d’une organisation, il est également vérifié. S’il ne réussit pas les tests, il est marqué comme non valide ou désactivé dans le catalogue.
Les administrateurs clients et les administrateurs d’application web SharePoint peuvent acheter des compléments SharePoint sur l’Office Store. Pour ouvrir l’Office Store, l’administrateur sélectionne Ajouter un complément sur la page Contenu du site, puis SharePoint Store sur la page Vos compléments. S’ouvre alors une page SharePoint Store où les administrateurs peuvent découvrir les compléments SharePoint proposés par les fournisseurs et en savoir plus à leur sujet (ils peuvent également le faire sur office.com).
Les compléments nécessitant un composant préalable qui n’est pas installé sur le client ou l’application web de l’administrateur sont estompés et ne sont pas disponibles dans le magasin de compléments. Par exemple, si un complément qui nécessite des services Search qui ne sont pas installés, le complément est estompé. Les administrateurs peuvent trier, filtrer et parcourir la liste des compléments, consulter les informations et les évaluations des compléments, et acheter des licences pour un complément.
Lorsqu'un administrateur décide d'acheter une licence, il doit accepter les termes et conditions d'achat ainsi que les autorisations dont doit disposer le complément pour pouvoir s'exécuter (accès en lecture aux listes ou accès en contrôle total à la collection de sites).
Si une ou plusieurs licences de complément sont achetées, elles sont téléchargées sur la location ou l'application web. Le complément n'est pas automatiquement téléchargé et installé lorsque la licence est achetée, même si les administrateurs peuvent combiner l'installation avec un achat de licences.
Les utilisateurs installent les compléments à partir de la page Vos compléments. Cette page dispose des listes issues de la fusion des éléments suivants :
- Compléments SharePoint à partir du catalogue de compléments de l’organisation (ou du client) de l’application web.
- Compléments SharePoint de l’Office Store pour lequel l’organisation ou le client possède déjà une licence de site ou une licence ayant été attribuée à l’utilisateur.
Tous les compléments que l’utilisateur peut installer immédiatement sont répertoriés. Les utilisateurs peuvent filtrer les compléments figurant sur la page pour afficher uniquement les compléments du catalogue de compléments de l’organisation. Quand un complément est installé, il apparaît dans la liste des compléments sur la page Contenu du site du site web où il est installé.
Installer des compléments SharePoint
Les propriétaires de sites web peuvent installer des Compléments SharePoint à partir de la page Vos compléments, tel que décrit précédemment dans cette rubrique. L'installation crée une instance du complément. Pour plus d'informations sur l'installation de compléments, voir Ajouter des compléments SharePoint à un site SharePoint.
Remarque
La perte temporaire de la connexion réseau peut parfois bloquer l’installation. Si celle-ci échoue pour une raison ou une autre, son infrastructure effectuera trois tentatives. Si ces dernières échouent, un indicateur d'échec apparaît sur l'interface utilisateur. Les utilisateurs pourront effectuer ultérieurement une nouvelle tentative d’installation.
Désinstaller des compléments SharePoint
Les propriétaires de sites web peuvent désinstaller une instance d’un complément SharePoint via l’interface utilisateur SharePoint. La désinstallation d’une instance d’un complément SharePoint est propre. Cela signifie que tout ce qui est installé par le complément est désinstallé.
En revanche, les composants utilisés par un complément qui sont installés séparément ne sont pas supprimés. Supposons, par exemple, qu’un complément possède une page web distante dotée de boutons qui créent des listes sur le site web hôte. La désinstallation du complément supprime la vignette du complément de la page Contenu du site, ce qui rend la page distante inaccessible ou inutilisable par les utilisateurs, sans supprimer les listes créées avec le complément. Comme SharePoint ne sait pas quelles listes du site web hôte ont été créées avec le complément ou par les utilisateurs dans l’interface SharePoint, il ne peut pas supprimer les listes créées avec le complément. Et heureusement, car les listes peuvent contenir des données qui peuvent toujours servir aux utilisateurs même après la suppression du complément qui les a créées.
Si le Complément SharePoint comporte un site web de complément, celui-ci est supprimé. Cette désinstallation est plus complète que la désactivation systématique des fonctionnalités et l'inversion du déploiement du fichier .wsp interne du complément.
Remarque
Quand un utilisateur supprime un complément, celui-ci est déplacé vers la corbeille de premier niveau. Quand il est supprimé de la corbeille de premier niveau, il est déplacé dans la corbeille de second niveau. Quand il supprimé de la corbeille de second niveau, il est complètement désinstallé et ne peut pas être restauré.
Les autorisations du complément sont également révoquées lorsqu’il est supprimé (recyclage), conformément aux règles suivantes :
- Les autorisations relatives au web sont toujours révoquées.
- S'il n'existe aucune autre instance du complément dans la collection de sites, les autorisations relatives aux collections de sites sont également révoquées.
- S’il n’existe aucune autre instance du complément dans l’abonnement au site (client), les autorisations d’étendue client sont également révoquées.
Le service web UninstallingEventEndpoint, s’il est enregistré dans le manifeste du complément, s’exécute au début du processus de désinstallation (c’est-à-dire quand le complément est supprimé de la corbeille de second niveau). Nous vous recommandons de vous doter d’un service web UninstallingEventEndpoint si vous disposez déjà d’un service web InstalledEventEndpoint et de concevoir le service UninstallingEventEndpoint pour vous permettre d’inverser toutes les actions effectuées par le service InstalledEventEndpoint. Pour plus d’informations, consultez la section Gestion des événements dans les compléments SharePoint.