Office.Recipients interface

Добавляет список получателей к существующим получателям для встречи или сообщения.

addAsync(recipients: Array<string | EmailUser | EmailAddressDetails>, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Параметры

recipients: Array<string | Office.EmailUser | Office.EmailAddressDetails>

Получатели, которых нужно добавить в список получателей. Массив получателей может содержать строки адресов электронной почты SMTP, объектов EmailUser или EmailAddressDetails .

options: Office.AsyncContextOptions

Литерал объекта, содержащий одно или несколько следующих свойств:- asyncContext: разработчики могут предоставить любой объект, к которому они хотят получить доступ в функции обратного вызова.

callback: (asyncResult: Office.AsyncResult<void>) => void

Необязательный параметр. После завершения метода функция, переданная в callback параметре, вызывается с одним параметром типа Office.AsyncResult. Если добавить получателей не удастся, свойство asyncResult.error будет содержать код ошибки.

Возвращаемое значение

void

Важно! С помощью addAsync метода можно добавить не более 100 получателей к почтовому элементу в Outlook в Интернете, в Windows (новая и классическая версия), в Mac (классический пользовательский интерфейс), в Android и в iOS. Однако обратите внимание на следующее:

В Outlook в Интернете, в Windows (новая и классическая версия) и в Mac (классический пользовательский интерфейс) в целевом поле может быть не более 500 получателей. Если необходимо добавить более 100 получателей в почтовый элемент, вы можете позвонить addAsync повторно, но помните об ограничении получателя поля.
В Outlook для Android и в iOS addAsync метод не поддерживается в режиме Compose сообщений. Поддерживается только режим организатора встреч. Дополнительные сведения о поддерживаемых API в Outlook Mobile см. в статье API JavaScript Для Outlook, поддерживаемые в Outlook на мобильных устройствах.

При вызове addAsync Outlook на Mac (новый пользовательский интерфейс) ограничение на получателей не ограничено.

Ошибки:

NumberOfRecipientsExceeded : число получателей превысило 100 записей.

Примеры

// The following example creates an array of EmailUser objects
// and adds them to the To recipients of the message.
const newRecipients = [
    {
        "displayName": "Allie Bellew",
        "emailAddress": "allieb@contoso.com"
    },
    {
        "displayName": "Alex Darrow",
        "emailAddress": "alexd@contoso.com"
    }
];

Office.context.mailbox.item.to.addAsync(newRecipients, function(result) {
    if (result.error) {
        console.log(result.error);
    } else {
        console.log("Recipients added");
    }
});

Добавляет список получателей к существующим получателям для встречи или сообщения.

addAsync(recipients: Array<string | EmailUser | EmailAddressDetails>, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Параметры

recipients: Array<string | Office.EmailUser | Office.EmailAddressDetails>

Получатели, которых нужно добавить в список получателей. Массив получателей может содержать строки адресов электронной почты SMTP, объектов EmailUser или EmailAddressDetails .

callback: (asyncResult: Office.AsyncResult<void>) => void

Необязательный параметр. После завершения метода функция, переданная в callback параметре, вызывается с одним параметром типа Office.AsyncResult. Если добавить получателей не удастся, свойство asyncResult.error будет содержать код ошибки.

Возвращаемое значение

void

Важно! С помощью addAsync метода можно добавить не более 100 получателей к почтовому элементу в Outlook в Интернете, в Windows (новая и классическая версия), в Mac (классический пользовательский интерфейс), в Android и в iOS. Однако обратите внимание на следующее:

В Outlook в Интернете, в Windows (новая и классическая версия) и в Mac (классический пользовательский интерфейс) в целевом поле может быть не более 500 получателей. Если необходимо добавить более 100 получателей в почтовый элемент, вы можете позвонить addAsync повторно, но помните об ограничении получателя поля.
В Outlook для Android и в iOS addAsync метод не поддерживается в режиме Compose сообщений. Поддерживается только режим организатора встреч. Дополнительные сведения о поддерживаемых API в Outlook Mobile см. в статье API JavaScript Для Outlook, поддерживаемые в Outlook на мобильных устройствах.

При вызове addAsync Outlook на Mac (новый пользовательский интерфейс) ограничение на получателей не ограничено.

Ошибки:

NumberOfRecipientsExceeded : число получателей превысило 100 записей.

Возвращает список получателей для встречи или сообщения.

getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<EmailAddressDetails[]>) => void): void;

Параметры

options: Office.AsyncContextOptions

Литерал объекта, содержащий одно или несколько следующих свойств:- asyncContext: разработчики могут предоставить любой объект, к которому они хотят получить доступ в функции обратного вызова.

callback: (asyncResult: Office.AsyncResult<Office.EmailAddressDetails[]>) => void

После завершения метода функция, переданная в callback параметре, вызывается с одним параметром ,asyncResult с типом Office.AsyncResult. Свойство asyncResult.value результата представляет собой массив объектов EmailAddressDetails .

Возвращаемое значение

void

Windows (новая и классическая версия), веб-браузер, Mac (классический пользовательский интерфейс): 500 получателей
Android, iOS: 100 получателей
Mac (новый пользовательский интерфейс): без ограничений

Метод getAsync возвращает только получателей, разрешенных клиентом Outlook. Разрешенный получатель имеет следующие характеристики.

Если у получателя есть сохраненная запись в адресной книге отправителя, Outlook разрешает адрес электронной почты в сохраненное отображаемое имя получателя.
Перед именем или адресом электронной почты получателя появится значок состояния собрания Teams.
После имени или адреса электронной почты получателя появится точка с запятой.
Имя или адрес электронной почты получателя подчеркнут или заключены в поле.

Чтобы разрешить адрес электронной почты после его добавления в почтовый элемент, отправитель должен использовать клавишу TAB или выбрать предлагаемый контакт или адрес электронной почты из списка автозаполнения.

В Outlook в Интернете и в Windows (новые и классические), если пользователь создает новое сообщение путем активации ссылки на адрес электронной почты контакта из своего контакта или профиля карта, вызов надстройки Recipients.getAsync возвращает адрес электронной почты контакта в displayName свойстве связанного объекта EmailAddressDetails вместо сохраненного имени контакта. Дополнительные сведения см. в статье о проблеме с GitHub.

При создании почтового элемента при переключении на учетную запись отправителя, которая находится в домене, отличном от домена ранее выбранной recipientType учетной записи отправителя, значение свойства для существующих получателей не обновляется и по-прежнему будет основываться на домене ранее выбранной учетной записи. Чтобы получить правильные типы получателей после переключения учетных записей, необходимо сначала удалить существующих получателей, а затем добавить их обратно в почтовый элемент.

Возвращает список получателей для встречи или сообщения.

getAsync(callback: (asyncResult: Office.AsyncResult<EmailAddressDetails[]>) => void): void;

Параметры

callback: (asyncResult: Office.AsyncResult<Office.EmailAddressDetails[]>) => void

После завершения метода функция, переданная в callback параметре, вызывается с одним параметром ,asyncResult с типом Office.AsyncResult. Свойство asyncResult.value результата представляет собой массив объектов EmailAddressDetails .

Возвращаемое значение

void

Windows (новая и классическая версия), веб-браузер, Mac (классический пользовательский интерфейс): 500 получателей
Android, iOS: 100 получателей
Mac (новый пользовательский интерфейс): без ограничений

Метод getAsync возвращает только получателей, разрешенных клиентом Outlook. Разрешенный получатель имеет следующие характеристики.

Если у получателя есть сохраненная запись в адресной книге отправителя, Outlook разрешает адрес электронной почты в сохраненное отображаемое имя получателя.
Перед именем или адресом электронной почты получателя появится значок состояния собрания Teams.
После имени или адреса электронной почты получателя появится точка с запятой.
Имя или адрес электронной почты получателя подчеркнут или заключены в поле.

Чтобы разрешить адрес электронной почты после его добавления в почтовый элемент, отправитель должен использовать клавишу TAB или выбрать предлагаемый контакт или адрес электронной почты из списка автозаполнения.

В Outlook в Интернете и в Windows (новые и классические), если пользователь создает новое сообщение путем активации ссылки на адрес электронной почты контакта из своего контакта или профиля карта, вызов надстройки Recipients.getAsync возвращает адрес электронной почты контакта в displayName свойстве связанного объекта EmailAddressDetails вместо сохраненного имени контакта. Дополнительные сведения см. в статье о проблеме с GitHub.

При создании почтового элемента при переключении на учетную запись отправителя, которая находится в домене, отличном от домена ранее выбранной recipientType учетной записи отправителя, значение свойства для существующих получателей не обновляется и по-прежнему будет основываться на домене ранее выбранной учетной записи. Чтобы получить правильные типы получателей после переключения учетных записей, необходимо сначала удалить существующих получателей, а затем добавить их обратно в почтовый элемент.

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-set-bcc-message-compose.yaml

Office.context.mailbox.item.bcc.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const msgBcc = asyncResult.value;
    console.log("Message being blind-copied to:");
    for (let i = 0; i < msgBcc.length; i++) {
      console.log(msgBcc[i].displayName + " (" + msgBcc[i].emailAddress + ")");
    }
  } else {
    console.error(asyncResult.error);
  }
});

...

Office.context.mailbox.item.cc.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const msgCc = asyncResult.value;
    console.log("Message being copied to:");
    for (let i = 0; i < msgCc.length; i++) {
      console.log(msgCc[i].displayName + " (" + msgCc[i].emailAddress + ")");
    }
  } else {
    console.error(asyncResult.error);
  }
});

...

Office.context.mailbox.item.optionalAttendees.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const apptOptionalAttendees = asyncResult.value;
    for (let i = 0; i < apptOptionalAttendees.length; i++) {
      console.log(
        "Optional attendees: " +
          apptOptionalAttendees[i].displayName +
          " (" +
          apptOptionalAttendees[i].emailAddress +
          ") - response: " +
          apptOptionalAttendees[i].appointmentResponse
      );
    }
  } else {
    console.error(asyncResult.error);
  }
});

...

Office.context.mailbox.item.requiredAttendees.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const apptRequiredAttendees = asyncResult.value;
    for (let i = 0; i < apptRequiredAttendees.length; i++) {
      console.log(
        "Required attendees: " +
          apptRequiredAttendees[i].displayName +
          " (" +
          apptRequiredAttendees[i].emailAddress +
          ") - response: " +
          apptRequiredAttendees[i].appointmentResponse
      );
    }
  } else {
    console.error(asyncResult.error);
  }
});

...

Office.context.mailbox.item.to.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const msgTo = asyncResult.value;
    console.log("Message being sent to:");
    for (let i = 0; i < msgTo.length; i++) {
      console.log(msgTo[i].displayName + " (" + msgTo[i].emailAddress + ")");
    }
  } else {
    console.error(asyncResult.error);
  }
});

Задает список получателей для встречи или сообщения.

Метод setAsync перезаписывает текущий список получателей.

setAsync(recipients: Array<string | EmailUser | EmailAddressDetails>, options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<void>) => void): void;

Параметры

recipients: Array<string | Office.EmailUser | Office.EmailAddressDetails>

Получатели, которых нужно добавить в список получателей. Массив получателей может содержать строки адресов электронной почты SMTP, объектов EmailUser или EmailAddressDetails .

options: Office.AsyncContextOptions

Литерал объекта, содержащий одно или несколько следующих свойств:- asyncContext: разработчики могут предоставить любой объект, к которому они хотят получить доступ в функции обратного вызова.

callback: (asyncResult: Office.AsyncResult<void>) => void

После завершения метода функция, переданная в callback параметре, вызывается с одним параметром типа Office.AsyncResult. Если задать получателей не удастся, свойство asyncResult.error будет содержать код ошибки, произошедшей при добавлении данных.

Возвращаемое значение

void

Важно! С помощью setAsync метода можно задать не более 100 получателей в Outlook в Интернете, Windows (новая и классическая версия), Mac (классический пользовательский интерфейс), Android и iOS. Однако обратите внимание на следующее:

В Outlook в Интернете, в Windows (новая и классическая версия) и в Mac (классический пользовательский интерфейс) в целевом поле может быть не более 500 получателей. Если вам нужно задать более 100 получателей, можно звонить setAsync повторно, но помните об ограничении получателей поля.
В Outlook для Android и в iOS setAsync метод не поддерживается в режиме Compose сообщений. Поддерживается только режим организатора встреч. Дополнительные сведения о поддерживаемых API в Outlook Mobile см. в статье API JavaScript Для Outlook, поддерживаемые в Outlook на мобильных устройствах.

При вызове setAsync Outlook на Mac (новый пользовательский интерфейс) ограничение на получателей не ограничено.

Ошибки:

NumberOfRecipientsExceeded : число получателей превысило 100 записей.

Задает список получателей для встречи или сообщения.

Метод setAsync перезаписывает текущий список получателей.

setAsync(recipients: Array<string | EmailUser | EmailAddressDetails>, callback: (asyncResult: Office.AsyncResult<void>) => void): void;

Параметры

recipients: Array<string | Office.EmailUser | Office.EmailAddressDetails>

Получатели, которых нужно добавить в список получателей. Массив получателей может содержать строки адресов электронной почты SMTP, объектов EmailUser или EmailAddressDetails .

callback: (asyncResult: Office.AsyncResult<void>) => void

После завершения метода функция, переданная в callback параметре, вызывается с одним параметром типа Office.AsyncResult. Если задать получателей не удастся, свойство asyncResult.error будет содержать код ошибки, произошедшей при добавлении данных.

Возвращаемое значение

void

Важно! С помощью setAsync метода можно задать не более 100 получателей в Outlook в Интернете, Windows (новая и классическая версия), Mac (классический пользовательский интерфейс), Android и iOS. Однако обратите внимание на следующее:

В Outlook в Интернете, в Windows (новая и классическая версия) и в Mac (классический пользовательский интерфейс) в целевом поле может быть не более 500 получателей. Если вам нужно задать более 100 получателей, можно звонить setAsync повторно, но помните об ограничении получателей поля.
В Outlook для Android и в iOS setAsync метод не поддерживается в режиме Compose сообщений. Поддерживается только режим организатора встреч. Дополнительные сведения о поддерживаемых API в Outlook Mobile см. в статье API JavaScript Для Outlook, поддерживаемые в Outlook на мобильных устройствах.

При вызове setAsync Outlook на Mac (новый пользовательский интерфейс) ограничение на получателей не ограничено.

Ошибки:

NumberOfRecipientsExceeded : число получателей превысило 100 записей.

Примеры

// The following example creates an array of EmailUser objects and
// replaces the CC recipients of the message with the array.
const newRecipients = [
    {
        "displayName": "Allie Bellew",
        "emailAddress": "allieb@contoso.com"
    },
    {
        "displayName": "Alex Darrow",
        "emailAddress": "alexd@contoso.com"
    }
];

Office.context.mailbox.item.cc.setAsync(newRecipients, function(result) {
    if (result.error) {
        console.log(result.error);
    } else {
        console.log("Recipients overwritten");
    }
});

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-set-bcc-message-compose.yaml

const email = $("#emailBcc")
  .val()
  .toString();
const emailArray = [email];
Office.context.mailbox.item.bcc.setAsync(emailArray, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Succeeded in setting Bcc field.");
  } else {
    console.error(asyncResult.error);
  }
});

...

const email = $("#emailCc")
  .val()
  .toString();
const emailArray = [email];
Office.context.mailbox.item.cc.setAsync(emailArray, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Succeeded in setting Cc field.");
  } else {
    console.error(asyncResult.error);
  }
});

...

const email = $("#emailOptional")
  .val()
  .toString();
const emailArray = [email];
Office.context.mailbox.item.optionalAttendees.setAsync(emailArray, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Succeeded in setting optional attendees field.");
  } else {
    console.error(asyncResult.error);
  }
});

...

const email = $("#emailRequired")
  .val()
  .toString();
const emailArray = [email];
Office.context.mailbox.item.requiredAttendees.setAsync(emailArray, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Succeeded in setting required attendees field.");
  } else {
    console.error(asyncResult.error);
  }
});

...

const email = $("#emailTo")
  .val()
  .toString();
const emailArray = [email];
Office.context.mailbox.item.to.setAsync(emailArray, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Succeeded in setting To field.");
  } else {
    console.error(asyncResult.error);
  }
});

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

Комментарии

Методы

Сведения о методе

addAsync(recipients, options, callback)

Параметры

Возвращаемое значение

Комментарии

Примеры

addAsync(recipients, callback)

Параметры

Возвращаемое значение

Комментарии

getAsync(options, callback)

Параметры

Возвращаемое значение

Комментарии

getAsync(callback)

Параметры

Возвращаемое значение

Комментарии

Примеры

setAsync(recipients, options, callback)

Параметры

Возвращаемое значение

Комментарии

setAsync(recipients, callback)

Параметры

Возвращаемое значение

Комментарии

Примеры

Дополнительные ресурсы