Mettre à jour et gérer votre complément Office

Après avoir publié votre complément, vous devez le tenir à jour de toutes les modifications importantes apportées aux bibliothèques en amont. La correction des problèmes de sécurité est essentielle pour renforcer la confiance des clients. Étant donné que ces modifications n’ont aucun effet sur le manifeste publié, vos clients n’auront aucune action à entreprendre pour obtenir les dernières versions de votre complément.

Choisissez votre scénario

Changements cassants dans Office.js

Nous nous efforçons d’éviter d’apporter des modifications cassantes à la surface et au comportement de l’API. Toutefois, dans certains cas, nous devons effectuer des mises à jour de dernière minute pour des raisons de sécurité ou de fiabilité. Dans ces rares cas, les étapes suivantes sont effectuées pour vous assurer que les utilisateurs de votre complément ne sont pas affectés.

Stratégie de dépréciation

Certains outils peuvent être déconseillés lorsque quelque chose de mieux est disponible, et les API de la bibliothèque JavaScript Office (Office.js) disponibles en disponibilité générale peuvent être déconseillées lorsque leur tâche est mieux effectuée avec des API plus récentes. Microsoft fait de son mieux pour déclarer les dépréciations au moins 24 mois à l’avance. Le déclassement ne signifie pas nécessairement que la fonctionnalité ou l’API sera supprimée et inutilisable par les développeurs. Mais après 24 mois, Microsoft ne prendra plus en charge l’outil ou l’API, et l’outil peut être mis hors service et l’API peut être supprimée de la version GA de Office.js.

Lorsqu’une API est marquée comme déconseillée, nous vous recommandons vivement de migrer vers les API de remplacement dès que possible. Dans certains cas, nous annoncerons que les nouvelles applications doivent commencer à utiliser les nouvelles API peu de temps après la dépréciation des API d’origine. Dans ces cas, seules les applications actives qui utilisent actuellement les API déconseillées peuvent continuer à les utiliser.

Importante

La période de dépréciation de 24 mois sera accélérée si cette durée d’attente présente un risque pour la sécurité de votre complément ou de Microsoft.

Soutien aux applications

Le service Soutien aux applications de Microsoft répond à la promesse de Microsoft en matière de compatibilité des applications : vos applications fonctionneront sur Windows et Microsoft 365 Apps. Les ingénieurs d’App Assure sont disponibles pour vous aider à résoudre les problèmes que vous pourriez rencontrer sans frais supplémentaires.

Si vous rencontrez un problème de compatibilité d’application, les ingénieurs du soutien aux applications travaillent avec vous pour vous aider à le résoudre. Nos experts :

  • Vous aider à résoudre les problèmes et à identifier une cause racine.
  • Fournir des conseils pour vous aider à résoudre le problème de compatibilité des applications.
  • Engagez en votre nom des éditeurs de logiciels indépendants (ISV) pour corriger une partie de leur application, afin qu’elle soit fonctionnelle sur la version la plus moderne de nos produits.
  • Travaillez avec les équipes d’ingénierie des produits Microsoft pour corriger les bogues du produit.

Pour en savoir plus sur Soutien aux applications, regardez Apporter vos applications dans Microsoft Edge avec Soutien aux applications : conseils et astuces. Pour soumettre votre demande de compatibilité d’application avec Soutien aux applications, remplissez le formulaire d’inscription à Microsoft FastTrack ou envoyez un e-mail à achelp@microsoft.com.

Mettre à jour votre complément

Lorsque vous mettez à jour votre complément, il y a deux éléments à prendre en compte : l’application web et le package de complément, y compris le manifeste.

Mettre à jour l’application web

Les mises à jour de votre application web ne nécessitent aucune action de la part de vos utilisateurs. Chargez de nouveaux fichiers HTML, CSS, code et autres sur votre application web et vos CDN et vos utilisateurs commenceront automatiquement à voir les nouvelles fonctionnalités. Certains artefacts de complément, tels que les icônes de bouton, sont mis en cache lors de la première installation du complément. Les utilisateurs peuvent ne pas voir les icônes mises à jour initialement. Si les utilisateurs sont confus à l’affichage des anciennes icônes, la fermeture et la réouverture de l’application Office doivent entraîner le téléchargement de la dernière version des artefacts. Si cela ne se produit pas, vous pouvez leur indiquer comment fermer toutes les applications Office, puis vider le cache d’Office. Cette opération supprimera les artefacts mis en cache de tous les compléments installés, mais ils seront téléchargés de nouveau lors du prochain lancement de l’application Office, de sorte que le seul effet est un très léger retard dans l’affichage des icônes.

Mettre à jour les fichiers de package d’application

Les modifications apportées au manifeste ou à d’autres fichiers dans le package de l’application nécessitent que les utilisateurs effectuent une mise à jour. Si vous avez publié votre complément sur la Place de marché Microsoft, vous devez mettre à jour votre soumission. Vous trouverez plus d’informations sur ce processus dans l’article Mettre à jour une offre existante.

Chaque fois que vous apportez une modification au manifeste ou à un fichier du package d’application, vous devez augmenter le numéro de version du manifeste. (Cela inclut les modifications apportées aux URL dans le manifeste qui pointent vers des fichiers de configuration supplémentaires dans le package d’application, tels que les fichiers de configuration Copilot.)

  • Si le complément utilise le manifeste unifié, voir propriété de version.
  • Si le complément utilise uniquement le manifeste du complément (auquel cas il n’y a pas de package d’application), consultez Élément Version.

Si votre complément est déployé par un ou plusieurs administrateurs dans leur organisation, certaines modifications de manifeste nécessitent que l’administrateur donne son consentement aux mises à jour. L’accès des utilisateurs au complément est bloqué jusqu’à ce que le consentement soit accordé. Les modifications suivantes du manifeste nécessitent que l’administrateur donne à nouveau son consentement.

Sécuriser votre complément

Les projets de complément créés à l’aide du Yeoman Generator pour Office Les compléments ou Microsoft 365 Agents Toolkit s’appuient sur un certain nombre de bibliothèques de Microsoft et d’autres sociétés. Ces bibliothèques sont mises à jour indépendamment de toute activité Microsoft 365. Vos projets doivent être tenus à jour lorsque vous développez, publiez et gérez votre complément. Les outils suivants peuvent vous aider à vous assurer que votre projet utilise des versions sécurisées de toutes les bibliothèques dépendantes.

Ces conseils s’appliquent également aux copies des exemples tirés des compléments Office, des exemples de code et d’autres sources.

Résolution des problèmes

  • Mes utilisateurs ne peuvent pas accéder au complément mis à jour. Vérifiez que la version du manifeste a été incrémentée et la soumission Marketplace mise à jour.
  • Les boîtes de dialogue de consentement de l’Administration n’apparaissent pas. Vérifiez que les autorisations/étendues/événements ont réellement changé. Testez dans votre locataire de développement.

Engagement communautaire

Au fur et à mesure que des mises à jour sont proposées pour la plateforme développeur Microsoft 365, nous sommes attentifs aux commentaires. Veuillez signaler vos préoccupations, conséquences potentielles ou autres questions aux canaux répertoriés dans les ressources supplémentaires de Compléments Office.

Voir aussi

  • Dernière mise à jour :