Просмотр и изменение данных элемента в форме создания элементов 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 |
См. также
Office Add-ins