Freigeben über

Abrufen und Festlegen von Elementdaten in einem Erstellformular in Outlook

  • Artikel

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.

Elementeigenschaften für ein Entwurfs-Add-in abrufen und festlegen

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.

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.

Abgesehen vom Zugriff auf Elementeigenschaften in der Office JavaScript-API können Sie mithilfe von Exchange-Webdiensten (EWS) auf Eigenschaften auf Elementebene zugreifen. Mit der Lese-/Schreibberechtigung postfach können Sie die mailbox.makeEwsRequestAsync-Methode verwenden, um auf EWS-Vorgänge, GetItem und UpdateItem, zuzugreifen, um weitere Eigenschaften eines Elements oder von Elementen im Postfach des Benutzers abzurufen und festzulegen.

Die makeEwsRequestAsync -Methode ist sowohl im Verfassen- als auch im Leseformular verfügbar. Weitere Informationen zur Lese- /Schreibberechtigung für Postfächer und zum Zugriff auf EWS über die Office-Add-In-Plattform finden Sie unter Grundlegendes zu Outlook-Add-In-Berechtigungen und Aufrufen von Webdiensten über ein Outlook-Add-In.

Tabelle 1. Asynchrone Methoden zum Abrufen und Festlegen von Elementeigenschaften in einer Entwurfsvorlage

Eigenschaft Eigenschaftentyp Asynchrone Abrufmethode Festzulegende asynchrone Methoden
bcc Empfänger Recipients.getAsync Recipients.addAsync, Recipients.setAsync
body Body Body.getAsync Body.prependAsync, Body.setAsync, Body.setSelectedDataAsync
cc Empfänger Recipients.getAsync Recipients.addAsync Recipients.setAsync
end Time Time.getAsync Time.setAsync
location Location Location.getAsync Location.setAsync
optionalAttendees Empfänger Recipients.getAsync Recipients.addAsync Recipients.setAsync
requiredAttendees Empfänger Recipients.getAsync Recipients.addAsync Recipients.setAsync
start Zeit Time.getAsync Time.setAsync
subject Subject Subject.getAsync Subject.setAsync
to Empfänger Recipients.getAsync Recipients.addAsync Recipients.setAsync

Siehe auch