Abrufen und Festlegen von Elementdaten in einem Erstellformular in OutlookGet and set item data in a compose form in Outlook

Informationen zum Abrufen oder Festlegen von Eigenschaften eines Outlook-Add-Ins in einem Erstellungsszenario, einschließlich Empfänger, Betreff, Text sowie Ort und Uhrzeit eines Termins.Learn how to get or set various properties of an item in an Outlook add-in in a compose scenario, including its recipients, subject, body, and appointment location and time.

Elementeigenschaften für ein Entwurfs-Add-in abrufen und festlegenGetting and setting item properties for a compose add-in

Sie können in einer Entwurfsvorlage die meisten der Eigenschaften abrufen, die in einem ähnlichen Element wie einem Leseformular eingeblendet sind (wie Teilnehmer, Empfänger, Betreff und Text). Sie können außerdem bestimmte Extraeigenschaften abrufen, die für eine Entwurfsvorlage nicht aber für ein Leseformular (Text, BCC) von Bedeutung sind.In a compose form, you can get most of the properties that are exposed on the same kind of item as in a read form (such as attendees, recipients, subject, and body), and you can get a few extra properties that are relevant in only a compose form but not a read form (body, bcc).

Bei den meisten dieser Eigenschaften sind die Methoden zum Abrufen und Festlegen der Eigenschaften asynchron, da es möglich ist, dass ein Outlook-Add-In und der Benutzer dieselbe Eigenschaft gleichzeitig ändern können. In Tabelle 1 werden die Eigenschaften auf Elementebene und die entsprechenden asynchronen Methoden zum Abrufen und Festlegen von Eigenschaften in einer Entwurfsvorlage angezeigt. Die Eigenschaften item.itemType und item.conversationId sind Ausnahmen, da Benutzer sie nicht ändern dürfen. Sie können die Eigenschaften programmtechnisch auf dieselbe Weise über eine Entwurfsvorlage wie über ein Leseformular direkt aus dem übergeordneten Objekt abrufen.For most of these properties, because it's possible that an Outlook add-in and the user can be modifying the same property in the user interface at the same time, the methods to get and set them are asynchronous. Table 1 lists the item-level properties and corresponding asynchronous methods to get and set them in a compose form. The item.itemType and item.conversationId properties are exceptions because users cannot modify them. You can programmatically get them the same way in a compose form as in a read form, directly from the parent object.

Als Elementeigenschaften in der JavaScript-API für Office zugreifen, können Sie Eigenschaften auf Elementebene mithilfe der Exchange-Webdienste (EWS) zugreifen. Die mailbox.makeEwsRequestAsync -Methode können Sie mit der Berechtigung ReadWriteMailbox EWS-Vorgänge, GetItem und UpdateItem, zum Abrufen und Festlegen von weitere Eigenschaften eines Elements oder Elemente im Postfach des Benutzers zuzugreifen.Other than accessing item properties in the JavaScript API for Office, you can access item-level properties using Exchange Web Services (EWS). With the ReadWriteMailbox permission, you can use the mailbox.makeEwsRequestAsync method to access EWS operations, GetItem and UpdateItem, to get and set more properties of an item or items in the user's mailbox.

Die makeEwsRequestAsync Funktion steht in beiden verfassen und Formulare lesen. Weitere Informationen über die Berechtigung ReadWriteMailbox und Zugreifen auf Exchange-Webdienste über die Plattform für die Office-Add-ins finden Sie unter Grundlegendes zu Outlook-add-in Berechtigungen und Aufrufen von Webdiensten aus einem Outlook-add-in.The makeEwsRequestAsync function is available in both compose and read forms. For more information about the ReadWriteMailbox permission, and accessing EWS through the Office Add-ins platform, see Understanding Outlook add-in permissions and Call web services from an Outlook add-in.

Tabelle 1. Asynchrone Methoden zum Abrufen und Festlegen von Elementeigenschaften in einer EntwurfsvorlageTable 1. Asynchronous methods to get or set item properties in a compose form


EigenschaftProperty EigenschaftentypProperty type Asynchrone AbrufmethodeAsynchronous method to get Asynchrone Festlegungsmethode(n)Asynchronous method(s) to set
bccbcc EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync, Recipients.setAsyncRecipients.addAsync, Recipients.setAsync
Textbody TextBody Body.getAsyncBody.getAsync Body.prependAsync, Body.setAsync, Body.setSelectedDataAsyncBody.prependAsync, Body.setAsync, Body.setSelectedDataAsync
cccc EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync
endend ZeitTime Time.getAsyncTime.getAsync Time.setAsyncTime.setAsync
locationlocation StandortLocation Location.getAsyncLocation.getAsync Location.setAsyncLocation.setAsync
optionalAttendeesoptionalAttendees EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync
requiredAttendeesrequiredAttendees EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync
startstart ZeitTime Time.getAsyncTime.getAsync Time.setAsyncTime.setAsync
subjectsubject BetreffSubject Subject.getAsyncSubject.getAsync Subject.setAsyncSubject.setAsync
anto EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync

Siehe auchSee also