Partager via


Office.MailboxEnums.RecipientType enum

Spécifie le type de destinataire d’un message ou d’un rendez-vous.

Remarques

[ Ensemble d’API : Boîte aux lettres 1.1 ]

Mode Outlook applicable : Rédiger ou Lire

Important : une recipientType valeur de propriété n’est pas retournée par les méthodes Office.context.mailbox.item.from.getAsync et Office.context.mailbox.item.organizer.getAsync . L’expéditeur ou l’organisateur du rendez-vous est toujours un utilisateur dont l’adresse e-mail se trouve sur le serveur Exchange.

Exemples

// 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}`));
}

Champs

DistributionList = "distributionList"

Spécifie que le destinataire est une liste de distribution contenant une liste d’adresses e-mail.

User = "user"

Spécifie que le destinataire est une adresse e-mail SMTP sur le serveur Exchange.

ExternalUser = "externalUser"

Spécifie que le destinataire est une adresse e-mail SMTP qui ne se trouve pas sur le serveur Exchange. Il fait également référence à un destinataire ajouté à partir d’un carnet d’adresses Outlook personnel.

Important : Dans Outlook sur le web, sur Windows (nouveau et classique (à partir de la version 2210, build 15813.20002)) et sur Mac, les destinataires du carnet d’adresses global enregistrés dans un carnet d’adresses personnel retournent la ExternalUser valeur, même si leur adresse e-mail SMTP apparaît sur le serveur Exchange. Les destinataires retournent une User valeur uniquement s’ils sont directement ajoutés ou résolus par rapport à la liste d’adresses globale.

Other = "other"

Spécifie que le destinataire n’est pas l’un des autres types de destinataires. Il fait également référence à un destinataire qui n’est pas résolu par rapport au carnet d’adresses Exchange et qui est donc traité comme une adresse SMTP externe.

Important : dans Outlook sur Android et iOS, les destinataires du carnet d’adresses global enregistrés dans un carnet d’adresses personnel retournent la Other valeur, même si leur adresse e-mail SMTP apparaît sur le serveur Exchange. Les destinataires retournent une User valeur uniquement s’ils sont directement ajoutés ou résolus par rapport à la liste d’adresses globale.