Compartilhar 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: Compose ou Leitura

Importante: recipientType um valor de propriedade não é devolvido pelos métodos Office.context.mailbox.item.from.getAsync e Office.context.mailbox.item.organizer.getAsync . O remetente de e-mail ou organizador de compromissos é sempre um utilizador cujo endereço de e-mail está no servidor 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 e-mail.

User = "user"

Especifica que o destinatário é um endereço de e-mail SMTP no servidor Exchange.

ExternalUser = "externalUser"

Especifica que o destinatário é um endereço de e-mail SMTP que não está no servidor Exchange. Refere-se também a um destinatário adicionado a partir de um livro de endereços pessoal do Outlook.

Importante: no Outlook na Web, no Windows (novo e clássico (a partir da Versão 2210, Compilação 15813.20002)) e no Mac, os destinatários do Livro de Endereços Global (GAL) guardados num livro de endereços pessoal devolvem o valor, mesmo que o ExternalUser respetivo endereço de e-mail SMTP seja apresentado no servidor Exchange. Os destinatários só devolvem um User valor se forem diretamente adicionados ou resolvidos em relação à GAL.

Other = "other"

Especifica que o destinatário não é um dos outros tipos de destinatários. Também se refere a um destinatário que não é resolvido relativamente ao livro de endereços do Exchange e, por conseguinte, é tratado como um endereço SMTP externo.

Importante: no Outlook para Android e no iOS, os destinatários do Livro de Endereços Global (GAL) guardados num livro de endereços pessoal devolvem o valor, mesmo que o Other respetivo endereço de e-mail SMTP seja apresentado no servidor Exchange. Os destinatários só devolvem um User valor se forem diretamente adicionados ou resolvidos em relação à GAL.