Office.MailboxEnums.RecipientType enum

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

Комментарии

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

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

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

Используется

Примеры

// 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.

ExternalUser = "externalUser"

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

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

Other = "other"

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

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