Ensembles de conditions requises de l’API JavaScript pour Excel

Article
11/13/2024

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 sur le web	Office pour Windows Abonnement Microsoft 365 vente au détail perpétuelle	Office pour Windows licence en volume perpétuelle	Office sur Mac	Office sur iPad
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	Dernière version (voir la page des ensembles de conditions requises)	Non applicable	Non applicable	Non applicable	Non applicable
ExcelApi 1.17	Pris en charge	Version 2302 (Build 16130.20332)	Office 2024 : version 2302 (build 16130.20332)	Version 16.70 (23021201)	Version 16.70
ExcelApi 1.16	Pris en charge	Version 2208 (Build 15601.20148)	Office 2024 : version 2208 (build 15601.20148)	Version 16.64 (22081401)	Version 16.66
ExcelApi 1.15	Pris en charge	Version 2202 (Build 14931.20132)	Office 2024 : Version 2202 (build 14931.20132)	Version 16.58 (22021501)	Version 16.59
ExcelApi 1.14	Pris en charge	Version 2108 (Build 14326.20508)	Office 2021 : Version 2108 (build 14326.20508)	Version 16.52 (21080801)	Version 16.53
ExcelApi 1.13	Pris en charge	Version 2102 (Build 13801.20738)	Office 2021 : Version 2102 (build 13801.20738)	Version 16.50 (21061301)	Version 16.50
ExcelApi 1.12	Pris en charge	Version 2008 (build 13127.20408)	Office 2021 : version 2008 (build 13127.20408)	Version 16.40 (20081000)	Version 16.40
ExcelApi 1.11	Pris en charge	Version 2002 (build 12527.20470)	Office 2021 : Version 2002 (build 12527.20470)	Version 16.33 (20011301)	Version 16.35
ExcelApi 1.10	Pris en charge	Version 1907 (build 11929.20306)	Office 2021 : Version 1907 (build 11929.20306)	Version 16.30 (19101301)	Version 16.0
ExcelApi 1.9	Pris en charge	Version 1903 (build 11425.20204)	Office 2021 : Version 1903 (build 11425.20204)	Version 16.24 (19041401)	Version 16.0
ExcelApi 1.8	Pris en charge	Version 1808 (build 10730.20102)	Office 2021 : Version 1808 (build 10730.20102)	Version 16.17 (18090901)	Version 16.0
ExcelApi 1.7	Pris en charge	Version 1801 (build 9001.2171)	Office 2019 : version 1801 (build 9001.2171)	Version 16.9 (18011602)	Version 16.0
ExcelApi 1.6	Pris en charge	Version 1704 (build 8201.2001)	Office 2019 : version 1704 (build 8201.2001)	Version 15.36 (17070200)	Version 15.0
ExcelApi 1.5	Pris en charge	Version 1703 (build 8067.2070)	Office 2019 : version 1703 (build 8067.2070)	Version 15.36 (17070200)	Version 15.0
ExcelApi 1.4	Pris en charge	Version 1701 (build 7870.2024)	Office 2019 : version 1701 (build 7870.2024)	Version 15.36 (17070200)	Version 15.0
ExcelApi 1.3	Pris en charge	Version 1608 (build 7369.2055)	Office 2019 : version 1608 (build 7369.2055)	Version 15.27	Version 15.0
ExcelApi 1.2	Pris en charge	Version 1601 (build 6741.2088)	Office 2019 : version 1601 (build 6741.2088)	Version 15.22	Version 15.0
ExcelApi 1.1	Pris en charge	Version 1509 (build 4266.1001)	Office 2016 : version 1509 (build 4266.1001)	Version 15.20	Version 15.0

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>

Partager via