Office.AttachmentDetailsCompose interface

Пакет:
outlook

Представляет вложение в элементе. Только в режиме создания.

AttachmentDetailsCompose Массив объектов возвращается методом getAttachmentsAsync .

Комментарии

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

Минимальный уровень разрешений: чтение элемента

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

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

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/attachments-compose.yaml

Office.context.mailbox.item.getAttachmentsAsync((result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.error(result.error.message);
    return;
  }

  if (result.value.length > 0) {
    for (let i = 0; i < result.value.length; i++) {
      const attachment = result.value[i];
      let attachmentType;
      switch (attachment.attachmentType) {
        case Office.MailboxEnums.AttachmentType.Cloud:
          attachmentType = "Attachment is stored in a cloud location";
          break;
        case Office.MailboxEnums.AttachmentType.File:
          attachmentType = "Attachment is a file";
          break;
        case Office.MailboxEnums.AttachmentType.Item:
          attachmentType = "Attachment is an Exchange item";
          break;
      }
      console.log(
        "ID: " +
          attachment.id +
          "\n" +
          "Type: " +
          attachmentType +
          "\n" +
          "Name: " +
          attachment.name +
          "\n" +
          "Size: " +
          attachment.size +
          "\n" +
          "isInline: " +
          attachment.isInline
      );
    }
  } else {
    console.log("No attachments on this message.");
  }
});

Свойства

attachmentType

Возвращает значение, указывающее тип вложения.
contentId

Возвращает идентификатор содержимого встроенного вложения.
id

Возвращает идентификатор вложения. Значение зависит от клиента Outlook.

  • В Outlook в Интернете и новом Outlook в Windows идентификатором является идентификатор веб-служб Exchange (EWS). Для встроенных вложений начальным идентификатором является временный идентификатор вложения с префиксом addinId, а вложение передается на сервер. После завершения отправки вложение получает идентификатор EWS. Дополнительные сведения см. в примечаниях в разделе Примечания.

  • В Outlook в Windows (классической версии) и на Mac идентификатором встроенных и нестроных вложений является индекс вложения.
isInline

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

В Outlook в Интернете и новом Outlook в Windows указывает, было ли отправлено встроенное вложение в сообщении на сервер и назначен идентификатор веб-служб Exchange (EWS).
name

Получает имя вложения.
size

Получает размер вложения в байтах.
url

Возвращает URL-адрес вложения, если его тип — MailboxEnums.AttachmentType.Cloud.

Сведения о свойстве

attachmentType

Возвращает значение, указывающее тип вложения.

attachmentType: MailboxEnums.AttachmentType | string;

Значение свойства

Office.MailboxEnums.AttachmentType | string

Комментарии

Важно!

  • В Outlook в Интернете и новом Outlook в Windows сообщение или встреча, которые локально сохраняются, а затем присоединяются с помощью перетаскивания или параметра Присоединить элемент имеет тип Office.MailboxEnums.AttachmentType.File. Расширение имени файла возвращается в свойстве name . Однако сообщение или встреча, присоединенные с помощью параметра Переслать как вложение , имеет тип Office.MailboxEnums.AttachmentType.Item. В этом случае расширение не возвращается в свойстве name .

  • В классическом Outlook в Windows сообщение или встреча, присоединенные с помощью перетаскивания, вложить файл или Переслать как вложение , имеет тип Office.MailboxEnums.AttachmentType.Item. Расширение имени файла не возвращается в свойстве name .

  • В Outlook для Mac сообщение или встреча, присоединенные с помощью перетаскивания, присоединения элемента или пересылки как вложение , имеет тип Office.MailboxEnums.AttachmentType.File. Расширение имени файла возвращается в свойстве name .

contentId

Возвращает идентификатор содержимого встроенного вложения.

contentId: string;

Значение свойства

string

Комментарии

Важно!

  • Свойство contentId поддерживается только в Outlook в Интернете, новом Outlook для Windows и классическом Outlook для Windows (предварительная версия). Чтобы предварительно просмотреть contentId свойство в классической версии Outlook в Windows, клиент Outlook должен запустить версию 2510 (сборка 19312.20000) или более позднюю версию и быть на канале бета-версии. Дополнительные сведения см. в статье Программа предварительной оценки Microsoft 365.

  • Изменения в том, как встроенные изображения представлены в тексте HTML сообщений Электронной почты Outlook в Outlook в Интернете и в новом Outlook для Windows, выпущенном 15 ноября 2025 г. Ранее идентификатор вложения изображения отображался в атрибуте src применимого <img> элемента. Теперь изображение представлено идентификатором содержимого (cid) в атрибуте src . Если вы анализируете идентификатор вложения из редактора HTML или получает значение изображения в кодировке Base64 из URL-адреса в атрибуте src , необходимо обновить логику синтаксического анализа надстройки. Дополнительные сведения см. в разделах Изменения представления встроенного изображения в Outlook в Интернете и новый Outlook для Windows.

id

Возвращает идентификатор вложения. Значение зависит от клиента Outlook.

  • В Outlook в Интернете и новом Outlook в Windows идентификатором является идентификатор веб-служб Exchange (EWS). Для встроенных вложений начальным идентификатором является временный идентификатор вложения с префиксом addinId, а вложение передается на сервер. После завершения отправки вложение получает идентификатор EWS. Дополнительные сведения см. в примечаниях в разделе Примечания.

  • В Outlook в Windows (классической версии) и на Mac идентификатором встроенных и нестроных вложений является индекс вложения.

id: string;

Значение свойства

string

Комментарии

Важно! Начиная с 30 марта 2026 г., после завершения вызова addFileAttachmentAsync или addFileAttachmentFromBase64Async после isInlinetrue завершения, встроенным изображениям в сообщениях в Outlook в Интернете и новом Outlook в Windows локально назначается временный идентификатор вложения во время их отправки на сервер. Временный идентификатор вложения имеет префикс addinId. После отправки образов на сервер им назначается идентификатор веб-служб Exchange (EWS). Временный идентификатор вложения поддерживается только в течение текущего сеанса создания. Дополнительные сведения об изменениях обработки встроенных образов см. в статье Изменения идентификаторов вложений для встроенных образов в надстройках Outlook.

isInline

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

isInline: boolean;

Значение свойства

boolean

isServiceAccessible

В Outlook в Интернете и новом Outlook в Windows указывает, было ли отправлено встроенное вложение в сообщении на сервер и назначен идентификатор веб-служб Exchange (EWS).

isServiceAccessible: boolean;

Значение свойства

boolean

Комментарии

Важно!

  • Начиная с 30 марта 2026 г., после завершения вызова addFileAttachmentAsync или addFileAttachmentFromBase64Async после isInlinetrue завершения, встроенным изображениям в Outlook в Интернете и новой версии Outlook в Windows локально назначается временный идентификатор вложения во время их отправки на сервер. Временный идентификатор вложения имеет префикс addinId. После отправки изображений на сервер им назначается идентификатор веб-служб Exchange (EWS) в свойстве id , а их isServiceAccessible свойству trueприсваивается значение . Временный идентификатор вложения поддерживается только в течение текущего сеанса создания. Дополнительные сведения об изменениях обработки встроенных образов см. в статье Изменения идентификаторов вложений для встроенных образов в надстройках Outlook.

  • В Outlook в Windows (классической) и на Mac свойство всегда возвращаетсяfalse, isServiceAccessible так как идентификатор вложения является индексом вложения.

name

Получает имя вложения.

name: string;

Значение свойства

string

Комментарии

Важно!

  • Вложение типа Office.MailboxEnums.AttachmentType.Item не возвращает расширение имени файла в свойстве name .

  • В Outlook в Интернете и новом Outlook в Windows сообщение или встреча, которые локально сохраняются, а затем присоединяются с помощью перетаскивания или параметра Присоединить элемент имеет тип Office.MailboxEnums.AttachmentType.File. Расширение имени файла возвращается в свойстве name . Однако сообщение или встреча, присоединенные с помощью параметра Переслать как вложение , имеет тип Office.MailboxEnums.AttachmentType.Item. В этом случае расширение не возвращается в свойстве name .

  • В классическом Outlook в Windows сообщение или встреча, присоединенные с помощью перетаскивания, вложить файл или Переслать как вложение , имеет тип Office.MailboxEnums.AttachmentType.Item. Расширение имени файла не возвращается в свойстве name .

  • В Outlook для Mac сообщение или встреча, присоединенные с помощью перетаскивания, присоединения элемента или пересылки как вложение , имеет тип Office.MailboxEnums.AttachmentType.File. Расширение имени файла возвращается в свойстве name .

size

Получает размер вложения в байтах.

size: number;

Значение свойства

number

url

Возвращает URL-адрес вложения, если его тип — MailboxEnums.AttachmentType.Cloud.

url?: string;

Значение свойства

string