在 Outlook 的撰写窗体中获取和设置项目数据
了解如何在撰写方案中获取或设置 Outlook 外接程序中项目的不同属性,包括收件人、主题、正文和约会地点和时间。
获取和设置撰写加载项的项目属性
在撰写窗体中,您可以如同在阅读窗体中一样,获取在同一类型的项目上公开的大部分属性(如参与者、收件人、主题和正文),还可以获取仅与撰写窗体(而非阅读窗体)相关的一些其他属性(正文、密件抄送)。
对于大多数属性,由于 Outlook 外接程序和用户可能会同时修改用户界面中的同一个属性,获取和设置属性的方法将为异步。 表 1 列出了项目级别属性以及用于在撰写窗体中获取和设置属性的相应异步方法。 item.itemType 和 item.conversationId 属性是例外,因为用户无法修改。 您可以使用与在阅读窗体中相同的编程方式,在撰写窗体中直接从父对象获取这些属性。
除了访问 Office JavaScript API 中的项属性外,还可以使用 Exchange Web Services (EWS) 访问项目级属性。 使用 读/写邮箱 权限,可以使用 mailbox.makeEwsRequestAsync 方法访问 EWS 操作 GetItem 和 UpdateItem,以获取和设置用户邮箱中项目或项目的更多属性。
方法 makeEwsRequestAsync
在撰写窗体和阅读窗体中均可用。 有关 读/写邮箱 权限以及通过 Office 外接程序平台访问 EWS 的详细信息,请参阅 了解 Outlook 外接程序权限 和 从 Outlook 外接程序调用 Web 服务。
表 1. 在撰写窗体中获取或设置项目属性的异步方法
属性 | 属性类型 | 获取的异步方法 | 要设置的异步方法 |
---|---|---|---|
bcc | 收件人 | Recipients.getAsync | Recipients.addAsync, Recipients.setAsync |
body | Body | Body.getAsync | Body.prependAsync, Body.setAsync, Body.setSelectedDataAsync |
cc | 收件人 | Recipients.getAsync | Recipients.addAsync Recipients.setAsync |
end | Time | Time.getAsync | Time.setAsync |
location | 位置 | Location.getAsync | Location.setAsync |
optionalAttendees | 收件人 | Recipients.getAsync | Recipients.addAsync Recipients.setAsync |
requiredAttendees | 收件人 | Recipients.getAsync | Recipients.addAsync Recipients.setAsync |
start | 时间 | Time.getAsync | Time.setAsync |
subject | Subject | Subject.getAsync | Subject.setAsync |
to | 收件人 | Recipients.getAsync | Recipients.addAsync Recipients.setAsync |