Freigeben über

JavaScript-API-Anforderungssätze für Excel

  • Artikel

Anforderungssätze sind benannte Gruppen von API-Mitgliedern. Office-Add-Ins verwenden im Manifest angegebene Anforderungssätze oder ermitteln mithilfe einer Laufzeitüberprüfung, ob eine Office-Anwendung APIs unterstützt, die von einem Add-In benötigt werden. Weitere Informationen finden Sie unter Office-Versionen und Anforderungssätze.

Verfügbarkeit von Anforderungssätzen

Excel-Add-Ins sind in mehreren Versionen von Office lauffähig, einschließlich Office 2016 oder höher unter Windows sowie Office im Web, Office für Mac und Office für iPad. In der folgenden Tabelle sind die Excel-Anforderungssätze, die unterstützten Office-Clientanwendungen und ggf. die Mindestbuilds oder -versionen für diese Anwendungen aufgeführt.

Hinweis

Informationen zum Ausführen von APIs in einem der nummerierten Anforderungssätze oder ExcelApiOnline finden Sie in der Produktionsbibliothek im Content Delivery Network (CDN) von Office.js.

Informationen zur Verwendung der Vorschau-APIs finden Sie im Artikel Excel JavaScript-Vorschau APIs.

Anforderungssatz Office im Web Office unter Windows
  • Microsoft 365-Abonnement
  • retail unbefristet
 Office unter Windows
  • Volumenlizenz unbefristet
 Office für Mac Office auf dem iPad
Vorschau Verwenden Sie die neueste Office-Version, um Vorschau-APIs auszuprobieren (möglicherweise müssen Sie dem Microsoft 365 Insider-Programm beitreten).
ExcelApiOnline Neueste (siehe Anforderungssatzseite) Nicht zutreffend Nicht zutreffend Nicht zutreffend Nicht zutreffend
ExcelApi 1.17 Unterstützt Version 2302 (Build 16130.20332) Office 2024: Version 2302 (Build 16130.20332) Version 16.70 (23021201) Version 16.70
ExcelApi 1.16 Unterstützt Version 2208 (Build 15601.20148) Office 2024: Version 2208 (Build 15601.20148) Version 16.64 (22081401) Version 16.66
ExcelApi 1.15 Unterstützt Version 2202 (Build 14931.20132) Office 2024: Version 2202 (Build 14931.20132) Version 16.58 (22021501) Version 16.59
ExcelApi 1.14 Unterstützt Version 2108 (Build 14326.20508) Office 2021: Version 2108 (Build 14326.20508) Version 16.52 (21080801) Version 16.53
ExcelApi 1.13 Unterstützt Version 2102 (Build 13801.20738) Office 2021: Version 2102 (Build 13801.20738) Version 16.50 (21061301) Version 16.50
ExcelApi 1.12 Unterstützt Version 2008 (Build 13127.20408) Office 2021: Version 2008 (Build 13127.20408) Version 16.40 (20081000) Version 16.40
ExcelApi 1.11 Unterstützt Version 2002 (Build 12527.20470) Office 2021: Version 2002 (Build 12527.20470) Version 16.33 (20011301) Version 16.35
ExcelApi 1.10 Unterstützt Version 1907 (Build 11929.20306) Office 2021: Version 1907 (Build 11929.20306) Version 16.30 (19101301) Version 16.0
ExcelApi 1.9 Unterstützt Version 1903 (Build 11425.20204) Office 2021: Version 1903 (Build 11425.20204) Version 16.24 (19041401) Version 16.0
ExcelApi 1.8 Unterstützt Version 1808 (Build 10730.20102) Office 2021: Version 1808 (Build 10730.20102) Version 16.17 (18090901) Version 16.0
ExcelApi 1.7 Unterstützt Version 1801 (Build 9001.2171) Office 2019: Version 1801 (Build 9001.2171) Version 16.9 (18011602) Version 16.0
ExcelApi 1.6 Unterstützt Version 1704 (Build 8201.2001) Office 2019: Version 1704 (Build 8201.2001) Version 15.36 (17070200) Version 15.0
ExcelApi 1.5 Unterstützt Version 1703 (Build 8067.2070) Office 2019: Version 1703 (Build 8067.2070) Version 15.36 (17070200) Version 15.0
ExcelApi 1.4 Unterstützt Version 1701 (Build 7870.2024) Office 2019: Version 1701 (Build 7870.2024) Version 15.36 (17070200) Version 15.0
ExcelApi 1.3 Unterstützt Version 1608 (Build 7369.2055) Office 2019: Version 1608 (Build 7369.2055) Version 15.27 Version 15.0
ExcelApi 1.2 Unterstützt Version 1601 (Build 6741.2088) Office 2019: Version 1601 (Build 6741.2088) Version 15.22 Version 15.0
ExcelApi 1.1 Unterstützt Version 1509 (Build 4266.1001) Office 2016: Version 1509 (Build 4266.1001) Version 15.20 Version 15.0

Office-Versionen und Buildnummern

Weitere Informationen zu Office-Versionen und Buildnummern finden Sie unter:

Verwenden von Excel-Anforderungsgruppen zur Laufzeit und im Manifest

Hinweis

In diesem Abschnitt wird vorausgesetzt, dass Sie mit der Übersicht der Anforderungsgruppen auf Office-Versionen und Anforderungsgruppen vertraut sind und die Office-Anwendungen und API-Anforderungenangeben.

Anforderungssätze sind benannte Gruppen von API-Mitgliedern. Ein Office-Add-Ins kann eine Laufzeitüberprüfung durchführen oder die in der Manifestdatei angegebenen Anforderungssätze verwenden, um zu bestimmen, ob eine Office-Anwendung die APIs unterstützt, die das Add-In benötigt.

Überprüfen der Unterstützung der Anforderungssätze zur Laufzeit

Im folgenden Codebeispiel wird gezeigt, wie Sie ermitteln, ob die Office-Anwendung, in dem das Add-In ausgeführt wird, den angegebenen API-Anforderungssatz unterstützt.

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

Definieren der Unterstützung der Anforderungssätze in der Manifestdatei

Sie können das Anforderungselement in der Manifestdatei des Add-Ins verwenden, um die Mindesteinstellungen und/oder API-Methoden, die für die Aktivierung Ihrer Add-In erforderlich sind, festzulegen. Wenn die Office-Anwendung oder-Plattform die im Requirements -Element des Manifests angegebenen Anforderungsgruppen oder API-Methoden nicht unterstützt, wird das Add-In nicht in dieser Anwendung oder Plattform ausgeführt, und es wird nicht in der Liste der Add-Ins angezeigt, die in meine Add-Insangezeigt werden. Wenn das Add-In einen bestimmten Anforderungssatz für die vollständige Funktionalität erfordert, aber auch für Benutzer auf Plattformen, die die Anforderungsgruppe nicht unterstützen, einen Wert bieten kann, empfehlen wir, dass Sie die Anforderungsunterstützung zur Laufzeit überprüfen, wie oben beschrieben, anstatt die Anforderungssatz-Unterstützung im Manifest zu definieren.

Das folgende Codebeispiel zeigt das Requirements-Element in einer Add-In-Manifestdatei, das angibt, dass das Add-In in alle Office-Clientanwendungen geladen werden soll, welche die ExcelApi-Anforderungssatz-Version 1.3 oder höher unterstützen.

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

Siehe auch