item (Postfachanforderungssatz 1.7)

Office.context.mailbox.item

item wird für den Zugriff auf die aktuell ausgewählte Nachricht, Besprechungsanfrage oder Termin verwendet. Sie können den Typ des Elements mithilfe der itemType -Eigenschaft bestimmen.

Anforderungen
Anforderung Wert
Mindestversion des Postfachanforderungssatzes 1.1
Mindestberechtigungsstufe Beschränkt
Zutreffender Outlook-Modus Terminorganisator, Terminteilnehmer,
Verfassen von Nachrichten oder Lesen von Nachrichten

Wichtig

Android und iOS: Es gibt Einschränkungen, wann Add-Ins aktiviert werden und welche APIs verfügbar sind. Weitere Informationen finden Sie unter Hinzufügen von mobiler Unterstützung zu einem Outlook-Add-In.

Eigenschaften

Eigenschaft Minimum
Berechtigungsstufe
Details nach Modus Rückgabetyp Minimum
Anforderungssatz
Anlagen Element lesen Terminteilnehmer Array.<AttachmentDetails> 1.1
Nachricht lesen Array.<AttachmentDetails> 1.1
bcc Element lesen Nachricht verfassen Empfänger 1.1
body Element lesen Terminplaner Body 1.1
Terminteilnehmer Body 1.1
Nachricht verfassen Body 1.1
Nachricht lesen Body 1.1
cc Element lesen Nachricht verfassen Empfänger 1.1
Nachricht lesen Array.<EmailAddressDetails> 1.1
conversationId Element lesen Nachricht verfassen Zeichenfolge 1.1
Nachricht lesen Zeichenfolge 1.1
dateTimeCreated Element lesen Terminteilnehmer Datum 1.1
Nachricht lesen Datum 1.1
dateTimeModified Element lesen Terminteilnehmer Datum 1.1
Nachricht lesen Datum 1.1
end Element lesen Terminplaner Time 1.1
Terminteilnehmer Datum 1.1
Nachricht lesen
(Besprechungsanfrage)
Datum 1.1
von Element lesen/schreiben Nachricht verfassen From 1.7
Element lesen Nachricht lesen EmailAddressDetails 1.1
internetMessageId Element lesen Nachricht lesen Zeichenfolge 1.1
itemClass Element lesen Terminteilnehmer Zeichenfolge 1.1
Nachricht lesen Zeichenfolge 1.1
Itemid Element lesen Terminteilnehmer Zeichenfolge 1.1
Nachricht lesen Zeichenfolge 1.1
Itemtype Element lesen Terminplaner MailboxEnums.ItemType 1.1
Terminteilnehmer MailboxEnums.ItemType 1.1
Nachricht verfassen MailboxEnums.ItemType 1.1
Nachricht lesen MailboxEnums.ItemType 1.1
Speicherort Element lesen Terminplaner Location 1.1
Terminteilnehmer Zeichenfolge 1.1
Nachricht lesen
(Besprechungsanfrage)
Zeichenfolge 1.1
normalizedSubject Element lesen Terminteilnehmer Zeichenfolge 1.1
Nachricht lesen Zeichenfolge 1.1
notificationMessages Element lesen Terminplaner NotificationMessages 1.3
Terminteilnehmer NotificationMessages 1.3
Nachricht verfassen NotificationMessages 1.3
Nachricht lesen NotificationMessages 1.3
optionalAttendees Element lesen Terminplaner Empfänger 1.1
Terminteilnehmer Array.<EmailAddressDetails> 1.1
organizer Element lesen/schreiben Terminplaner Organisator 1.7
Element lesen Terminteilnehmer EmailAddressDetails 1.1
recurrence Element lesen Terminplaner Serie 1.7
Terminteilnehmer Serie 1.7
Nachricht lesen
(Besprechungsanfrage)
Serie 1.7
requiredAttendees Element lesen Terminplaner Empfänger 1.1
Terminteilnehmer Array.<EmailAddressDetails> 1.1
sender Element lesen Nachricht lesen EmailAddressDetails 1.1
seriesId Element lesen Terminplaner Zeichenfolge 1.7
Terminteilnehmer Zeichenfolge 1.7
Nachricht verfassen Zeichenfolge 1.7
Nachricht lesen Zeichenfolge 1.7
start Element lesen Terminplaner Time 1.1
Terminteilnehmer Datum 1.1
Nachricht lesen
(Besprechungsanfrage)
Datum 1.1
subject Element lesen Terminplaner Betreff 1.1
Terminteilnehmer Zeichenfolge 1.1
Nachricht verfassen Betreff 1.1
Nachricht lesen Zeichenfolge 1.1
in Element lesen Nachricht verfassen Empfänger 1.1
Nachricht lesen Array.<EmailAddressDetails> 1.1

Methoden

Methode Minimum
Berechtigungsstufe
Details nach Modus Minimum
Anforderungssatz
addFileAttachmentAsync(uri, attachmentName, [options], [callback]) Element lesen/schreiben Terminplaner 1.1
Nachricht verfassen 1.1
addHandlerAsync(eventType, handler, [options], [callback]) Element lesen Terminplaner 1.7
Terminteilnehmer 1.7
Nachricht verfassen 1.7
Nachricht lesen 1.7
addItemAttachmentAsync(itemId, attachmentName, [options], [callback]) Element lesen/schreiben Terminplaner 1.1
Nachricht verfassen 1.1
close() Beschränkt Terminplaner 1.3
Nachricht verfassen 1.3
displayReplyAllForm(formData) Element lesen Terminteilnehmer 1.1
Nachricht lesen 1.1
displayReplyForm(formData) Element lesen Terminteilnehmer 1.1
Nachricht lesen 1.1
getEntities() Element lesen Terminteilnehmer 1.1
Nachricht lesen 1.1
getEntitiesByType(entityType) Beschränkt Terminteilnehmer 1.1
Nachricht lesen 1.1
getFilteredEntitiesByName(name) Element lesen Terminteilnehmer 1.1
Nachricht lesen 1.1
getRegExMatches() Element lesen Terminteilnehmer 1.1
Nachricht lesen 1.1
getRegExMatchesByName(name) Element lesen Terminteilnehmer 1.1
Nachricht lesen 1.1
getSelectedDataAsync(coercionType, [options], callback) Element lesen Terminplaner 1.2
Nachricht verfassen 1.2
getSelectedEntities() Element lesen Terminteilnehmer 1.6
Nachricht lesen 1.6
getSelectedRegExMatches() Element lesen Terminteilnehmer 1.6
Nachricht lesen 1.6
loadCustomPropertiesAsync(callback, [userContext]) Element lesen Terminplaner 1.1
Terminteilnehmer 1.1
Nachricht verfassen 1.1
Nachricht lesen 1.1
removeAttachmentAsync(attachmentId, [options], [callback]) Element lesen/schreiben Terminplaner 1.1
Nachricht verfassen 1.1
removeHandlerAsync(eventType, [options], [callback]) Element lesen Terminplaner 1.7
Terminteilnehmer 1.7
Nachricht verfassen 1.7
Nachricht lesen 1.7
saveAsync([options], callback) Element lesen/schreiben Terminplaner 1.3
Nachricht verfassen 1.3
setSelectedDataAsync(data, [options], callback) Element lesen/schreiben Terminplaner 1.2
Nachricht verfassen 1.2

Veranstaltungen

Sie können die folgenden Ereignisse mit bzwremoveHandlerAsync. abonnieren addHandlerAsync bzw. kündigen.

Wichtig

Ereignisse sind nur bei der Implementierung des Aufgabenbereichs verfügbar.

Document.SelectionChanged -Ereignis Beschreibung Minimum
Anforderungssatz
AppointmentTimeChanged Das Datum oder die Uhrzeit des ausgewählten Termins oder der ausgewählten Reihe wurde geändert. 1.7
RecipientsChanged Die Empfängerliste des ausgewählten Elements oder des ausgewählten Terminspeicherorts wurde geändert. 1.7
RecurrenceChanged Das Serienmuster der ausgewählten Reihe wurde geändert. 1.7

Beispiel

Im folgenden JavaScript-Codebeispiel wird der Zugriff auf die subject-Eigenschaft des aktuellen Elements in Outlook veranschaulicht.

// The initialize function is required for all apps.
Office.initialize = function () {
  // Checks for the DOM to load using the jQuery ready method.
  $(document).ready(function () {
    // After the DOM is loaded, app-specific code can run.
    const item = Office.context.mailbox.item;
    const subject = item.subject;
    // Continue with processing the subject of the current item,
    // which can be a message or appointment.
  });
};