Versions d’Office et ensembles de conditions requises

  • Article

Il existe de nombreuses versions d’Office sur plusieurs plateformes, celles-ci ne prenant pas forcément en charge toutes les API dans l’interface API JavaScript pour Office (Office.js). Office 2013 sur Windows est la première version d’Office qui a pris en charge les compléments Office. Vous n’avez peut-être pas toujours le contrôle sur la version d’Office que vos utilisateurs ont installée. Pour gérer cette situation, nous fournissons un système appelé ensembles de conditions requises pour vous aider à déterminer si une application Office prend en charge les fonctionnalités dont vous avez besoin dans votre complément Office.

Remarque

  • Office s’exécute sur plusieurs plateformes, y compris sur Windows, dans un navigateur, un Mac et un iPad.
  • Les produits Office sont des exemples d’applications Office : Excel, Word, PowerPoint, Outlook, OneNote, etc.
  • Office est disponible avec un abonnement Microsoft 365 ou une licence perpétuelle. La version perpétuelle est disponible par contrat de licence en volume ou par vente au détail.
  • Un ensemble de conditions requises est un groupe nommé de membres d’API, par exemple, ExcelApi 1.5, WordApi 1.3et ainsi de suite.

Vérification de votre version d’Office

Pour identifier la version d’Office que vous utilisez, à partir d’une application Office, sélectionnez le menu Fichier, puis sélectionnez Compte. La version d’Office apparaît dans la section Informations sur le produit . Par exemple, la capture d’écran suivante indique la version 1802 d’Office (build 9026.1000).

Vérifier la version de votre Office.

Remarque

Si votre version d’Office est différente de celle-ci, voir Quelle version d’Outlook ai-je ? ou À propos d’Office : quelle version d’Office est-ce que j’utilise ? pour comprendre comment obtenir ces informations pour votre version.

Déploiement

La façon dont votre complément est déployé peut affecter la disponibilité de votre complément sur les différentes plateformes et clients. Pour en savoir plus sur les options de déploiement, voir Déployer et publier des compléments Office.

Disponibilité des ensembles de conditions requises Office

Les compléments Office peuvent utiliser des ensembles de conditions requises d’API pour déterminer si l’application Office prend en charge les membres de l’API qu’elle doit utiliser. La prise en charge de l’ensemble de conditions requises varie selon l’application Office et la version de l’application Office (voir la section précédente Comment case activée votre version d’Office).

Certaines applications Office ont leurs propres ensembles de conditions requises d’API. Par exemple, le premier ensemble de conditions requises pour l’API Excel était ExcelApi 1.1 et le premier ensemble de conditions requises pour l’API Word était WordApi 1.1. Depuis lors, de nombreux ensembles de conditions requises d’API Excel et d’API Word ont été ajoutés pour proposer des fonctionnalités d’API supplémentaires.

Par ailleurs, d’autres fonctionnalités telles que les commandes de complément (extensibilité du ruban) et la possibilité de lancer des boîtes de dialogue (API de boîte de dialogue) ont été ajoutées à l’API commune. Les commandes de complément et les ensembles de conditions requises de l’API de dialogue sont des exemples d’ensembles d’API que diverses applications Office partagent en commun.

Un complément peut uniquement utiliser des API dans les ensembles de conditions requises pris en charge par la version de l’application Office où le complément est en cours d’exécution. Pour savoir exactement quels ensembles de conditions requises sont disponibles pour une version d’application Office spécifique, reportez-vous aux articles suivants sur les ensembles de conditions requises spécifiques à l’application.

Certains ensembles de conditions requises contiennent des API qui peuvent être utilisées par plusieurs applications Office. Pour plus d’informations sur ces ensembles de conditions requises, consultez les articles suivants.

Le numéro de version d’un ensemble de conditions requises, tel que « 1.1 » dans ExcelApi 1.1, est relatif à l’application Office. Le numéro de version d’un ensemble de conditions requises donné (par exemple, ExcelApi 1.1) ne correspond pas au numéro de version de Office.js ou aux ensembles de conditions requises pour d’autres applications Office (par exemple, Word, Outlook, etc.). Les ensembles de conditions requises pour les différentes applications Office sont publiés à des tarifs différents. Par exemple, ExcelApi 1.5 a été publié avant l’ensemble de conditions requises WordApi 1.3.

L’API JavaScript pour la bibliothèque Office (Office.js) inclut tous les ensembles de conditions requises actuellement disponibles. Alors qu’il existe des ensembles de conditions requises ExcelApi 1.3 et WordApi 1.3, il n’existe pas d’ensemble de conditions requises Office.js 1.3. La dernière version d’Office.js est gérée comme un point de terminaison Office unique remis via le réseau de distribution de contenu (CDN). Pour plus d’informations sur le CDN Office.js, notamment sur la gestion des versions et de la compatibilité avec les anciennes versions, reportez-vous à l’article Présentation de l’API Interface JavaScript pour Office.

Spécifier les ensembles de conditions requises et les applications Office

Il existe différentes façons de spécifier les applications Office et les ensembles de conditions requises par un complément. Pour plus d’informations, voir Spécifier les applications Office et les exigences d’API

Voir aussi