Просмотр и изменение данных элемента Outlook в формах чтения и создания

  • Статья

Начиная с версии 1.1 схемы манифестов для надстроек Office, Outlook может активировать надстройки, когда пользователь просматривает или создает элемент. В зависимости от активации надстройки в форме чтения или создания элемента, свойства, доступные надстройке для элемента, так же отличаются.

Например, свойства dateTimeCreated и dateTimeModified определены только для элемента, который уже был отправлен (элемент затем просматривается в форме чтения), но не для элемента, который создается (в форме создания). Другим примером является свойство bcc, которое имеет смысл, если сообщение создается (в форме создания), и недоступно пользователю в форме чтения.

Свойства элементов, доступные в формах создания и чтения элементов

В таблице 1 показаны свойства на уровне элементов в API JavaScript для Office, доступные в каждом режиме (чтение и создание) почтовых надстроек. Как правило, эти свойства, доступные в формах чтения, доступны только для чтения, а доступные в формах создания — для чтения и записи, за исключением свойств itemId, conversationId и itemType , которые всегда доступны только для чтения независимо от того.

Для остальных свойств на уровне элемента, доступных в формах создания (поскольку надстройка и пользователь могут просматривать или записывать одно и то же свойство одновременно), применяются асинхронные методы просмотра или изменения в режиме создания, поэтому типы объектов, возвращаемых этими свойствами, также могут отличаться в формах создания и чтения. Дополнительные сведения об использовании асинхронных методов просмотра или изменения свойств на уровне элементов в режиме создания см. статью Просмотр и изменение данных элемента в форме создания элементов Outlook.

Таблица 1. Свойства элементов, доступные в формах создания и чтения элементов


Тип элемента Свойство Тип свойства в формах просмотра элементов Тип свойства в формах создания элементов
Встречи и сообщения dateTimeCreated Объект JavaScript Date Свойство недоступно
Встречи и сообщения dateTimeModified Объект JavaScript Date Свойство недоступно
Встречи и сообщения itemClass Строка Свойство недоступно
Встречи и сообщения itemId Строка Свойство недоступно
Встречи и сообщения itemType Строка в перечислении ItemType Строка в перечислении ItemType (только для чтения)
Встречи и сообщения attachments AttachmentDetails Свойство недоступно
Встречи и сообщения body Body Body
Встречи и сообщения normalizedSubject Строка Свойство недоступно
Встречи и сообщения subject Строка Subject
Встречи end Объект JavaScript Date Time
Встречи location Строка Location
Встречи optionalAttendees EmailAddressDetails Recipients
Встречи organizer EmailAddressDetails Organizer
Встречи requiredAttendees EmailAddressDetails Recipients
Встречи start Объект JavaScript Date Time
Сообщения bcc Свойство недоступно Получатели
Сообщения cc EmailAddressDetails Получатели
Сообщения conversationId Строка String (только для чтения)
Сообщения from EmailAddressDetails From
Сообщения internetMessageId Целое число Свойство недоступно
Сообщения sender EmailAddressDetails Свойство недоступно
Сообщения to EmailAddressDetails Получатели

Использование маркеров обратного вызова Exchange Server из надстройки для просмотра элементов

Если надстройка Outlook активирована в формах просмотра элементов, вы можете получить маркер обратного вызова Exchange. Этот маркер можно использовать в серверном коде для доступа ко всему элементу через веб-службы Exchange (EWS).

Указав разрешение на чтение элемента в манифесте надстройки, можно использовать метод mailbox.getCallbackTokenAsync для получения маркера обратного вызова Exchange, свойство mailbox.ewsUrl для получения URL-адреса конечной точки EWS для почтового ящика пользователя и item.itemId для получения идентификатора EWS для выбранного элемента. Затем передайте маркер обратного вызова, URL-адрес конечной точки EWS и идентификатор элемента EWS в серверный код для доступа к операции GetItem, что позволить получить больше свойств для элемента.

Доступ к веб-службам EWS из надстройки для просмотра или создания элементов

Вы также можете использовать метод mailbox.makeEwsRequestAsync, чтобы получить доступ к операциям веб-служб Exchange (EWS) GetItem и UpdateItem непосредственно из надстройки. Эти операции можно использовать для просмотра и изменения многих свойств заданного элемента. Этот метод доступен надстройкам Outlook независимо от того, активирована ли надстройка в форме чтения или создания, при условии, что в манифесте надстройки указано разрешение на чтение и запись почтового ящика . Дополнительные сведения о разрешении на чтение и запись почтового ящика см. в разделе Общие сведения о разрешениях надстройки Outlook.

Дополнительные сведения об использовании метода makeEwsRequestAsync для получения доступа к операциям EWS см. в статье Вызов веб-служб из надстройки Outlook.

См. также