Freigeben über


Office.MailboxEnums.RecipientType enum

Gibt den Typ des Empfängers einer Nachricht oder eines Termins an.

Hinweise

[ API-Satz: Postfach 1.1 ]

Anwendbarer Outlook-Modus: Verfassen 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.

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 der Empfänger eine SMTP-E-Mail-Adresse ist, 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 Empfänger des globalen Adressbuchs (GAL), 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 für die GAL hinzugefügt 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 für das Exchange-Adressbuch aufgelöst wird und daher als externe SMTP-Adresse behandelt wird.

Wichtig: In Outlook für Android und unter iOS geben in einem persönlichen Adressbuch gespeicherte Empfänger des globalen Adressbuchs (GAL) 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 für die GAL hinzugefügt oder aufgelöst werden.