JavaScript-API-Anforderungssätze für OneNote

  • 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.

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