Поделиться через


Office.MailboxEnums.RecipientType enum

Указывает тип получателя сообщения или встречи.

Комментарии

[ Набор API: Почтовый ящик 1.1 ]

Применимый режим Outlook: Compose или чтение

Важно!recipientType Значение свойства не возвращается методами Office.context.mailbox.item.from.getAsync и Office.context.mailbox.item.organizer.getAsync. Отправитель электронной почты или организатор встречи всегда является пользователем, адрес электронной почты которого находится на сервере Exchange Server.

Примеры

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

Поля

DistributionList = "distributionList"

Указывает, что получатель является списком рассылки, содержащим список адресов электронной почты.

User = "user"

Указывает, что получатель является SMTP-адресом электронной почты на сервере Exchange Server.

ExternalUser = "externalUser"

Указывает, что получатель является SMTP-адресом электронной почты, который не находится на сервере Exchange Server. Он также относится к получателю, добавленного из личной адресной книги Outlook.

Важно! В Outlook в Интернете в Windows (новые и классические (начиная с версии 2210, сборка 15813.20002)) и Mac получатели глобальной адресной книги (GAL), сохраненные в личной адресной книге, возвращают ExternalUser значение, даже если их SMTP-адрес электронной почты отображается на сервере Exchange Server. Получатели возвращают User значение только в том случае, если они напрямую добавлены или разрешены в глобальном списке адресов.

Other = "other"

Указывает, что получатель не является одним из других типов получателей. Он также относится к получателю, который не разрешается в адресной книге Exchange и поэтому обрабатывается как внешний SMTP-адрес.

Важно! В Outlook для Android и в iOS получатели глобальной адресной книги (GAL), сохраненные в личной адресной книге, возвращают Other значение, даже если их SMTP-адрес электронной почты отображается на сервере Exchange Server. Получатели возвращают User значение только в том случае, если они напрямую добавлены или разрешены в глобальном списке адресов.