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

Après avoir publié votre complément, vous devez le tenir à jour avec toutes les modifications importantes apportées aux bibliothèques amont. La mise à jour corrective des problèmes de sécurité est essentielle pour établir la confiance des clients. Étant donné que ces modifications n’ont aucun effet sur le manifeste publié, vos clients n’auront pas besoin d’effectuer des actions pour obtenir les dernières versions de votre complément.

Choisir votre scénario

Changements cassants dans Office.js

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

Stratégie de dépréciation

Les outils peuvent être déconseillés lorsque quelque chose de mieux est disponible, et les API de la bibliothèque JavaScript Office (Office.js) qui sont en disponibilité générale (GA) peuvent être déconseillées lorsque leur tâche est mieux effectuée avec des API plus récentes. Microsoft fait tout son possible pour déclarer les dépréciations au moins 24 mois à l’avance. La dépréciation 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 allons annoncer que les nouvelles applications doivent commencer à utiliser les nouvelles API peu de temps après que les API d’origine sont dépréciées. 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 une attente aussi longue pose un risque de sécurité pour votre complément ou Microsoft.

Soutien aux applications

Le service App Assure de Microsoft remplit la promesse de Compatibilité des applications de Microsoft : vos applications fonctionneront sur Windows et Microsoft 365 Apps. Les ingénieurs 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 App Assure travailleront avec vous pour vous aider à résoudre le problème. Nos experts :

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

Pour en savoir plus sur App Assure, regardez Apportez vos applications à Microsoft Edge avec App Assure : conseils et astuces. Pour soumettre votre demande de compatibilité des applications avec App Assure, 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

Mises à jour à votre application web ne nécessitent aucune action de la part de vos utilisateurs. Chargez de nouveaux fichiers HTML, CSS, code et autres dans 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 ne voient pas les anciennes icônes, la fermeture et la réouverture de l’application Office doivent entraîner le téléchargement de la version la plus récente des artefacts. Si ce n’est pas le cas, vous pouvez leur indiquer comment fermer toutes les applications Office, puis effacer le cache Office. Cela supprime les artefacts mis en cache de tous leurs compléments installés, mais ils sont à nouveau téléchargés lors du prochain lancement de l’application Office. Le seul effet de cette opération est donc 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 d’application nécessitent la mise à jour des utilisateurs. Si vous avez publié votre complément sur la Place de marché Microsoft, vous devez mettre à jour votre soumission. Pour plus d’informations sur ce processus, consultez l’article Mettre à jour une offre existante.

Chaque fois que vous apportez une modification au manifeste ou à un fichier dans le 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é, consultez la propriété version.
  • Si le complément utilise uniquement le manifeste du complément (auquel cas il n’existe aucun 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 consente aux mises à jour. Les utilisateurs sont bloqués du complément jusqu’à ce que leur consentement soit accordé. Les modifications de manifeste suivantes nécessitent que l’administrateur donne à nouveau son consentement.

Sécuriser votre complément

Les projets de complément créés avec le générateur Yeoman pour les compléments Office ou microsoft 365 Agents Toolkit s’appuient sur un certain nombre de bibliothèques de Microsoft et d’autres. Ces bibliothèques sont mises à jour indépendamment de toute activité Microsoft 365. Vos projets doivent être tenus à jour au fur et à mesure que vous développez, publiez et gérez votre complément. Les outils suivants peuvent vous aider à vérifier que votre projet utilise des versions sécurisées de toutes les bibliothèques dépendantes.

Ces conseils s’appliquent également aux copies d’exemples extraits des exemples de code du complément Office 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 que la soumission de la Place de marché a été mise à jour.
  • Administration boîtes de dialogue de consentement ne s’affichent pas. Vérifiez que les autorisations/étendues/événements ont réellement changé. Testez dans votre locataire de développement.

Engagement de la communauté

Étant donné que des mises à jour sont proposées pour la plateforme de développement Microsoft 365, nous serons à l’écoute des commentaires. Veuillez signaler les problèmes, les conséquences potentielles ou d’autres questions aux canaux répertoriés dans Compléments Office ressources supplémentaires.

Restez informé des nouvelles fonctionnalités et des meilleures pratiques en constante évolution grâce à notre appel de la communauté des compléments Office mensuel.

Voir aussi

  • Last updated on