Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Hinweis
Diese Dokumentation bezieht sich auf einen anderen Anforderungssatz als den aktuellen.
Neuigkeiten in Version 1.13
Postfachanforderungssatz 1.13 enthält alle Features des Anforderungssatzes 1.12. Zusätzlich wurden die folgenden Funktionen implementiert.
- Unterstützung für das Aktivieren eines Add-Ins hinzugefügt, ohne dass der Lesebereich aktiviert oder eine Nachricht ausgewählt ist.
- Unterstützung für die Verwaltung der Übermittlungsdaten und des Übermittlungszeitpunkts einer Nachricht wurde hinzugefügt.
- Neue Ereignisse für die ereignisbasierte Aktivierung hinzugefügt.
- Die Funktion für die Mehrfachauswahl von Elementen wurde hinzugefügt.
- Das Prepend-on-Send-Feature wurde hinzugefügt.
- Das Feature für Vertraulichkeitsbezeichnungen wurde hinzugefügt.
- Unterstützung für Szenarien mit gemeinsam genutztem Postfach hinzugefügt.
API-Liste
In der folgenden Tabelle sind die APIs aufgeführt, die im Postfach-Anforderungssatz 1.13 eingeführt wurden. Die API-Referenzdokumentation für alle APIs, die vom Postfachanforderungssatz 1.13 oder früher unterstützt werden, finden Sie unter Outlook-APIs.
| Klasse | Felder | Beschreibung |
|---|---|---|
| AppointmentCompose | sensitivityLabel | Ruft das Objekt ab, um die Vertraulichkeitsbezeichnung eines Termins abzurufen oder festzulegen. |
| Body | prependOnSendAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void) | Stellt HTML oder Nur-Text am Anfang einer Nachricht oder eines Termintexts her, wenn das E-Mail-Element gesendet wird. |
| prependOnSendAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) | Stellt HTML oder Nur-Text am Anfang einer Nachricht oder eines Termintexts her, wenn das E-Mail-Element gesendet wird. | |
| DelayDeliveryTime | getAsync(callback?: (asyncResult: Office.AsyncResult<Date | 0>) => void) | Ruft das Datum und die Uhrzeit der Zustellung einer Nachricht ab. |
| getAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<Date | 0>) => void) | Ruft das Datum und die Uhrzeit der Zustellung einer Nachricht ab. | |
| setAsync(datetime: Date, callback?: (asyncResult: Office.AsyncResult<void>) => void) | Legt das Übermittlungsdatum und die Übermittlungszeit einer Nachricht fest. | |
| setAsync(datetime: Date, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) | Legt das Übermittlungsdatum und die Übermittlungszeit einer Nachricht fest. | |
| Postfach | getSelectedItemsAsync(callback: (asyncResult: Office.AsyncResult<SelectedItemDetails[]>) => void) | Ruft die aktuell ausgewählten Nachrichten ab, für die ein Add-In aktiviert und Operationen ausgeführt werden kann. |
| getSelectedItemsAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SelectedItemDetails[]>) => void) | Ruft die aktuell ausgewählten Nachrichten ab, für die ein Add-In aktiviert und Operationen ausgeführt werden kann. | |
| MessageCompose | delayDeliveryTime | Ruft das Datum und die Uhrzeit der verzögerten Zustellung einer Nachricht ab oder legt diese fest. |
| sensitivityLabel | Ruft das Objekt ab, um die Vertraulichkeitsbezeichnung einer Nachricht abzurufen oder festzulegen. | |
| SelectedItemDetails | itemId | Der Exchange-Webdienste-Elementbezeichner der aktuell ausgewählten Nachricht. |
| itemMode | Der Outlook-Modus (Read oder Compose) der aktuell ausgewählten Nachricht. |
|
| itemType | Der Typ des aktuell ausgewählten Elements. | |
| Betreff | Die Beschreibung, die im Betrefffeld der aktuell ausgewählten Nachricht angezeigt wird. | |
| SensitivityLabel | getAsync(callback: (asyncResult: Office.AsyncResult<string>) => void) | Ruft den eindeutigen Bezeichner (GUID) der Vertraulichkeitsbezeichnung ab, die auf eine Nachricht oder einen Termin angewendet wird, die verfasst werden. |
| getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void) | Ruft den eindeutigen Bezeichner (GUID) der Vertraulichkeitsbezeichnung ab, die auf eine Nachricht oder einen Termin angewendet wird, die verfasst werden. | |
| setAsync(sensitivityLabel: string | SensitivityLabelDetails, callback?: (asyncResult: Office.AsyncResult<void>) => void) | Wendet die angegebene Vertraulichkeitsbezeichnung auf die Nachricht oder den Termin an, die bzw. der verfasst wird. | |
| setAsync(sensitivityLabel: string | SensitivityLabelDetails, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) | Wendet die angegebene Vertraulichkeitsbezeichnung auf die Nachricht oder den Termin an, die bzw. der verfasst wird. | |
| SensitivityLabelChangedEventArgs | type | Der Typ des ausgelösten Ereignisses. |
| SensitivityLabelDetails | Kinder | Die untergeordneten Bezeichnungen der Vertraulichkeitsbezeichnung. |
| color | Die Farbe der Vertraulichkeitsbezeichnung. | |
| id | Der eindeutige Bezeichner (GUID) der Vertraulichkeitsbezeichnung. | |
| name | Der Name der Vertraulichkeitsbezeichnung. | |
| QuickInfo | Die Beschreibung der Vertraulichkeitsbezeichnung. | |
| SensitivityLabelsCatalog | getAsync(callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void) | Ruft alle in Outlook aktivierten Vertraulichkeitsbezeichnungen ab. |
| getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void) | Ruft alle in Outlook aktivierten Vertraulichkeitsbezeichnungen ab. | |
| getIsEnabledAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void) | Überprüft, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist. | |
| getIsEnabledAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<boolean>) => void) | Überprüft, ob der Katalog der Vertraulichkeitsbezeichnungen in Outlook aktiviert ist. |
Ereignisse
In der folgenden Tabelle sind die in Anforderungssatz 1.13 eingeführten Ereignisse aufgeführt. Eine Liste aller unterstützten Ereignisse, die mit der addHandlerAsync and-Methode removeHandlerAsync behandelt werden können, finden Sie unter Office.EventType.
| Ereignis | Beschreibung | Object |
|---|---|---|
| SelectedItemsChanged | Es wird mindestens eine Nachricht ausgewählt bzw. die Auswahl aufgehoben. | Postfach |
| SensitivityLabelChanged | Die Vertraulichkeitsbezeichnung einer Nachricht oder eines Termins wird geändert. | Element |
Hinweis
Informationen zu Ereignissen, die in einem ereignisbasierten Aktivierungs-Add-In unterstützt werden, finden Sie unter Aktivieren von Add-Ins mit Ereignissen.
Manifestupdates
In der folgenden Tabelle sind die Manifestupdates aufgeführt, die im Postfach-Anforderungssatz 1.13 eingeführt wurden. Weitere Informationen über die Typen von Office-Add-In-Manifesten finden Sie unter Office-Add-In-Manifest.
| Feature | Einheitliches Manifest für Microsoft 365 | Manifest nur für Add-Ins | Beschreibung |
|---|---|---|---|
| Kein Elementkontext | "extensions.runtimes.actions.supportsNoItemContext" |
SupportsNoItemContext | Ermöglicht die Aktivierung von Add-Ins im Aufgabenbereich, ohne dass der Lesebereich aktiviert oder eine Nachricht ausgewählt ist. |
| Unterstützung für freigegebene Postfächer |
"authorization.permissions.resourceSpecific.name" auf "Mailbox.SharedFolder" |
SupportsSharedFolders | Definiert, ob das Add-In in Szenarien mit freigegebenen Postfächern verfügbar ist. |
Siehe auch
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Office Add-ins