JavaScript-API-Anforderungssätze für Outlook

Outlook-Add-Ins deklarieren, welche API-Versionen sie in ihrem Manifest benötigen. Das Markup variiert je nachdem, ob Sie das reine Add-In-Manifestformat oder das einheitliche Manifest für Microsoft 365 verwenden.

"extensions": [
{
  "requirements": {
    "capabilities": [
      {
        "name": "Mailbox", "minVersion": "1.1"
      }
    ]
  },
  ...
}

<Requirements>
  <Sets>
    <Set Name="Mailbox" MinVersion="1.1" />
  </Sets>
</Requirements>

Alle Outlook-APIs gehören zum AnforderungssatzMailbox. Der Mailbox-Anforderungssatz weist Versionen auf, und jeder neue Satz von APIs, der veröffentlicht wird, gehört zu einer höheren Version des Satzes. Nicht alle Outlook-Clients unterstützen den neuesten Satz von APIs, aber wenn ein Outlook-Client unterstützung für einen Anforderungssatz deklariert, unterstützt er im Allgemeinen alle APIs in diesem Anforderungssatz (lesen Sie die Dokumentation zu einer bestimmten API oder einem Feature auf Ausnahmen).

Festlegen einer Mindestanforderungssatzversion in den Manifeststeuerelementen, in denen das Add-In vom Outlook-Client angezeigt wird. Wenn ein Client den Mindestanforderungssatz nicht unterstützt, wird das Add-In nicht geladen. Wenn beispielsweise die Anforderungssatzversion 1.3 angegeben ist, bedeutet dies, dass das Add-In in keinem Outlook-Client angezeigt wird, der mindestens 1.3 nicht unterstützt.

Verwenden von APIs aus späteren Anforderungssätzen

Das Festlegen eines Anforderungssatzes schränkt die verfügbaren APIs, die das Add-In verwenden kann, nicht ein. Wenn das Add-In beispielsweise den Anforderungssatz "Mailbox 1.1" angibt, aber in einem Outlook-Client ausgeführt wird, der "Mailbox 1.3" unterstützt, kann das Add-In APIs aus dem Anforderungssatz "Mailbox 1.3" verwenden.

Um neuere APIs zu verwenden, können Entwickler folgendermaßen überprüfen, ob eine bestimmte Anwendung den Anforderungssatz unterstützt:

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

Alternativ können Entwickler mithilfe der Standard-JavaScript-Methode das Vorhandensein einer neueren API überprüfen.

if (item.somePropertyOrMethod !== undefined) {
  // Use item.somePropertyOrMethod.
  item.somePropertyOrMethod;
}

Für APIs, die sich in der im Manifest angegebenen Version des Anforderungssatzes befinden, sind solche Überprüfungen nicht erforderlich.

Auswählen eines Mindestanforderungssatzes

Entwickler sollten den ältesten Anforderungssatz verwenden, der die kritischen APIs für ihr Szenario enthält, ohne die das Add-In nicht funktioniert.

Von Exchange-Servern und Outlook-Clients unterstützte Anforderungssätze

In diesem Abschnitt wird auf den Umfang der von Exchange-Servern und Outlook-Clients unterstützten Anforderungssätze eingegangen. Ausführliche Informationen zu den Server-und Clientanforderungen für die Ausführung von Outlook-Add-Ins finden Sie unter Voraussetzungen für Outlook-Add-Ins .

Exchange-Serverunterstützung

Die folgenden Server unterstützen Outlook-Add-Ins.

Outlook-Clientunterstützung

Add-Ins werden in Outlook auf den folgenden Plattformen unterstützt.

Versionsunterstützung für Anforderungssätze im klassischen Outlook unter Windows

In der folgenden Tabelle ist die Versionsunterstützung für neuere Postfachanforderungssätze im klassischen Outlook unter Windows mit einem Microsoft 365-Abonnement oder einer unbefristeten Einzelhandelslizenz aufgeführt.

Weitere Informationen zu Ihrer Clientversion finden Sie auf der Seite mit dem Updateverlauf für Microsoft 365 oder Office 2024 und wie Sie Ihre Office-Clientversion und ihren Updatekanal finden.

Verweisen auf die Office JavaScript-API-Produktionsbibliothek

Informationen zum Ausführen von APIs in einem der nummerierten Anforderungssätze finden Sie in der Produktionsbibliothek im Content Delivery Network (CDN) von Office.js. Informationen zur Verwendung von Vorschau-APIs finden Sie unter Testen von Vorschau-APIs.

Testen von Vorschau-APIs

Neue JavaScript-APIs für Outlook werden zuerst als Vorschau eingeführt und werden später Teil eines bestimmten nummerierten Anforderungssatzes, nachdem sie ausreichend getestet wurden und Feedback von Benutzern gesammelt wurde. Wenn Sie Feedback zu einer Vorschau-API geben möchten, verwenden Sie bitte den Feedbackmechanismus am Ende der Webseite, die die Dokumentation der API enthält.

Weitere Informationen zu den Vorschau-APIs finden Sie unter Preview-Anforderungssatz für die Outlook-API.