Abrufen und Festlegen von Outlook-Elementdaten in Formularen zum Lesen oder Verfassen
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
Die folgende Tabelle zeigt die Eigenschaften auf Elementebene in der Office JavaScript-API, die in jedem Modus (Lesen und Verfassen) von E-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.
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
Wichtig
Legacy-Exchange-Benutzeridentitätstoken und Rückruftoken werden im Oktober 2024 für alle Exchange Online-Mandanten im Rahmen der Microsoft Secure Future Initiative deaktiviert, die Organisationen die Tools bietet, die für die Reaktion auf die aktuelle Bedrohungslandschaft erforderlich sind. Exchange-Benutzeridentitätstoken funktionieren weiterhin für lokale Exchange-Instanzen. Die Authentifizierung geschachtelter Apps ist der empfohlene Ansatz für token in Zukunft. Weitere Informationen finden Sie in unserem Blogbeitrag zur Authentifizierung geschachtelter Apps und älteren Exchange-Token.
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
Wichtig
Legacy-Exchange-Benutzeridentitätstoken und Rückruftoken werden im Oktober 2024 für alle Exchange Online-Mandanten im Rahmen der Microsoft Secure Future Initiative deaktiviert, die Organisationen die Tools bietet, die für die Reaktion auf die aktuelle Bedrohungslandschaft erforderlich sind. Exchange-Benutzeridentitätstoken funktionieren weiterhin für lokale Exchange-Instanzen. Die Authentifizierung geschachtelter Apps ist der empfohlene Ansatz für token in Zukunft. Weitere Informationen finden Sie in unserem Blogbeitrag zur Authentifizierung geschachtelter Apps und älteren Exchange-Token.
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 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
Office Add-ins
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für