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

  • Статья

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

Получение и установка свойств элемента для надстройки создания

В формах создания можно получить доступ к большинству свойств, предоставляемых таким типом элемента в форме чтения (например, участники, получатели, тема и текст), а несколько дополнительных свойств доступны только в форме создания (текст, СК).

Методы получения и задания большинства этих свойств асинхронные, так как надстройка Outlook и пользователь могут изменять одно свойство в пользовательском интерфейсе одновременно. В таблице 1 перечислены свойства уровня элемента и соответствующие асинхронные методы для их получения и задания в форме создания. Исключение составляют свойства item.itemType и item.conversationId, потому что пользователи не могут их менять. Их можно получить программно в форме создания так же, как и в форме чтения, напрямую из родительского объекта.

Помимо доступа к свойствам элементов в API JavaScript для Office, вы можете получить доступ к свойствам уровня элемента с помощью веб-служб Exchange (EWS). С разрешением на чтение и запись почтового ящика можно использовать метод mailbox.makeEwsRequestAsync для доступа к операциям EWS , GetItem и UpdateItem, чтобы получить и задать дополнительные свойства элемента или элементов в почтовом ящике пользователя.

Метод makeEwsRequestAsync доступен в формах создания и чтения. Дополнительные сведения о разрешении на чтение и запись почтового ящика и доступе к EWS через платформу надстроек Office см. в разделе Общие сведения о разрешениях надстроек Outlook и вызове веб-служб из надстройки Outlook.

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

Свойство Тип свойства Асинхронный метод для получения свойства Асинхронные методы для задания
bcc Recipients Recipients.getAsync Recipients.addAsync, Recipients.setAsync
body Body Body.getAsync Body.prependAsync, Body.setAsync, Body.setSelectedDataAsync
cc Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync
end Time Time.getAsync Time.setAsync
location Location Location.getAsync Location.setAsync
optionalAttendees Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync
requiredAttendees Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync
start Time Time.getAsync Time.setAsync
subject Subject Subject.getAsync Subject.setAsync
to Recipients Recipients.getAsync Recipients.addAsync Recipients.setAsync

См. также