Outlook-Add-In API-Vorschau Anforderungssatz

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

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.

  • Es wurde die Möglichkeit hinzugefügt, Outlook-Elementanlagen (Office.MailboxEnums.AttachmentType.Item) in einem Verschlüsselungs-Add-In zu entschlüsseln. Weitere Informationen finden Sie unter Entschlüsseln von Outlook-Elementanlagen (Vorschau).
  • Der Methode von event.completed Verschlüsselungs-Add-Ins wurde eine -Eigenschaft hinzugefügt, um eine benutzerdefinierte Fehlermeldung anzuzeigen, wenn bei der Entschlüsselung ein Fehler auftritt. Weitere Informationen finden Sie unter Anpassen von Fehlermeldungen für den Entschlüsselungsvorgang (Vorschau).
  • Der Methode von event.completed Verschlüsselungs-Add-Ins wurde eine -Eigenschaft hinzugefügt, um das Drucken, Kopieren und Speichern von entschlüsselten Inhalten einzuschränken. Weitere Informationen finden Sie unter Verwalten der Verteilung entschlüsselter Inhalte (Vorschau).
  • Der Entschlüsselungstimeoutbenachrichtigung in Verschlüsselungs-Add-Ins wurde eine Wiederholungsaktion hinzugefügt, damit Empfänger einen fehlgeschlagenen Entschlüsselungsvorgang wiederholen können, ohne zu einer anderen Nachricht wechseln zu müssen.
  • Erweiterte Unterstützung für die errorMessageMarkdown -Eigenschaft der event.completed -Methode auf Smart Alerts-Add-Ins in Outlook für Mac.
  • Es wurde eine Eigenschaft hinzugefügt, um abzurufen oder festzulegen, ob ein Termin ein ganztägiges Ereignis ist.
  • 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.
  • Eine Eigenschaft und -Objekte wurden hinzugefügt, um den Text oder Betreff vorübergehend festzulegen, der im Lesemodus angezeigt wird.

API-Liste

In der folgenden Tabelle sind die Outlook-JavaScript-APIs aufgeführt, die sich derzeit in der Vorschau befinden. Informationen zum Anzeigen der API-Referenzdokumentation für alle Outlook-JavaScript-APIs (einschließlich Vorschau-APIs und zuvor veröffentlichter APIs) finden Sie unter Outlook-APIs.

Klasse Felder Beschreibung
AccessControls allowCopyPaste Gibt bei true an, dass der entschlüsselte Inhalt einer Nachricht kopiert und eingefügt werden kann.
allowPrint Gibt bei true an, dass der entschlüsselte Inhalt einer Nachricht gedruckt werden kann.
allowSave Gibt bei TRUE an, dass der entschlüsselte Inhalt einer Nachricht gespeichert werden kann.
AppointmentCompose isAllDayEvent Ruft die Office.IsAllDayEvent-Eigenschaft eines Termins ab oder legt diese fest.
AppointmentRead isAllDayEvent Gibt einen booleschen Wert zurück, der angibt, ob das Ereignis den ganzen Tag ist.
Anzeige Text Ruft ein -Objekt ab, um den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.
Betreff Ruft ein -Objekt ab, um den im Betreff einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.
DisplayedBody setAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void) Legt den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest.
setAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) Legt den im Textkörper einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest.
DisplayedSubject setAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void) Legt den im Betreff einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest.
setAsync(data: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) Legt den im Betreff einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus fest.
IsAllDayEvent getAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void) Ruft den booleschen Wert ab, der angibt, ob das Ereignis den ganzen Tag hat oder nicht.
getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<boolean>) => void) Ruft den booleschen Wert ab, der angibt, ob das Ereignis den ganzen Tag hat oder nicht.
setAsync(isAllDayEvent: boolean, callback?: (asyncResult: Office.AsyncResult<void>) => void) Legt das ganztägige Ereignis status eines Termins fest.
setAsync(isAllDayEvent: boolean, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) Legt das ganztägige Ereignis status eines Termins fest.
MessageDecryptEventCompletedOptions accessControls Wenn Sie die completed-Methode verwenden, um den Abschluss eines Ereignishandlers zu signalisieren
Errormessage Wenn Sie die completed-Methode verwenden, um den Abschluss eines Ereignishandlers zu signalisieren
MessageRead Anzeigen Ruft ein -Objekt ab, um den im Textkörper oder Betreff einer Nachricht angezeigten Inhalt vorübergehend im Lesemodus festzulegen.

Siehe auch