Abrufen und Festlegen von Outlook-Elementdaten in Formularen zum Lesen oder VerfassenGet and set Outlook item data in read or compose forms

Ab Version 1.1 des Manifestschemas von Office-Add-Ins kann Outlook Add-Ins aktivieren, wenn der Benutzer ein Element anzeigt oder verfasst.Starting in version 1.1 of the Office Add-ins manifests schema, Outlook can activate add-ins when the user is viewing or composing an item. 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.Depending on whether an add-in is activated in a read or compose form, the properties that are available to the add-in on the item differ as well.

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).For example, the dateTimeCreated and dateTimeModified properties are defined only for an item that has already been sent (item is subsequently viewed in a read form) but not when the item is being created (in a compose form). 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.Another example is the bcc property, which is only meaningful when a message is being authored (in a compose form), and is not accessible to the user in a read form.

In Erstell- und Leseformularen verfügbare EigenschaftenItem properties available in compose and read forms

In Tabelle 1 sind die Eigenschaften auf Elementebene in der JavaScript-API für Office dargestellt, die in jedem Lese- und Erstellmodus von Mail-Add-Ins verfügbar sind. In der Regel sind die in Leseformularen verfügbaren Eigenschaften schreibgeschützt, und die in Erstellformularen verfügbaren Eigenschaften können geschrieben/gelesen werden, mit der Ausnahme der Eigenschaften itemId und conversationId, die immer schreibgeschützt sind.Table 1 shows the item-level properties in the JavaScript API for Office that are available in each of read and compose modes of mail add-ins. Typically, those properties available in read forms are read-only, and those available in compose forms are read/write, with the exception of the itemId and conversationId properties, which are always read-only regardless.

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 ist auch der Typ der von diesen Eigenschaften zurückgegebenen Objekte in Erstellformularen anders als in Leseformularen.For the remaining item-level properties available in compose forms, because the add-in and user can possibly be reading or writing the same property at the same time, the methods to get or set them in compose mode are asynchronous, and hence the type of the objects returned by these properties are also different in compose forms than in read forms. 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.For more information about using asynchronous methods to get or set item-level properties in compose mode, see Get and set item data in a compose form in Outlook.

Tabelle 1. In Erstell- und Leseformularen verfügbare EigenschaftenTable 1. Item properties available in compose and read forms


ElementtypItem type EigenschaftProperty Eigenschaftstyp in LeseformularenProperty type in read forms Eigenschaftstyp in ErstellformularenProperty type in compose forms
Termine und NachrichtenAppointments and messages dateTimeCreateddateTimeCreated JavaScript-Objekt des Typs DateJavaScript Date object Eigenschaft nicht verfügbarProperty not available
Termine und NachrichtenAppointments and messages dateTimeModifieddateTimeModified JavaScript-Objekt des Typs DateJavaScript Date object Eigenschaft nicht verfügbarProperty not available
Termine und NachrichtenAppointments and messages itemClassitemClass ZeichenfolgeString Eigenschaft nicht verfügbarProperty not available
Termine und NachrichtenAppointments and messages itemIditemId ZeichenfolgeString Eigenschaft nicht verfügbarProperty not available
Termine und NachrichtenAppointments and messages itemTypeitemType Zeichenfolge in ItemType-AufzählungString in ItemType enumeration Eigenschaft nicht verfügbarProperty not available
Termine und NachrichtenAppointments and messages attachmentsattachments AttachmentDetailsAttachmentDetails Eigenschaft nicht verfügbarProperty not available
Termine und NachrichtenAppointments and messages bodybody TextBody TextBody
TermineAppointments endend JavaScript-Objekt des Typs DateJavaScript Date object ZeitTime
TermineAppointments locationlocation ZeichenfolgeString StandortLocation
Termine und NachrichtenAppointments and messages normalizedSubjectnormalizedSubject ZeichenfolgeString Eigenschaft nicht verfügbarProperty not available
TermineAppointments optionalAttendeesoptionalAttendees EmailAddressDetailsEmailAddressDetails EmpfängerRecipients
TermineAppointments organizerorganizer EmailAddressDetailsEmailAddressDetails Eigenschaft nicht verfügbarProperty not available
TermineAppointments requiredAttendeesrequiredAttendees EmailAddressDetailsEmailAddressDetails EmpfängerRecipients
TermineAppointments startstart JavaScript-Objekt des Typs DateJavaScript Date object ZeitTime
Termine und NachrichtenAppointments and messages subjectsubject ZeichenfolgeString BetreffSubject
NachrichtenMessages bccbcc Eigenschaft nicht verfügbarProperty not available EmpfängerRecipients
NachrichtenMessages cccc EmailAddressDetailsEmailAddressDetails EmpfängerRecipients
NachrichtenMessages conversationIdconversationId ZeichenfolgeString Zeichenfolge (schreibgeschützt)String (read only)
NachrichtenMessages vonfrom EmailAddressDetailsEmailAddressDetails Eigenschaft nicht verfügbarProperty not available
NachrichtenMessages internetMessageIdinternetMessageId Ganze ZahlInteger Eigenschaft nicht verfügbarProperty not available
NachrichtenMessages sendersender EmailAddressDetailsEmailAddressDetails Eigenschaft nicht verfügbarProperty not available
NachrichtenMessages anto EmailAddressDetailsEmailAddressDetails EmpfängerRecipients

Verwenden von Exchange Server-Rückruftoken aus einem Lese-Add-InUse Exchange Server callback tokens from a read add-in

Wenn Ihr Outlook-Add-In in Leseformularen aktiviert ist, können Sie ein Exchange-Rückruftoken abrufen.If your Outlook Add-in is activated in read forms, you can get an Exchange callback token. Dieses Token kann in serverseitigem Code verwendet werden, um über die Exchange-Webdienste (EWS) auf das vollständige Element zuzugreifen.This token can be used in server-side code to access the full item via Exchange Web Services (EWS).

Durch Angeben der Berechtigung ReadItem im Add-In-Manifest können Sie die Methode mailbox.getCallbackTokenAsync zum Abrufen eines Exchange-Rückruftokens, die Eigenschaft mailbox.ewsUrl zum Abrufen der URL des EWS-Endpunkts für das Benutzerpostfach und item.itemId zum Abrufen der EWS-ID des ausgewählten Elements verwenden.By specifying the ReadItem permission in the add-in manifest, you can use the mailbox.getCallbackTokenAsync method to get an Exchange callback token, the mailbox.ewsUrl property to get the URL of the EWS endpoint for the user's mailbox, and item.itemId to get the EWS ID for the selected item. 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.You can then pass the callback token, EWS endpoint URL, and the EWS item ID to server-side code to access the GetItem operation, to get more properties of the item.

Zugreifen auf EWS aus einem Add-In zum Lesen oder VerfassenAccess EWS from a read or compose add-in

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.You can also use the mailbox.makeEwsRequestAsync method to access the Exchange Web Services (EWS) operations GetItem and UpdateItem directly from the add-in. Diese Aktionen können zum Abrufen und Festlegen zahlreicher Eigenschaften eines angegebenen Elements verwendet werden.You can use these operations to get and set many properties of a specified item. Diese Methode ist für Outlook-Add-Ins verfügbar, unabhängig davon, ob das Add-In in einem Lese- oder Erstellformular aktiviert wurde, solange Sie die Berechtigung ReadWriteMailbox Add-In-Manifest angeben.This method is available to Outlook Add-ins regardless of whether the add-in has been activated in a read or compose form, as long as you specify the ReadWriteMailbox permission in the add-in manifest.

Weitere Informationen zur Verwendung von makeEwsRequestAsync für den Zugriff auf EWS-Operationen finden Sie unter Aufrufen von Webdiensten aus einem Outlook-Add-In.For more information about using makeEwsRequestAsync to access EWS operations, see Call web services from an Outlook Add-in.

Siehe auchSee also