Maintenir votre complément Office

  • Article

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.

Changements cassants dans Office.js

La plateforme de développement Microsoft 365 s’engage à garantir la compatibilité de votre complément. 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 API ou les outils avec de meilleures alternatives peuvent être déconseillés. Microsoft fait tout son possible pour déclarer un élément comme déconseillé au moins 24 mois avant sa mise hors service. De même, pour les API individuelles généralement disponibles, Microsoft estime qu’une API est hors service au moins 24 mois avant de la supprimer de la version GA.

La dépréciation ne signifie pas nécessairement que la fonctionnalité ou l’API sera supprimée et inutilisable par les développeurs. Il montre qu’après la période de 24 mois, Microsoft ne prendra plus en charge l’API ou la fonctionnalité.

Lorsqu’une API est marquée comme obsolète, nous vous recommandons vivement de migrer vers la dernière version 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, watch 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.

Modifications apportées aux modèles Yeoman et aux dépendances web

Le générateur Yeoman pour les compléments Office s’appuie 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. Tous les projets créés avec le générateur 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.

office.js package NPM

Le package NPM office-js est une copie de ce qui est hébergé sur le réseau de distribution de contenu (CDN)Office.js. Il est destiné aux scénarios où l’accès direct au CDN n’est pas possible. Le package NPM n’est pas destiné à fournir des références avec version à office.js. Nous vous recommandons vivement de toujours utiliser le CDN pour vous assurer que vous utilisez la dernière version des API JavaScript Office.

Bonnes pratiques actuelles

Bien que nous nous efforçons de maintenir la compatibilité descendante, les modèles et les pratiques que nous recommandons évoluent continuellement. Notre documentation s’efforce de présenter les meilleures pratiques actuelles. Pour rester informé des nouvelles fonctionnalités susceptibles d’améliorer vos fonctionnalités existantes, participez à notre appel de la communauté des compléments Office mensuel.

Déploiement de mises à jour

Lorsque vous ajoutez des fonctionnalités ou corrigez des bogues dans votre complément, vous devez déployer les mises à jour. 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 seront 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.

Remarque

Chaque fois que vous apportez une modification au manifeste, vous devez augmenter le numéro de version du manifeste.

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.