Office-Versionen und Anforderungssätze
Es gibt viele Versionen von Office auf verschiedenen Plattformen, und nicht alle unterstützen jede API in der JavaScript-API für Office (Office.js). Office 2013 unter Windows war die früheste Version von Office, die Office-Add-Ins unterstützte. Möglicherweise haben Sie nicht immer die Kontrolle über die Version von Office, die Ihre Benutzer installiert haben. Um diese Situation zu bewältigen, stellen wir ein System namens Anforderungssätze bereit, mit dem Sie ermitteln können, ob eine Office-Anwendung die Funktionen unterstützt, die Sie in Ihrem Office-Add-In benötigen.
Hinweis
- Office wird auf mehreren Plattformen ausgeführt, darunter Windows, in einem Browser, Mac und iPad.
- Beispiele für Office-Anwendungen sind Office-Produkte: Excel, Word, PowerPoint, Outlook, OneNote usw.
- Office ist über ein Microsoft 365-Abonnement oder eine unbefristete Lizenz verfügbar. Die unbefristete Version ist per Volumenlizenzvertrag oder Einzelhandel verfügbar.
- Ein Anforderungssatz ist eine benannte Gruppe von API-Mitgliedern,
ExcelApi 1.5
z. B. ,WordApi 1.3
usw.
Überprüfen Ihrer Office-Version
Um die Office-Version zu identifizieren, die Sie verwenden, wählen Sie in einer Office-Anwendung das Menü Datei und dann Konto. Die Version von Office wird im Abschnitt Produktinformationen angezeigt. Der folgende Screenshot zeigt z. B. Office Version 1802 (Build 9026.1000).
Hinweis
Wenn sich Ihre Version von Office von dieser unterscheidet, lesen Sie Welche Version von Outlook habe ich? oder Informationen zu Office: Welche Version von Office verwende ich? , um zu verstehen, wie Sie diese Informationen für Ihre Version abrufen.
Bereitstellung)
Die Bereitstellung Ihres Add-Ins kann sich auf die Verfügbarkeit Ihres Add-Ins auf den verschiedenen Plattformen und Clients auswirken. Weitere Informationen zu Bereitstellungsoptionen finden Sie unter Bereitstellen und Veröffentlichen von Office-Add-Ins.
Verfügbarkeit von Office-Anforderungssätzen
Office-Add-Ins können API-Anforderungssätze verwenden, um zu bestimmen, ob die Office-Anwendung die api-Member unterstützt, die sie verwenden muss. Die Unterstützung von Anforderungsmappen variiert je nach Office-Anwendung und Office-Anwendungsversion (siehe weiter oben im Abschnitt Überprüfen Ihrer Office-Version).
Einige Office-Anwendungen verfügen über eigene API-Anforderungssätze. Beispielsweise war ExcelApi 1.1
der erste Anforderungssatz für die Excel-API, und der erste Anforderungssatz für die Word-API war WordApi 1.1
. Seitdem wurden mehrere neue ExcelApi-Anforderungssätze und WordApi-Anforderungssätze hinzugefügt, um zusätzliche API-Funktionen bereitzustellen.
Darüber hinaus wurden der allgemeinen API weitere Funktionen wie Add-In-Befehle (Erweiterbarkeit des Menübands) und die Möglichkeit zum Starten von Dialogfeldern (Dialog-API) hinzugefügt. Add-In-Befehle und Dialog-API-Anforderungssätze sind Beispiele für API-Sätze, die von verschiedenen Office-Anwendungen gemeinsam verwendet werden.
Ein Add-In kann nur APIs in Anforderungssätzen verwenden, die von der Version der Office-Anwendung unterstützt werden, in der das Add-In ausgeführt wird. Um genau zu wissen, welche Anforderungssätze für eine bestimmte Office-Anwendungsversion verfügbar sind, lesen Sie die folgenden Artikel zu anwendungsspezifischen Anforderungssätzen.
- JavaScript-API-Anforderungssätze für Excel (ExcelApi)
- JavaScript-API-Anforderungssätze für OneNote (OneNoteApi)
- Outlook JavaScript-API-Anforderungssätze (Postfach)
- JavaScript-API-Anforderungssätze für PowerPoint (PowerPointApi)
- JavaScript-API-Anforderungssätze für Word (WordApi)
Einige Anforderungssätze enthalten APIs, die von mehreren Office-Anwendungen verwendet werden können. Informationen zu diesen Anforderungssätzen finden Sie in den folgenden Artikeln.
- Allgemeine Office-Anforderungssätze
- Add-In-Befehlsanforderungssätze
- Geräteberechtigungsdienst-Anforderungssätze
- Dialog-API-Anforderungssätze
- Dialog-Herkunfts-Anforderungssätze
- Identitäts-API-Anforderungssätze
- Anforderungssätze für die Bildkoersion
- Anforderungssätze für Tastenkombinationen
- Anforderungssätze für geschachtelte App-Authentifizierung
- Anforderungssätze für das Browserfenster öffnen
- Menüband-API-Anforderungssätze
- Anforderungssätze für freigegebene Laufzeiten
Die Versionsnummer eines Anforderungssatzes, z. B. "1.1" in ExcelApi 1.1
, ist relativ zur Office-Anwendung. Die Versionsnummer eines bestimmten Anforderungssatzes (z. BExcelApi 1.1
. ) entspricht nicht der Versionsnummer von Office.js oder Anforderungssätzen für andere Office-Anwendungen (z. B. Word, Outlook usw.). Anforderungssätze für die verschiedenen Office-Anwendungen werden mit unterschiedlichen Raten veröffentlicht. Wurde beispielsweise ExcelApi 1.5
vor dem Anforderungssatz WordApi 1.3
veröffentlicht.
Die Office JavaScript-API-Bibliothek (Office.js) enthält alle derzeit verfügbaren Anforderungssätze. Es gibt zwar Anforderungssätze ExcelApi 1.3
und WordApi 1.3
, aber es gibt keinen Office.js 1.3
Anforderungssatz. Die neueste Version von Office.js wird als einzelner Office-Endpunkt verwaltet, der über das Content Delivery Network (CDN) bereitgestellt wird. Weitere Informationen zum Office.js CDN, einschließlich der Behandlung von Versionsverwaltung und Abwärtskompatibilität, finden Sie unter Grundlegendes zur Office JavaScript-API.
Angeben von Office-Anwendungen und Anforderungssätzen
Es gibt verschiedene Möglichkeiten, anzugeben, welche Office-Anwendungen und Anforderungssätze für ein Add-In erforderlich sind. Ausführliche Informationen finden Sie unter Angeben von Office-Anwendungen und API-Anforderungen.
Siehe auch
Office Add-ins