Abrufen und Festlegen von Outlook-Elementdaten in Formularen zum Lesen oder Verfassen

  • Artikel

Ab Version 1.1 des Manifestschemas von Office-Add-Ins kann Outlook Add-Ins aktivieren, wenn der Benutzer ein Element anzeigt oder verfasst. Je nachdem, ob ein Add-In in einem Erstell- oder Leseformular aktiviert wird, unterscheiden sich auch die Eigenschaften, die für das Add-In verfügbar sind.

Die Eigenschaften dateTimeCreated und dateTimeModified werden beispielsweise nur für ein Element definiert, das bereits gesendet wurde (das Element wird also in einem Leseformular angezeigt), aber nicht, wenn das Element erstellt wird (in einem Erstellformular). Ein weiteres Beispiel ist die Eigenschaft bcc, die nur sinnvoll ist, wenn eine Meldung erstellt wird (in einem Erstellformular), und die für den Benutzer in einem Leseformular nicht zur Verfügung steht.

In Erstell- und Leseformularen verfügbare Eigenschaften

Tabelle 1 zeigt die Eigenschaften auf Elementebene in der Office JavaScript-API, die in jedem Modus (Lesen und Verfassen) von Mail-Add-Ins verfügbar sind. In der Regel sind die in Leseformularen verfügbaren Eigenschaften schreibgeschützt, und die in Formularen zum Verfassen verfügbaren Eigenschaften sind Lese-/Schreibzugriff, mit Ausnahme der eigenschaften itemId, conversationId und itemType , die unabhängig davon immer schreibgeschützt sind.

Für die verbleibenden Eigenschaften auf Elementebene in Erstellformularen sind die Methoden zum Abrufen oder Festlegen im Erstellmodus asynchron, da das Add-In und der Benutzer möglicherweise dieselbe Eigenschaften zur gleichen Zeit lesen könnten. Daher kann auch der Typ der von diesen Eigenschaften zurückgegebenen Objekte in Erstellformularen anders als in Leseformularen sein. Weitere Informationen zur Verwendung von asynchronen Methoden zum Abrufen oder Festlegen von Eigenschaften auf Elementebene im Erstellmodus finden Sie unter Abrufen und Festlegen von Elementdaten in einem Erstellformular in Outlook.

Tabelle 1. In Erstell- und Leseformularen verfügbare Eigenschaften


Elementtyp Eigenschaft Eigenschaftstyp in Leseformularen Eigenschaftstyp in Erstellformularen
Termine und Nachrichten dateTimeCreated JavaScript-Objekt des Typs Date Eigenschaft nicht verfügbar
Termine und Nachrichten dateTimeModified JavaScript-Objekt des Typs Date Eigenschaft nicht verfügbar
Termine und Nachrichten itemClass Zeichenfolge Eigenschaft nicht verfügbar
Termine und Nachrichten itemId Zeichenfolge Eigenschaft nicht verfügbar
Termine und Nachrichten itemType Zeichenfolge in ItemType-Aufzählung String in ItemType-Enumeration (schreibgeschützt)
Termine und Nachrichten attachments AttachmentDetails Eigenschaft nicht verfügbar
Termine und Nachrichten body Body Body
Termine und Nachrichten normalizedSubject Zeichenfolge Eigenschaft nicht verfügbar
Termine und Nachrichten subject Zeichenfolge Betreff
Termine end JavaScript-Objekt des Typs Date Time
Termine location Zeichenfolge Location
Termine optionalAttendees EmailAddressDetails Recipients
Termine organizer EmailAddressDetails Organisator
Termine requiredAttendees EmailAddressDetails Recipients
Termine start JavaScript-Objekt des Typs Date Time
Nachrichten bcc Eigenschaft nicht verfügbar Empfänger
Nachrichten cc EmailAddressDetails Empfänger
Nachrichten conversationId Zeichenfolge Zeichenfolge (schreibgeschützt)
Nachrichten from EmailAddressDetails Von
Nachrichten internetMessageId Ganze Zahl Eigenschaft nicht verfügbar
Nachrichten sender EmailAddressDetails Eigenschaft nicht verfügbar
Nachrichten to EmailAddressDetails Empfänger

Verwenden von Exchange Server-Rückruftoken aus einem Lese-Add-In

Wenn Ihr Outlook-Add-In in Leseformularen aktiviert ist, können Sie ein Exchange-Rückruftoken abrufen. Dieses Token kann in serverseitigem Code verwendet werden, um über die Exchange-Webdienste (EWS) auf das vollständige Element zuzugreifen.

Durch Angeben der Berechtigung zum Lesen von Elementen im Add-In-Manifest können Sie die mailbox.getCallbackTokenAsync-Methode verwenden, um ein Exchange-Rückruftoken abzurufen, die mailbox.ewsUrl-Eigenschaft zum Abrufen der URL des EWS-Endpunkts für das Postfach des Benutzers und item.itemId , um die EWS-ID für das ausgewählte Element abzurufen. Anschließend können Sie das Rückruftoken, die EWS-Endpunkt-URL und die EWS-Element-ID an den serverseitigen Code für den Zugriff auf den GetItem-Vorgang übergeben, um weitere Eigenschaften des Elements abzurufen.

Zugreifen auf EWS aus einem Add-In zum Lesen oder Verfassen

Sie können auch die Methode mailbox.makeEwsRequestAsync verwenden, um direkt über das Add-In auf die EWS-Operationen (Exchange-Webdienste) GetItem und UpdateItem zuzugreifen. Diese Aktionen können zum Abrufen und Festlegen zahlreicher Eigenschaften eines angegebenen Elements verwendet werden. Diese Methode ist für Outlook-Add-Ins verfügbar, unabhängig davon, ob das Add-In in einem Lese- oder Verfassenformular aktiviert wurde, solange Sie die Lese-/Schreibberechtigung für Das Postfach im Add-In-Manifest angeben. Weitere Informationen zur Lese- /Schreibberechtigung für Postfächer finden Sie unter Grundlegendes zu Outlook-Add-In-Berechtigungen.

Weitere Informationen zur Verwendung von makeEwsRequestAsync für den Zugriff auf EWS-Operationen finden Sie unter Aufrufen von Webdiensten aus einem Outlook-Add-In.

Siehe auch