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 unter Windows
– Microsoft 365-Abonnement
– Unbefristetes Office 2016 und höher im Einzelhandel		 Office unter Windows
(Volumenlizenz unbefristet)		 Office für Mac Office auf dem iPad Office im Web
Preview Verwenden Sie die neueste Office-Version, um Vorschau-APIs auszuprobieren (möglicherweise müssen Sie dem Microsoft 365 Insider-Programm beitreten).
ExcelApiOnline Nicht zutreffend Nicht zutreffend Nicht zutreffend Nicht zutreffend Neueste (siehe Anforderungssatzseite)
ExcelApi 1.17 Version 2302 (Build 16130.20332) Nicht verfügbar 16.70 16.70 Unterstützt
ExcelApi 1.16 Version 2208 (Build 15601.20148) Nicht verfügbar 16.64 16.66 Unterstützt
ExcelApi 1.15 Version 2202 (Build 14931.20132) Nicht verfügbar 16.58 16.59 Unterstützt
ExcelApi 1.14 Version 2108 (Build 14326.20508) Office 2021: Version 2108 (Build 14326.20508) 16.52 16.53 Unterstützt
ExcelApi 1.13 Version 2102 (Build 13801.20738) Office 2021: Version 2102 (Build 13801.20738) 16.50 16.50 Unterstützt
ExcelApi 1.12 Version 2008 (Build 13127.20408) Office 2021: Version 2008 (Build 13127.20408) 16.40 16.40 Unterstützt
ExcelApi 1.11 Version 2002 (Build 12527.20470) Office 2021: Version 2002 (Build 12527.20470) 16.33 16.35 Unterstützt
ExcelApi 1.10 Version 1907 (Build 11929.20306) Office 2021: Version 1907 (Build 11929.20306) 16.30 16.0 Unterstützt
ExcelApi 1.9 Version 1903 (Build 11425.20204) Office 2021: Version 1903 (Build 11425.20204) 16.24 16.0 Unterstützt
ExcelApi 1.8 Version 1808 (Build 10730.20102) Office 2021: Version 1808 (Build 10730.20102) 16.17 16.0 Unterstützt
ExcelApi 1.7 Version 1801 (Build 9001.2171) Office 2019: Version 1801 (Build 9001.2171) 16.9 16.0 Unterstützt
ExcelApi 1.6 Version 1704 (Build 8201.2001) Office 2019: Version 1704 (Build 8201.2001) 15.36 15.0 Unterstützt
ExcelApi 1.5 Version 1703 (Build 8067.2070) Office 2019: Version 1703 (Build 8067.2070) 15.36 15.0 Unterstützt
ExcelApi 1.4 Version 1701 (Build 7870.2024) Office 2019: Version 1701 (Build 7870.2024) 15.36 15.0 Unterstützt
ExcelApi 1.3 Version 1608 (Build 7369.2055) Office 2019: Version 1608 (Build 7369.2055) 15.27 15.0 Unterstützt
ExcelApi 1.2 Version 1601 (Build 6741.2088) Office 2019: Version 1601 (Build 6741.2088) 15.22 15.0 Unterstützt
ExcelApi 1.1 Version 1509 (Build 4266.1001) Office 2016: Version 1509 (Build 4266.1001) 15.20 15.0 Unterstützt

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