本文所讨论的 Mailbox API是指在 Mail Add-in 中可调用的 JavaScript API。开发者可以利用这些API 实现 Add-in 和 Outlook 的交互（数据读取与写入）。希望大家通过这个简单的介绍，认识到 Office Add-In Model 为开发者提供了多大程度和邮件打交道的能力，如果碰巧有正准备开发 Mail Add-in 的同学, 不妨快速扫下 API 列表，然后衡量下它们能不能支撑你完成自己的 Scenarios。

开始之前，需要明确几个问题：

  • 本文中提到的Outlook是指: Outlook for Windows, Outlook for Mac, Outlook RT, OWA for Devices (OWA for Android phones, OWA for iPad, OWA for iPhone), 以及 Outlook Web App。 其中 "Outlook rich clients" 是指 Outlook for Windows, Outlook for Mac and Outlook RT。其中, Outlook for Mac 仅仅在Outlook 读邮件模式下支持JavaScript API for Office。

  • Office.js 在 CDN 上 1.0 版本引用地址为https://appsforoffice.microsoft.com/lib/1.0/hosted/Office.js，1.1 版本地址为 https://appsforoffice.microsoft.com/lib/1.1/hosted/Office.js。关于如何引用它们到你的网页中，可参考 https://msdn.microsoft.com/en-us/library/office/dn221992.aspx。

JavaScript API for Outlook (Mailbox API)

本文将从 Object Model 的角度罗列出 Mail Add-in 中可以访问的 Object 以及它所提供的方法和属性。

Object Name

Object 描述

JavaScript调用方式

Office

表示Add-in的一个实例，它是调用其它API相关的object（如Context等）的入口。

 
Office

Office.js版本：

Introduced in v1.0

Last changed in v1.1

在如下 Outlook 模式中可用：

撰写邮件、读邮件

(Compose or read)

最低权限要求：

N/A

官方文档：

https://msdn.microsoft.com/en-us/library/office/fp142234.aspx

Context

Add-in的运行时环境信息，并提供调用关键Object上 API的入口

 
Office.context

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

撰写邮件、读邮件

(Compose or read)

最低权限要求：

N/A

官方文档：https://msdn.microsoft.com/EN-US/library/office/fp161104.aspx

Mailbox

为office   add-in Object Model 提供访问入口

(Provides access to the app   for Office object model for Microsoft Outlook 2013 and Microsoft Outlook Web   App.)

 
Office.context.mailbox

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

撰写邮件、读邮件

(Compose or read)

最低权限要求：

ReadWriteMailbox,   but some members accessible with lesser permissions

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp142162.aspx

UserProfile

用来获取通过当前邮件使用mailbox add-in的用户的信息，它有如下几个属性：

Property     name

    Description
displayName          The     user name to use for display.   

emailAddress 

The user's SMTP email     address.

timeZone   

The     user's local time zone

 
var userProfile =   Office.context.mailbox.userProfile;

var name =   userProfile.displayName;

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

撰写邮件、读邮件(Compose   or read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/en-us/library/office/fp161126.aspx

Item

 

获得激活当前add-in的邮件信息条目或约会条目，Office.context.mailbox.item 的返回值取决于当前查看的邮件条目类型。例如，如果当前邮件条目是信息条目，返回值为一个Message Object；如果是一个约会条目，返回值为一个 Appointment Object。

Item object 是一个base Object，其他的“表示特定条目的Object”（如Appointment和Message）都是它的扩展。

  1. Appointment   Object表示当前约会条目
  2. Message Object 表示当前邮件信息
  3. MeetingRequest Object 扩展了 Message Object，表示一个会议邀请。（The MeetingRequest object is returned as the item property of the Mailbox object. The MeetingRequest   object extends the Message object. Represents a request to attend a   meeting.）

 

注意: 下面介绍的 Office.context.mailbox.item

的子 Object 或方法，有些是与当前邮件类型相关的。例如同样是Office.context.mailbox.item， 如果当前邮件条目为约会条目，则它有 requiredAttendees 属性，而邮件信息条目则会有 cc、to 等属性。

 
Office.context.mailbox.item

Office.js版本：

Introduced in v1.0

Last changed in v1.3

在如下 Outlook 模式中可用：

撰写邮件、读邮件

(Compose or read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp142177.aspx

Message Object

https://msdn.microsoft.com/EN-US/library/office/fp161175.aspx

MeetingRequest   Object

https://msdn.microsoft.com/EN-US/library/office/fp142237.aspx?f=255&MSPPError=-2147217396

Appointment Object

https://msdn.microsoft.com/EN-US/library/office/fp160964.aspx

AttachmentDetails

当前条目中包含的附件信息

 
Office.context.mailbox.item.attachments

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

读邮件

(Read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/jj984592.aspx

Body

当前信息或约会条目的正文内容

(该类型提供了针对邮件正文的方法，如setSelectedDataAsync)

 
Office.context.mailbox.item.body

Office.js版本：

Introduced in v1.1

Latest changed in v 1.3

在如下 Outlook 模式中可用：

撰写邮件

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/dn482486.aspx

Subject

提供用来获取和设置邮件主题的方法

(Provides methods to get and set the   subject of a meeting or message)

在撰写邮件（Compose）模式下：

Office.context.mailbox.item.subject 返回邮件会议或邮件信息的Subject对象，它提供了两种方法----- setAsync 和 getAsync。

SetAsync发送通过向 Exchange server 异步发送请求设置邮件会议或邮件信息的主题。设置主题时，会overrides原有的主题，但是原来的“转发”、“Fwd：”、“Re：”将会保留。

getAsync则可用来获得邮件主题。

在读邮件（Read）模式下：

Office.context.mailbox.item.subject 返回邮件会议或者邮件信息的主题（字符串）

撰写邮件模式下：

SetAsync具体使用，请参照官方文档https://msdn.microsoft.com/en-us/library/office/dn482531.aspx。

getAsync官方文档：https://msdn.microsoft.com/en-us/library/office/dn482529.aspx。

读邮件模式下：

Office.context.mailbox.item.subject 返回邮件的主题（字符串）

Office.js版本：

Introduced   in v1.1

在如下 Outlook 模式中可用：

撰写邮件、读邮件

(Compose  or read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/en-us/library/office/dn482528.aspx

Time

提供用于获取和设置会议起止时间的方法

仅仅适用于邮件会议或约会，即 Appointment才有start或end属性。

在撰写邮件（Compose）模式下：

Office.context.mailbox.item.start（或end）

返回一个Time   object，Time 对象提供了方法用来获取或设置会议起（或止）的时间。

Method     name

Description

getAsync    

Gets     the value of a start or end time.

setAsync    

Sets the value of a     start or end time.

在读邮件（Read）模式下：

Office.context.mailbox.item.start（或end）返回一个JavaScript Date object，表示会议的起（或止）的时间。

Office.context.mailbox.item.start

https://msdn.microsoft.com/en-us/library/office/fp161129.aspx

Office.context.mailbox.item.end

https://msdn.microsoft.com/en-us/library/office/fp142183.aspx

Office.js版本：

Introduced in v1.1

在如下 Outlook 模式中可用：

撰写邮件会议或约会（Compose）、读邮件会议或约会（Read）

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/en-us/library/office/dn482538.aspx

CustomProperties

为某个特定的邮件条目提供自定义的属性集合

 
Office.context.mailbox.item.loadCustomPropertiesAsync()

Office.js版本：

Introduces in v1.0

在如下 Outlook 模式中可用：

？？？？

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp142138.aspx

RoamingSettings

用来存储per   user，per add-in的custom settings

不同于CustomProperties，RoamingSettings中的值只能被创建该值的用户所访问，并且只能在被创建该值的add-in中访问到。

Setting的key是字符串类型的，value的类型则可以是string、number、boolean、null、object或者array。

RoamingSettings Object是作为Context对象的一部分自动加载的，当add-in被激活后，便可以通过访问 roamingSettings 来获得或设置其中的值。

（The settings created   by using the methods of the RoamingSettings object   are saved per app and per user. That is, they are available only to the app   that created them, and only from the user's mail box in which they are saved.）

The RoamingSettings   object is automatically loaded as part of the Context object, and is available by calling the roamingSettings property of that object when the add-in is   activated. The developer is responsible for calling the saveAsync method after adding or deleting settings to   save the settings in the user's mailbox.

 
// 从setting中获得值：

_settings = Office.context.roamingSettings;

_customerName = _settings.get("customerName");

// 添加新的key/value pair：

_settings.set("cookie", Date());

_settings.saveAsync(saveMyAppSettingsCallback);

更多的实例，请参考官方文档https://msdn.microsoft.com/en-us/library/office/fp161171.aspx。

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

撰写邮件、读邮件(Compose or read)

最低权限要求：

Restricted

官方文档：

https://msdn.microsoft.com/en-us/library/office/jj220079.aspx

Entities

Exchange Server 2013 server在邮件信息或约会中找到的entity集合，包括addresses，contacts，emailAddresses等等。

Entity集合中包含的内容详见下文中另一个表格

getEntities()

Entity 的识别依赖于自然语言的识别，而后者又要基于大量数据做机器学习才能做到，总的来说，entity的识别结果并不完全准确，识别的成功率很大程度上依赖于邮件中包含的特定语境信息。

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

读邮件

(Read)

最低权限要求：

ReadItem   but some properties accessible with Restricted.

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp160984.aspx

Location

该Object为会议或约会地点提供了get和set方法

Office.context.mailbox.item.location

Office.js版本：

Introduced in v1.1

在如下 Outlook 模式中可用：

撰写邮件

(Compose)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/dn482502.aspx

Recipients

利用该Object可以取得或者设置收件人。

如下Object的列出的各属性值均是Recipients 类型。

Object

Properties

Appointment    

Message     

var addressesToBeAdded = {

   {

      "displayName":"Graham   Durkin",

       "emailAddress":"gdurkin@contoso.com"

   },

   {

      "displayName" : "Donnie   Weinberg",

      "emailAddress" :   "dweinberg@contoso.com"

   }

}；

Office.context.mailbox.item.cc.addAsync(addressesToBeAdded, callback);

Office.js版本：

Introduced in v1.1

在如下 Outlook 模式中可用：

撰写邮件

(Compose)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/en-us/library/office/dn482517.aspx

Diagnostics

提供用于troubleshooting的信息

Office.context.mailbox.diagnostics

Office.js版本：

Introduced in V1.0

在如下 Outlook 模式中可用：

撰写邮件、读邮件

(Compose or read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/jj715287.aspx

Error

异步数据操作出错时的返回信息

(Provides specific information about an   error that occurred during an asynchronous data operation.)

asyncResult.error

Office.js版本：

Intro in v1.0

Changed in   v1.1

在如下 Outlook 模式中可用：

?

最低权限要求：N/A

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp161033.aspx

EmailAddressDetails

 

邮件地址详细信息

(该 Object 只是几个字段的封装，并不提供API调用)

Recipients.addAsync 方法可接受 EmailAddressDetails 类型的数组

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

撰写邮件、读邮件

(Compose or read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp161105.aspx

EmailUser

 

基于Exchange   Server 2013 的邮箱服务器上的邮箱账号（Represents an email account on an Exchange   Server 2013 server.）

(该类型只是几个字段的封装，并不提供API调用)

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

读邮件

（Read）

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp142187.aspx

Entities Object —— Exchange Server 可以根据邮件内容检测出地理位置、邮箱地址、联系人信息、任务分配信息等，我们可以利用 Office.context.mailbox.item.getEntities() 取出来这样一组信息集合，集合中包括如下几种类型的属性：

Object Name

Object 描述

JavaScript调用方式

Contacts

Exchange Server 2013 服务在邮件信息或约会条目中找到的联系人数组。

Office.context.mailbox.item.getEntities().contacts;

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

读邮件(Read)

最低权限要求：

Restricted

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp142242.aspx

MeetingSuggestion

Exchange Server 2013 服务在邮件信息或约会条目中找到的会议提议

(Represents a suggested meeting found in   an item.)

Office.context.mailbox.item.getEntities().meetingSuggestions;

Office.context.mailbox.item.getEntitiesByType

(Office.MailboxEnums.EntityType.MeetingSuggestion).meetingSuggestions;

Office.js版本：

Intro   in1.0

在如下 Outlook 模式中可用：

读邮件(Read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp142141.aspx

PhoneNumber

Exchange Server 2013 服务在邮件信息或约会条目中找到的电话号码

Represents a phone number   identified in an item.

Office.context.mailbox.item.getEntities().phoneNumbers;

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

读邮件(Read)

最低权限要求：

Restricted

官方文档：

https://msdn.microsoft.com/en-us/library/office/fp142244.aspx

TaskSuggestion

Exchange Server 2013 服务在邮件信息或约会条目中找到的任务分配建议

Office.context.mailbox.item.getEntities().taskSuggestions;

Office.context.mailbox.item.

getEntitiesByType(EntityType.TaskSuggestion).taskSuggestions;

PropertyName       Description

assignees  

返回一个EmailUser     类型的数组，每个元素代表检测出的任务建议中的任务执行者。

taskString    

 返回检测出的任务建议(字符串)   

Office.js版本：

Introduced   in v1.0

在如下 Outlook 模式中可用：

读邮件(Read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/en-us/library/office/fp160979.aspx

addresses

Exchange Server 2013 服务在邮件信息或约会条目中找到的地理位置

To be recognized   as an address, the string must contain a United States postal address that   has at least a subset of the elements of a street number, street name, city,   state, and zip code.

Office.context.mailbox.item.getEntities().addresses;

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

读邮件(Read)

最低权限要求：

Restricted

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp160959.aspx

emailAddresses

Exchange Server 2013 服务在邮件信息或约会条目中找到的SMTP邮件地址。

Office.context.mailbox.item.getEntities().emailAddresses；

Office.js版本：

Introduced   in v1.0

在如下 Outlook 模式中可用：

读邮件(Read)

最低权限要求：

ReadItem

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp161123.aspx

urls

Exchange Server 2013 服务在邮件信息或约会条目中找到的internet URL.

Office.context.mailbox.item.getEntities().urls；

Office.js版本：

Introduced in v1.0

在如下 Outlook 模式中可用：

读邮件(Read)

最低权限要求：

Restricted

官方文档：

https://msdn.microsoft.com/EN-US/library/office/fp142254.aspx

Office 邮件应用（Mail Add-in) 的权限分级

根据对邮箱内容不同程度的读写，将Office 邮件应用对邮箱的访问权限分为以下几个级别： Restricted, ReadItem, ReadWriteItem, or ReadWriteMailbox。

一般来讲，Add-In涉及的场景将决定我们使用哪些API，相应的会影响到我们应该为自己的 Add-In赋予什么样的权限（通过add-In的manifest来设定，详情参考https://msdn.microsoft.com/zh-cn/library/office/fp161087.aspx）。

参考资料

转载请注明出处：http://www.cnblogs.com/simpeng/p/4733504.html,作者：simpeng。谢谢！

Office Add-in Model 为 Outlook Mail Add-in 提供的 JavaScript API 介绍的更多相关文章

  1. JavaScript API for Office Outlook Add-in - “一页纸文档“

    上一篇文章 Office Add-in Model 为 Outlook Mail Add-in 提供的 JavaScript API 介绍 ,简单地在表格中列出了所有的 Object 定义,但是个人感 ...

  2. AutoMapper：Unmapped members were found. Review the types and members below. Add a custom mapping expression, ignore, add a custom resolver, or modify the source/destination type

    异常处理汇总-后端系列 http://www.cnblogs.com/dunitian/p/4523006.html 应用场景:ViewModel==>Mode映射的时候出错 AutoMappe ...

  3. ef code first transform，add ef power tools add-in，add tangible t4 editor for enhancement.

    use ef power tools, as to .edmx file,right click at view, choose generate database from model, then ...

  4. "git add -A" is equivalent to "git add .; git add -u".

    git add -A stages All git add . stages new and modified, without deleted git add -u stages modified ...

  5. linux 命令route add default dev eth0和route add default gw eth0的区别？

    https://blog.csdn.net/zhaogezhuoyuezhao/article/details/7339220

  6. TensorFlow Lite demo——就是为嵌入式设备而存在的，底层调用NDK神经网络API，注意其使用的tf model需要转换下，同时提供java和C++ API，无法使用tflite的见后

    Introduction to TensorFlow Lite TensorFlow Lite is TensorFlow’s lightweight solution for mobile and ...

  7. [Node.js] Create a model to persist data in a Node.js LoopBack API

    In this lesson you will learn what a LoopBack model is, you will create a Product model using the Lo ...

  8. How to: Supply Initial Data for the Entity Framework Data Model 如何：为EF数据模型提供初始数据

    After you have introduced a data model, you may need to have the application populate the database w ...

  9. 【Mail】Tomcat提供JNDI方式支持JavaMail（三）

    流程介绍 Tomcat提供了JavaMail的支持,是通过JNDI的方式实现的,具体流程是: Tomcat启动的时候,自身产生一个Session对象,放在JNDI容器中给其他项目调用,其他项目只要通过 ...

随机推荐

  1. 【erlang 网络编程学习】 分析cowboy acceptor实现

    http://www.tuicool.com/articles/vuymei 不知道为什么就看了cowboy代码,就继续看了下去了. 分析一下吧,主要写写cowboy 的acceptor pool 的 ...

  2. 【b603】作业调度方案

    Time Limit: 1 second Memory Limit: 50 MB [问题描述] 我们现在要利用m台机器加工n个工件,每个工件都有m道工序,每道工序都在不同的指定的机器上完成.每个工件的 ...

  3. hive 导出数据的几种方式

    1.使用insert导出 这种方式的优点在于既可以导出到hdfs上还可以导出到本地目录 下面以导出emp表中数据为例 insert overwrite local directory "/o ...

  4. FPGA综合优化

    1 速度和面积 在全面优化水平将达到速度和面积RTL要利用逻辑拓扑的优势. 供FPGA由于在后端而言缺乏知识,门级优化.普通情况下更高的速度要求更高的并行性以及更大的面积,可是在某些特殊情况下并非这样 ...

  5. Android应用《撕开美女衣服》的实现过程及源代码

    现在很多Android市场中都能找到关于美女的应用,比如 撕开美女衣服.吹裙子等. 这些应用的下载量挺大的,作为Android的开发人员或者一名技术人员我们不能只局限在欣赏应用的层面,很多时候需要我们 ...

  6. UWP 和 WPF 对比

    原文:UWP 和 WPF 对比 本文告诉大家 UWP 和 WPF 的不同. 如果在遇到技术选择或者想和小伙伴吹的时候可以让他以为自己很厉害,那么请继续看. 如果在看这文章还不知道什么是 UWP 和 W ...

  7. Hamcrest 总结

    Junit JUnit框架用一组assert方法封装了一些常用的断言.这些assert方法可以帮我们简化单元测试的编写.这样的话,Junit就可以根据这些断言是否抛出 AssertionFailedE ...

  8. hbase结合hive和sqoop实现数据指导mysql

    hive综合hbase两个优势表中的:     1.实现数据导入到MYSQL.     2.实现hbase表转换为另外一张hbase表.  三个操作环节:      1.hbase关联hive作为外部 ...

  9. 使用bcc32做在windowXP上qt3.2.1编译环境的配置

    1.安装borland C++编译器,编译器文件所在目录下的文件如下: 其中bcc32.cfg和ilink32.cfg文件是自己加进去的,bcc32.cfg内容是-I"C:\Borland\ ...

  10. 熵、交叉熵、相对熵（KL 散度）意义及其关系

    熵:H(p)=−∑xp(x)logp(x) 交叉熵:H(p,q)=−∑xp(x)logq(x) 相对熵:KL(p∥q)=−∑xp(x)logq(x)p(x) 相对熵(relative entropy) ...