Office.MailboxEnums.RecipientType enum

Gibt den Empfängertyp einer Nachricht oder eines Termins an.

Hinweise

API-Satz: Postfach 1.1

Anwendbarer Outlook-Modus: Compose oder Lesen

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.

Verwendet von

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-to-message-read.yaml

const msgTo = Office.context.mailbox.item.to;
const distributionLists = [];
const externalRecipients = [];
const internalRecipients = [];
const otherRecipients = [];
for (let i = 0; i < msgTo.length; i++) {
    switch (msgTo[i].recipientType) {
    case Office.MailboxEnums.RecipientType.DistributionList:
        distributionLists.push(msgTo[i]);
        break;
    case Office.MailboxEnums.RecipientType.ExternalUser:
        externalRecipients.push(msgTo[i]);
        break;
    case Office.MailboxEnums.RecipientType.User:
        internalRecipients.push(msgTo[i]);
        break;
    case Office.MailboxEnums.RecipientType.Other:
        otherRecipients.push(msgTo[i]);
    }
}

if (distributionLists.length > 0) {
    console.log("Distribution Lists:");
    distributionLists.forEach((recipient) => console.log(`${recipient.displayName}, ${recipient.emailAddress}`));
}

if (externalRecipients.length > 0) {
    console.log("External Recipients:");
    externalRecipients.forEach((recipient) => console.log(`${recipient.displayName}, ${recipient.emailAddress}`));
}

if (internalRecipients.length > 0) {
    console.log("Internal Recipients:");
    internalRecipients.forEach((recipient) => console.log(`${recipient.displayName}, ${recipient.emailAddress}`));
}

if (otherRecipients.length > 0) {
    console.log("Other Recipients:");
    otherRecipients.forEach((recipient) => console.log(`${recipient.displayName}, ${recipient.emailAddress}`));
}

Felder

DistributionList = "distributionList"

Gibt an, dass der Empfänger eine Verteilerliste ist, die eine Liste von E-Mail-Adressen enthält.

User = "user"

Gibt an, dass der Empfänger eine SMTP-E-Mail-Adresse auf dem Exchange-Server ist.

ExternalUser = "externalUser"

Gibt an, dass es sich bei dem Empfänger um eine SMTP-E-Mail-Adresse handelt, die sich nicht auf dem Exchange-Server befindet. Es bezieht sich auch auf einen Empfänger, der aus einem persönlichen Outlook-Adressbuch hinzugefügt wurde.

Wichtig: In Outlook im Web, unter Windows (neu und klassisch (ab Version 2210, Build 15813.20002)) und auf Mac geben GAL-Empfänger (Global Address Book), die in einem persönlichen Adressbuch gespeichert sind, den ExternalUser Wert zurück, auch wenn ihre SMTP-E-Mail-Adresse auf dem Exchange-Server angezeigt wird. Empfänger geben nur dann einen User Wert zurück, wenn sie direkt mit der GAL addiert oder aufgelöst werden.

Other = "other"

Gibt an, dass der Empfänger keiner der anderen Empfängertypen ist. Es bezieht sich auch auf einen Empfänger, der nicht gegen das Exchange-Adressbuch aufgelöst wird und daher als externe SMTP-Adresse behandelt wird.

Wichtig: In Outlook unter Android und iOS geben GAL-Empfänger, die in einem persönlichen Adressbuch gespeichert sind, den Other Wert zurück, auch wenn ihre SMTP-E-Mail-Adresse auf dem Exchange-Server angezeigt wird. Empfänger geben nur dann einen User Wert zurück, wenn sie direkt mit der GAL addiert oder aufgelöst werden.