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 télécharger votre Complément SharePoint sur le Office Store public ou sur le catalogue de compléments d'une organisation. Un catalogue de compléments privé 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. Pour les administrateurs d'applications web ou les administrateurs locataires, il sera plus simple de limiter les autorisations d'accès au catalogue en plaçant celui-ci sur leur propre collection de données.

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.

Notes

Lorsque vous développez votre complément et le déployez avec Outils de développement Microsoft Office pour Visual Studio, le complément est directement installé sur le site SharePoint de test cible. Étant donné qu’il ne transite pas par l’Office Store, la vérification de validation décrite précédemment n’a pas lieu.

Le chargement d’un complément SharePoint dans le 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 remplissez un formulaire contextuel dans lequel vous fournissez l’URL locale du package de complément et d’autres informations, telles que le nom du complément. Lorsque le complément est chargé dans le catalogue de compléments d’une organisation, des vérifications similaires ont lieu et les compléments qui ne passent pas sont marqués comme non valides ou désactivés 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 qui nécessitent un prérequis qui n’est pas installé sur l’application web ou la location de l’administrateur apparaissent grisés et ne sont pas disponibles dans le magasin de compléments. Par exemple, si un complément nécessite les services de recherche et que ce dernier n’est pas installé, le complément apparaît grisé. Les administrateurs peuvent trier, filtrer et parcourir la liste des compléments, en savoir plus sur les compléments, consulter les révisions 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.

Notes

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 par le biais de l'interface utilisateur SharePoint. La désinstallation des instances de Compléments SharePoint est complète, à savoir que tous les composants installés par le complément sont désinstallés.

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.

Notes

Lorsqu’un utilisateur supprime un complément celui-ci est déplacé vers la Corbeille de la première étape. En le supprimant à partir de là, il est déplacée vers la Corbeille de la deuxième étape. S’il est supprimé de la corbeille de la deuxième étape, 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 inscrit dans le manifeste de complément du complément, s’exécute au début du processus de désinstallation (qui se produit lorsque le complément est supprimé de la deuxième étape Corbeille). Il est recommandé d’avoir un service web UninstallingEventEndpoint si vous disposez d’un service web InstalledEventEndpoint et de concevoir le service UninstallingEventEndpoint pour inverser tout ce qui est effectué dans votre service InstalledEventEndpoint. Pour plus d’informations, consultez Gérer les événements dans les compléments SharePoint.

Voir aussi