Versions d’Office et ensembles de conditions requises
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.3
et 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).
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.
- Ensembles de conditions requises de l’API JavaScript pour Excel (ExcelApi)
- Ensembles de conditions requises de l’API JavaScript pour OneNote (OneNoteApi)
- Ensembles de conditions requises de l’API JavaScript Outlook (boîte aux lettres)
- Ensembles de conditions requises de l’API JavaScript pour PowerPoint (PowerPointApi)
- Ensembles de conditions requises de l’API JavaScript pour Word (WordApi)
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.
- Ensembles de conditions requises communes pour Office
- Ensembles de conditions requises concernant les commandes de complément
- Ensembles de conditions requises du service d’autorisation d’appareil
- Ensembles de conditions requises de l’API de boîte de dialogue
- Ensembles de conditions requises d’origine de boîte de dialogue
- Ensembles de conditions requises de l’API d’identité
- Ensembles de conditions requises de coercition d’image
- Ensembles de conditions requises pour les raccourcis clavier
- Ensembles de conditions requises pour l’authentification d’application imbriquée
- Séries de conditions requises pour ouvrir une fenêtre de navigateur
- Ensembles de conditions requises des API ruban
- Ensembles de conditions requises d'exécution partagés
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