Ensembles de conditions requises de l’API JavaScript pour Excel

  • Article

Les ensembles de conditions requises sont des groupes nommés de membres d’API. Les compléments Office utilisent les ensembles de conditions requises spécifiés dans le manifeste ou utilisent une vérification de l’exécution pour déterminer si une application Office prend en charge les API requises par le complément. Pour plus d’informations, consultez Versions d’Office et ensembles de conditions requises.

Disponibilité d’ensemble de conditions requises

Les compléments Excel peuvent être exécutés dans différentes versions d’Office, notamment Office 2016 ou version ultérieure sur Windows, et Office sur le web, iPad et Mac. Le tableau suivant répertorie les ensembles de conditions requises Excel, les applications clientes Office prises en charge et les builds ou versions minimales pour ces applications, le cas échéant.

Remarque

Pour utiliser des API dans l’un des ensembles de conditions requises numérotées ou ExcelApiOnline, vous devez référencer la bibliothèque de production sur le réseau de distribution de contenu (CDN) Office.js.

Pour plus d’informations sur l’utilisation aperçu API, voir l’articleJavaScript d’Excel preview API.

Ensemble de conditions requises Office pour Windows
- Abonnement Microsoft 365
- vente au détail d’Office 2016 et versions ultérieures		 Office pour Windows
(licence en volume perpétuelle)		 Office sur Mac Office sur iPad Office sur le web
Aperçu Utilisez la dernière version d’Office pour essayer les API en préversion (vous devrez peut-être rejoindre le programme Microsoft 365 Insider).
ExcelApiOnline Non applicable Non applicable Non applicable Non applicable Dernière version (voir la page des ensembles de conditions requises)
ExcelApi 1.17 Version 2302 (build 16130.20332) Non disponible 16.70 16.70 Pris en charge
ExcelApi 1.16 Version 2208 (build 15601.20148) Non disponible 16.64 16.66 Pris en charge
ExcelApi 1.15 Version 2202 (Build 14931.20132) Non disponible 16.58 16.59 Pris en charge
ExcelApi 1.14 Version 2108 (Build 14326.20508) Office 2021 : Version 2108 (build 14326.20508) 16.52 16.53 Pris en charge
ExcelApi 1.13 Version 2102 (Build 13801.20738) Office 2021 : Version 2102 (build 13801.20738) 16.50 16.50 Pris en charge
ExcelApi 1.12 Version 2008 (build 13127.20408) Office 2021 : version 2008 (build 13127.20408) 16.40 16.40 Pris en charge
ExcelApi 1.11 Version 2002 (build 12527.20470) Office 2021 : Version 2002 (build 12527.20470) 16.33 16.35 Pris en charge
ExcelApi 1.10 Version 1907 (build 11929.20306) Office 2021 : Version 1907 (build 11929.20306) 16.30 16.0 Pris en charge
ExcelApi 1.9 Version 1903 (build 11425.20204) Office 2021 : Version 1903 (build 11425.20204) 16.24 16.0 Pris en charge
ExcelApi 1.8 Version 1808 (build 10730.20102) Office 2021 : Version 1808 (build 10730.20102) 16.17 16.0 Pris en charge
ExcelApi 1.7 Version 1801 (build 9001.2171) Office 2019 : version 1801 (build 9001.2171) 16.9 16.0 Pris en charge
ExcelApi 1.6 Version 1704 (build 8201.2001) Office 2019 : version 1704 (build 8201.2001) 15.36 15.0 Pris en charge
ExcelApi 1.5 Version 1703 (build 8067.2070) Office 2019 : version 1703 (build 8067.2070) 15.36 15.0 Pris en charge
ExcelApi 1.4 Version 1701 (build 7870.2024) Office 2019 : version 1701 (build 7870.2024) 15.36 15.0 Pris en charge
ExcelApi 1.3 Version 1608 (build 7369.2055) Office 2019 : Version 1608 (build 7369.2055) 15.27 15.0 Pris en charge
ExcelApi 1.2 Version 1601 (build 6741.2088) Office 2019 : version 1601 (build 6741.2088) 15.22 15.0 Pris en charge
ExcelApi 1.1 Version 1509 (build 4266.1001) Office 2016 : version 1509 (build 4266.1001) 15.20 15.0 Pris en charge

Numéros de version et de build d’Office

Pour plus d’informations sur les versions et les numéros de build d’Office, voir :

Utiliser les conditions requises Excel au moment de l’exécution et dans le manifeste

Remarque

Cette section suppose que vous êtes familiarisé avec les rubriques Versions d’Office et ensembles de conditions requises et Spécifier les applications Office et les exigences de l’API.

Les ensembles de conditions requises sont des groupes nommés de membres d’API. Le complément Office peut effectuer une vérification à l’exécution ou utiliser des ensembles de conditions requises spécifiés dans le manifeste pour déterminer si une application Office prend en charge les API requises par le complément.

Vérification de la prise en charge de l’ensemble de conditions requises à l’exécution

L’exemple de code suivant montre comment déterminer si l’application Office dans laquelle le complément est en cours d’exécution prend en charge l’ensemble spécifié de conditions requises pour l’API.

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

Définition de la prise en charge de l’ensemble de conditions requises dans le manifeste

Vous pouvez utiliser l’élément Requirements dans le manifeste de complément pour spécifier les ensembles de conditions requises minimales et/ou les méthodes d’API que votre complément doit activer. Si la plateforme ou l’application Office ne prend pas en charge les ensembles de conditions requises ou les méthodes d’API spécifiées dans l’élément Requirements du manifeste, le complément ne s’exécute pas dans cette application ou plateforme et ne s’affiche pas dans la liste de compléments dans Mes compléments.Si votre complément requiert une configuration spécifique pour les fonctionnalités complètes, mais qu’il peut fournir une valeur même pour les utilisateurs sur les plateformes qui ne prennent pas en charge la condition requise, nous vous recommandons de vérifier la prise en charge des exigences au moment de l’exécution, comme décrit ci-dessus, au lieu de définir la prise en charge de la condition requise dans le manifeste.

L’exemple de code suivant montre l’élément Requirements dans un manifeste indiquant que le complément doit être chargé dans toutes les applications clientes Office prenant en charge l’ensemble de conditions requises ExcelApi version 1.3 ou ultérieure.

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>

Voir aussi