Share via

在 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

另请参阅