Share via


Office.MailboxEnums.RecipientType enum

Especifica o tipo de destinatário de uma mensagem ou compromisso.

Comentários

[ Conjunto de API: Caixa de correio 1.1 ]

Modo outlook aplicável: compor ou ler

Importante: um recipientType valor de propriedade não é retornado pelos métodos Office.context.mailbox.item.from.getAsync e Office.context.mailbox.item.organizer.getAsync . O remetente de email ou organizador de compromissos é sempre um usuário cujo endereço de email está no servidor do Exchange.

Exemplos

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

Campos

DistributionList = "distributionList"

Especifica que o destinatário é uma lista de distribuição que contém uma lista de endereços de email.

User = "user"

Especifica que o destinatário é um endereço de email SMTP no servidor exchange.

ExternalUser = "externalUser"

Especifica que o destinatário é um endereço de email SMTP que não está no servidor do Exchange. Ele também se refere a um destinatário adicionado de um catálogo de endereços pessoal do Outlook.

Importante: em Outlook na Web, no Windows (começando com a versão 2210 (Build 15813.20002)) e no Mac, os destinatários do Gal (Global Address Book) salvos em um catálogo de endereços pessoais retornam o ExternalUser valor, mesmo que o endereço de email SMTP apareça no servidor do Exchange. Os destinatários retornam um User valor somente se forem adicionados diretamente ou resolvidos em relação ao GAL.

Other = "other"

Especifica que o destinatário não é um dos outros tipos de destinatário. Ele também se refere a um destinatário que não é resolvido no catálogo de endereços do Exchange e, portanto, é tratado como um endereço SMTP externo.

Importante: no Outlook no Android e no iOS, os destinatários do Gal (Catálogo de Endereços Global) salvos em um catálogo de endereços pessoais retornam o valor, mesmo que o Other endereço de email SMTP seja exibido no servidor do Exchange. Os destinatários retornam um User valor somente se forem adicionados diretamente ou resolvidos em relação ao GAL.