Mettre à jour les composants WebPart hôtes dans SharePoint
Avant de commencer, familiarisez-vous avec la mise à jour des compléments SharePoint, ainsi que les conditions préalables et les concepts fondamentaux répertoriés qu’elle contient.
Votre complément peut installer deux types de composants sur un site web hôte avec un balisage descriptif dans le complément SharePoint : des actions personnalisées et des composants de complément. La mise à jour de ces composants est plus facile sur le site web hôte que sur le site web de complément. Vous n’avez pas besoin de sémantique de mise à jour. Il suffit d’ajouter ou de modifier les actions personnalisées et les composants de complément. Lorsque le complément SharePoint est mis à jour, SharePoint applique toujours les nouveaux fichiers manifestes d’élément et applique à nouveau les fichiers manifestes d’élément ayant été modifiés avec la version la plus récente. Les réapplications ne perturberont pas l’application. Par exemple, un bouton du ruban pour une action personnalisée ne sera pas ajouté plusieurs fois.
Lorsque vous mettez à jour un composant de complément, SharePoint remplace l’ancienne version par la nouvelle version dans la galerie de composants WebPart. N'oubliez pas de changer la propriété Name de l'objet ClientWebPart lorsque vous mettez à jour un composant de complément. Ceci garantit que, lorsque le complément est mis à jour, SharePoint supprime l'ancienne version du composant de complément (qui ne fait plus partie de l'application) de toutes les pages auxquelles elle avait été ajoutée. Les utilisateurs devront ajouter de nouveau la nouvelle version aux pages.
Si vous laissez la propriété Name inchangée, l'ancienne version reste sur les pages où elle a été ajoutée, ce qui risque d'empêcher les utilisateurs de voir qu'une nouvelle version du composant de complément est disponible. De plus, lorsque le composant de complément est ajouté à d'autres pages, c'est sa nouvelle version qui est ajoutée ; la même version d'un Complément SharePoint risque donc de comporter des composants de complément différents selon les pages.
Vous pouvez déployer d’autres types de composants web hôtes par programmation, en enregistrant un récepteur d’événements distant dans le manifeste de complément avec un élément InstalledEventEndpoint. Vous devez utiliser un récepteur UpgradedEventEndpoint pour mettre à jour les composants initialement déployés avec un récepteur InstalledEventEndpoint. Les récepteurs UpgradedEventEndpoint sont décrits dans Créer un gestionnaire pour l’événement de mise à jour dans les compléments SharePoint.
Étapes suivantes
Accédez à la section Étapes principales de mise à jour d’un complément ou consultez directement l’un des articles suivants pour découvrir comment mettre à jour le prochain composant majeur de votre complément SharePoint.
- Mettre à jour des composants de sites web de complément dans SharePoint
- Créer un gestionnaire pour l'événement de mise à jour dans des compléments pour SharePoint
- Mettre à jour les composants distants dans des compléments SharePoint