Outlook-Add-In API-Vorschau Anforderungssatz

  • Artikel

Die Outlook-Add-In-API-Teilmenge der Office JavaScript-API enthält Objekte, Methoden, Eigenschaften und Ereignisse, die Sie in einem Outlook-Add-In verwenden können.

Vorschau-APIs können sich ändern und sind nicht für die Verwendung in einer Produktionsumgebung vorgesehen. Wir empfehlen, sie nur in Test- und Entwicklungsumgebungen auszuprobieren. Verwenden Sie keine Vorschau-APIs in einer Produktionsumgebung oder in unternehmenskritischen Dokumenten.

So verwenden Sie Vorschau-APIs:

  • Sie müssen die Vorschauversion der Office JavaScript-API-Bibliothek aus dem Office.js Content Delivery Network (CDN) verwenden. Die Typdefinitionsdatei für die TypeScript-Kompilierung und IntelliSense finden Sie unter CDN und DefinitelyTyped. Sie können diese Typen mit npm install --save-dev @types/office-js-preview installieren (achten Sie darauf, die Typen für @types/office-js zu entfernen, wenn Sie sie zuvor installiert haben).

  • Möglicherweise müssen Sie dem Microsoft 365 Insider-Programm beitreten, um Zugriff auf neuere Office-Builds in Outlook unter Windows und auf Mac zu erhalten.

  • Möglicherweise müssen Sie die Option Gezieltes Release auf Ihrem Microsoft 365-Mandanten konfigurieren, um Eine Vorschau der Features in Outlook im Web anzuzeigen. Weitere Informationen finden Sie im Abschnitt "Gezieltes Release" unter Einrichten der Standard- oder Zielversionsoptionen.

Der Vorschauanforderungssatz enthält alle Features des Anforderungssatzes 1.13.

Wichtig

Diese Dokumentation gilt für einen Vorschauanforderungssatz. Dieser Anforderungssatz ist noch nicht vollständig implementiert, und Clients melden keine genaue Unterstützung dafür. Sie sollten diesen Anforderungssatz nicht in Ihrem Add-In-Manifest angeben.

Preview-Funktionen

Die folgenden Funktionen haben aktuell noch Preview-Status.

Aktivieren eines ereignisbasierten Add-Ins für eine Nachricht im Lesemodus

OnMessageReadWithCustomAttachment- und OnMessageReadWithCustomHeader-Ereignisse

Ereignisse hinzugefügt, um ein ereignisbasiertes Add-In für eine Nachricht im Lesemodus zu aktivieren, wenn es bestimmte Anlagentypen oder benutzerdefinierte Internetheader enthält.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

HeaderName-Attribut im LaunchEvent-Element

Dem XML-Element LaunchEvent> wurde ein Attribut< hinzugefügt, um den Internetheadernamen anzugeben, für den das OnMessageReadWithCustomHeader Ereignis auftritt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

MessageAttachments-Element

Ein XML-Element wurde hinzugefügt, um die Dateierweiterung der Anlage anzugeben, die in einer Nachricht enthalten ist, für die das OnMessageReadWithCustomAttachment Ereignis auftritt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)


Zusätzliche Kalendereigenschaften

Office.IsAllDayEvent

Ein neues -Objekt wurde hinzugefügt, das die ganztägige Ereigniseigenschaft eines Termins im Verfassenmodus darstellt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.Sensitivity

Ein neues -Objekt wurde hinzugefügt, das die Vertraulichkeitsstufe eines Termins im Verfassenmodus darstellt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)

Office.context.mailbox.item.isAllDayEvent

Es wurde eine neue Eigenschaft hinzugefügt, die angibt, ob ein Termin ein ganztägiges Ereignis ist.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.context.mailbox.item.sensitivity

Eine neue Eigenschaft wurde hinzugefügt, die die Vertraulichkeit eines Termins darstellt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)

Office.MailboxEnums.AppointmentSensitivityType

Eine neue Enumeration AppointmentSensitivityType wurde hinzugefügt, die die vertraulichkeitsoptionen darstellt, die für einen Termin verfügbar sind.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)


Zusätzliche Nachrichtenmitglieder

Office.context.mailbox.item.inReplyTo

Eine -Eigenschaft wurde hinzugefügt, um die Nachrichten-ID der ursprünglichen Nachricht abzurufen, auf die die aktuelle Nachricht antwortet.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.context.mailbox.item.getConversationIndexAsync

Es wurde eine Methode hinzugefügt, um die Base64-codierte Position der aktuellen Nachricht in einem Konversationsthread abzurufen.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.context.mailbox.item.getItemClassAsync

Eine Methode zum Abrufen der EWS-Elementklasse (Exchange Web Services) einer Nachricht im Verfassenmodus wurde hinzugefügt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)


Schließen und Verwerfen einer Nachricht im Verfassen

Office.context.mailbox.item.closeAsync

Methode hinzugefügt, um eine aktuelle Nachricht zu schließen, die mit der Option zum Verwerfen nicht gespeicherter Änderungen erstellt wird.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)


Abrufen der URL der JavaScript-Runtime eines Add-Ins

Office.context.urls.javascriptRuntimeUrl

Eigenschaft hinzugefügt, um die URL der JavaScript-Runtime eines Add-Ins abzurufen.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)


Integrierte Spamberichterstattung

ReportPhishingCommandSurface-Erweiterungspunkt

Es wurde ein Erweiterungspunkt hinzugefügt, um Ihr Add-In für die Spamberichterstattung im Outlook-Menüband zu aktivieren und zu verhindern, dass es am Ende des Menübands oder im Überlaufabschnitt angezeigt wird.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)

ReportPhishingCustomization-Element

Ein Manifestelement zum Konfigurieren der Menübandschaltfläche und des Vorverarbeitungsdialogfelds eines Add-Ins für die Spamberichterstattung wurde hinzugefügt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)

Office.context.mailbox.item.getAsFileAsync

Eine Methode zum Abrufen der Base64-Codierung einer Nachricht wurde hinzugefügt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)

Office.SpamReportingEventCompletedOptions

Es wurden Optionen zum Anpassen eines Nachbearbeitungsdialogfelds oder zum Konfigurieren eines Add-Ins für die Spamberichterstattung erstellt, um zusätzliche Vorgänge für eine gemeldete Nachricht auszuführen, z. B. das Löschen aus dem Posteingang.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)

Office.MailboxEnums.MoveSpamItemTo

Eine neue Enumeration wurde hinzugefügt, um den Ordner anzugeben, in den eine gemeldete Nachricht verschoben wird, nachdem sie von einem Spamberichts-Add-In verarbeitet wurde.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement), Outlook auf Mac (Microsoft 365-Abonnement), Outlook im Web (modern), neues Outlook unter Windows (Vorschau)

Weitere Informationen zum Implementieren der integrierten Spamberichterstattungsfunktion in Ihrem Add-In finden Sie unter Implementieren eines integrierten Spamberichts-Add-Ins (Vorschau).


Mehrfachauswahl des Elements: Zusätzliche Nachrichteneigenschaften

Office.SelectedItemDetails

Die Möglichkeit, die Eigenschaften ausgewählter Nachrichten in Outlook mithilfe von Office.context.mailbox.getSelectedItemsAsync abzurufen, wurde in Anforderungssatz 1.13 eingeführt. Zusätzliche Eigenschaften wie conversationId, internetMessageIdund hasAttachmentsind jetzt in der Vorschau verfügbar.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)


Office-Design

Office.context.officeTheme

Zusätzlichen Möglichkeit zum Abrufen des Office-Designs.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.EventType.OfficeThemeChanged

Das Ereignis OfficeThemeChanged wurde zu Mailbox hinzugefügt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)


Intelligente Warnungen: Passen Sie die Option "Nicht senden" an, und überschreiben Sie die Option "Sendemodus" zur Laufzeit.

Office.SmartAlertsEventCompletedOptions: Zusätzliche Optionen

Es wurden zusätzliche event.completed Optionen hinzugefügt, um die Schaltfläche "Nicht senden" des Dialogfelds "Intelligente Warnungen" anzupassen und die Option "Sendemodus" zur Laufzeit außer Kraft zu setzen.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.MailboxEnums.SendModeOverride

Eine Enumeration wurde hinzugefügt, um die Sendemodusoption anzugeben, die die im Manifest zur Laufzeit festgelegte Option überschreibt.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Informationen zum Implementieren dieser Features finden Sie in der exemplarischen Vorgehensweise zu intelligenten Warnungen.


Vorübergehendes Festlegen des Angezeigten Textkörpers oder Betreffs im Lesemodus

Office.context.mailbox.item.display

Es wurde eine Eigenschaft hinzugefügt, die ein -Objekt abruft, um den im Textkörper oder Betreff einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.Display

Ein Objekt wurde hinzugefügt, das Eigenschaften bereitstellt, um den im Text oder Betreff einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.DisplayedBody

Ein -Objekt wurde hinzugefügt, das eine -Methode bereitstellt, um den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)

Office.DisplayedSubject

Ein -Objekt wurde hinzugefügt, das eine -Methode bereitstellt, um den im Betreff einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.

Verfügbar in: Outlook unter Windows (Microsoft 365-Abonnement)


Siehe auch