Office.EmailAddressDetails interface

Stellt die E-Mail-Eigenschaften des Absenders oder angegebener Empfänger einer E-Mail-Nachricht oder eines Termins bereit.

Hinweise

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Eigenschaften

appointmentResponse

Ruft die Antwort ab, die ein Teilnehmer für einen Termin abgegeben hat. Diese Eigenschaft betrifft nur einen Teilnehmer eines Termins, wie von der optionalAttendees-oder requiredAttendees-Eigenschaft dargestellt wird. Diese Eigenschaft gibt in anderen Szenarien undefiniert zurück.

displayName

Ruft den einer E-Mail-Adresse zugeordneten Anzeigenamen ab.

emailAddress

Ruft die SMTP-E-Mail-Adresse ab.

recipientType

Ruft den Typ der E-Mail-Adresse eines Empfängers ab.

Details zur Eigenschaft

appointmentResponse

Ruft die Antwort ab, die ein Teilnehmer für einen Termin abgegeben hat. Diese Eigenschaft betrifft nur einen Teilnehmer eines Termins, wie von der optionalAttendees-oder requiredAttendees-Eigenschaft dargestellt wird. Diese Eigenschaft gibt in anderen Szenarien undefiniert zurück.

appointmentResponse: MailboxEnums.ResponseType | string;

Eigenschaftswert

Beispiele

// The following sample provides the responses from required attendees.
// Note that this sample needs the add-in to be in Appointment Read (Attendee) mode.
const requiredAttendees = Office.context.mailbox.item.requiredAttendees;
console.log("There are " + requiredAttendees.length + " required attendees.")
requiredAttendees.forEach(function (requiredAttendee) {
    console.log("Attendee " + requiredAttendee.displayName + ": " + requiredAttendee.appointmentResponse);
});

displayName

Ruft den einer E-Mail-Adresse zugeordneten Anzeigenamen ab.

displayName: string;

Eigenschaftswert

string

Beispiele

const organizerName = Office.context.mailbox.item.organizer.displayName;
console.log("Organizer: " + organizerName);

emailAddress

Ruft die SMTP-E-Mail-Adresse ab.

emailAddress: string;

Eigenschaftswert

string

Beispiele

const organizerAddress = Office.context.mailbox.item.organizer.emailAddress;
console.log("Organizer's email address: " + organizerAddress);

recipientType

Ruft den Typ der E-Mail-Adresse eines Empfängers ab.

recipientType: MailboxEnums.RecipientType | string;

Eigenschaftswert

Hinweise

Wichtig:

  • Ein recipientType Eigenschaftswert wird von den Methoden Office.context.mailbox.item.from.getAsync und Office.context.mailbox.item.organizer.getAsync nicht zurückgegeben. Der E-Mail-Absender oder Terminorganisator ist immer ein Benutzer, dessen E-Mail-Adresse sich auf dem Exchange-Server befindet.

  • Wenn Sie beim Verfassen eines E-Mail-Elements zu einem Absenderkonto wechseln, das sich in einer anderen Domäne als dem des zuvor ausgewählten Absenderkontos befindet, wird der Wert der recipientType Eigenschaft für vorhandene Empfänger nicht aktualisiert und basiert weiterhin auf der Domäne des zuvor ausgewählten Kontos. Um nach dem Wechsel des Kontos die richtigen Empfängertypen zu erhalten, müssen Sie zuerst die vorhandenen Empfänger entfernen und sie dann wieder dem E-Mail-Element hinzufügen.

Beispiele

const requiredAttendees = Office.context.mailbox.item.requiredAttendees;
console.log("There are " + requiredAttendees.length + " required attendees.")
requiredAttendees.forEach(function (requiredAttendee) {
    console.log("Attendee " + requiredAttendee.displayName + ": " + requiredAttendee.recipientType);
});