JavaScript-API-Anforderungssätze für OneNote
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.
In der folgenden Tabelle sind die OneNote-Anforderungssätze, die unterstützten Office-Clientanwendungen und ggf. die Mindestbuilds oder -versionen für diese Anwendungen aufgeführt.
Anforderungssatz | Office im Web |
---|---|
OneNoteApi 1.1 | Unterstützt |
OneNote-JavaScript-API 1.1
Die OneNote-JavaScript-API 1.1 ist die erste Version der API. Details zur API finden Sie in der Übersicht über die JavaScript-API-Programmierung für OneNote.
Überprüfung der Unterstützung einer Laufzeitanforderung
Während der Laufzeit können Add-Ins überprüfen, ob eine bestimmte Office-Anwendung einen API-Anforderungssatz unterstützt, indem Folgendes durchgeführt wird:
if (Office.context.requirements.isSetSupported('OneNoteApi', '1.1')) {
// Perform actions.
}
else {
// Provide alternate flow/logic.
}
Überprüfung der Unterstützung einer manifest-basierten Anforderung
Verwenden Sie das Requirements
-Element im Add-In-Manifest, um wichtige Anforderungssätze oder API-Elemente anzugeben, die Ihr Add-In verwenden muss. Wenn die Office-Anwendung oder die Plattform die im Requirements
-Element angegebenen Anforderungssätze oder API-Elemente nicht unterstützt, wird das Add-In nicht in dieser Anwendung oder dieser Plattform ausgeführt und nicht unter „Meine Add-Ins“ angezeigt.
Das folgende Codebeispiel zeigt ein Add-In, das in allen Office-Clientanwendungen geladen wird, die den OneNoteApi-Anforderungssatz, Version 1.1, unterstützen.
<Requirements>
<Sets DefaultMinVersion="1.1">
<Set Name="OneNoteApi" MinVersion="1.1"/>
</Sets>
</Requirements>
Allgemeine Office-API-Anforderungssätze
Informationen zu allgemeinen API-Anforderungssätzen finden Sie unter Allgemeine Office-API-Anforderungssätze.
Weitere Informationen
Office Add-ins