如何整合Office Web Apps至自己开发的系统(一)
来源:互联网 发布:windows 10 修复bcd 编辑:程序博客网 时间:2024/06/05 04:26
在前面我的一篇博客中 Office Web Apps安装部署(一),有一张介绍Office Web Apps与其他系统的关系图,
从上述图中,可知实际上Office Web Apps也是可以接入自己开发的系统的。下面介绍一下整合Office Web Apps的一些理论知识。
要想让自己的系统与Office Web Apps整合就一定要清楚一些概念,首先要理解什么是”WOPI”。
WOPI的英文全称是“Web Application Open Platform Interface”,中文名为“Web应用程序开放平台接口协议”。
WOPI协议提供一系列基于web方式的,使文档能在Office Web Apps中查看与编辑的接口服务(Web Service)。
只要web application按照标准,实现了WOPI的接口,那么就可以调用Office Web Apps。例子很多,比如SharePoint,Exchange,SkyDriver,Dropbox集成Office Web Apps。
如果自己做的web应用也实现了相应接口,也是可以调用Office Web Apps的。实现文档的在线编辑查看。
这样比市面上的一些基于ActiveX的在线Office产品有很大的优势。
首先Office Web Apps是基于网页技术,所以是跨平台的,可以在iOS,安卓,WP及PC使用,实现多屏一体。
其次Office Web Apps实现了桌面Office的大部分功能,能在客户机没有安装Office的情况下,实现云端上的文档编辑查看。
下面介绍的内容都是基于http协议下的,https也是类似的。
在WOPI结构中,
我们把存放Office文档的web应用叫WOPI Host或者WOPI Server。
把查看编辑操作Office文档的web应用叫WOPI Client或者叫WOPI applications。
所以,Office Web Apps充当的就是WOPI Client的角色。
SharePoint,Exchange,自己开发的文档管理系统充当的就是WOPI Host的角色。
下图为浏览器,server,client三者的请求顺序及关系:
从上图可知,WOPI Client 向WOPI Server发送了两次请求
1. Tell me about the file
2. Give me the file
所以WOPI client至少要提供两个Web服务。
1. 一个是CheckFileInfo服务
此服务返回的是请求文件的基本信息,WOPI Host以json方式返回给WOPI Client.
服务URI格式一般为
HTTP://server/<...>/wopi*/files/<id>?access_token=<token>
此服务返回的json格式类似为:
{"BaseFileName": "Sample Document.docx", "OwnerId": "tylerbutler", "Size": 300519,"SHA256": "+17lwXXN0TMwtVJVs4Ll+gDHEIO06l+hXK6zWTUiYms=", "Version": "GIYDCMRNGEYC2MJREAZDCORQGA5DKNZOGIZTQMBQGAVTAMB2GAYA===="}
Json中至少要包括五个属性:BaseFileName, OwnerId, Size, SHA256, 和 Version
BaseFileName: 文件名。
OwnerId: 文件所有者的唯一编号。
Size: 文件大小,以bytes为单位。
SHA256: 文件的256位bit的SHA-2编码散列内容。
Version: 文件版本号,文件如果被编辑,版本号也要跟着改变。
更多参数介绍请参考:http://msdn.microsoft.com/en-us/library/hh622920(v=office.12).aspx
2. 一个是GetFile服务
此服务返回的是请求文件的内容,WOPI host以数据流的方式返回给WOPI Client.
服务URI格式一般为
HTTP://server/<...>/wopi*/files/<id>/contents?access_token=<token>
注意:CheckFileInfo与GetFile服务的URI格式只差了一个/contents,其他地方的格式是没有不同的。这么做是为了让WOPI client可以通过CheckFileInfo服务URI推导出GetFile服务的URI,千万不要别出心裁,写出的服务URI格式破坏了这层关系。
在上述URI格式中,都有一个access_taken身份验证令牌。这个身份验证令牌是必须要有的,WOPI client会把此令牌回发给WOPI Host,由WOPI Host验证当前用户对当前文件的权限。所以实际上Office Web Apps根本不涉及文档的权限管理。
我们在WOPI client上打开一个Office文档的url地址类似如下:
http://wopi-app-server.contoso.com/wv/wordviewerframe.aspx?WOPISrc=http%3A%2F%2Fmy-wopi-host%2Flocal%2Fwopi%2Ffiles%2F1-Sample%2520Document.docx&access_token=dc172034-c6f9-4a43-bc3f-d80dd93c1de1
这个里面有两个传递参数:WOPISrc和access_token
WOPISrc参数的内容为:http://my-wopi-host/local/wopi/files/1-Sample%20Document.docx
实际上这个是WOPI Host上的CheckFileInfo服务地址。
WOPI client会通过这个地址加上access_token从WOPI host上获取到1-Sample%20Document.docx文件的信息;
并且通过这个地址推导出WOPI Host上的GetFile服务地址,通过GetFile服务获取到1-Sample%20Document.docx文件的内容。
WOPI host上判断什么类型的文件应该怎么用WOPI client打开,WOPI client会提供一个xml文件给WOPI host,这份xml文件叫WOPI Discovery。格式类似如下:
<?xml version="1.0" encoding="utf-8"?><wopi-discovery><net-zone name="external-https"><app name="Word" favIconUrl="https://wopi-app-server.contoso.com/wv/resources/1033/FavIcon_Word.ico"checkLicense="true"><action name="view" ext="doc" default="true"urlsrc="https://wopi-app-server.contoso.com/wv/wordviewerframe.aspx?<ui=UI_LLCC&><rs=DC_LLCC&><showpagestats=PERFSTATS&>"/><action name="view" ext="docm" default="true"urlsrc="https://wopi-app-server.contoso.com/wv/wordviewerframe.aspx?<ui=UI_LLCC&><rs=DC_LLCC&><showpagestats=PERFSTATS&>"/>……</app>……</net-zone></wopi-discovery>
如上所述,打开doc文件,应该使用https://wopi-app-server.contoso.com/ wv/wordviewerframe.aspx的url打开。
WOPI host应该获取这份文件一次,以后打开什么类型的文件,调用什么url自己判断。
- 如何整合Office Web Apps至自己开发的系统(一)
- 如何整合Office Web Apps至自己开发的系统(二)
- 自定义开发的系统整合 office Web apps
- Asp.net与office web apps的整合
- 将Office Web App整合到自己的项目中(WOPI Host 开发)
- Exchange 2013与 Office Web Apps 整合
- Office Web Apps Server 2013与PDF(一)
- Office Web Apps安装部署(一)
- Office web apps 预览服务器的配置
- Office Web Apps
- Office Web Apps 实践
- Windows Store apps开发[35]如何创建自己的Windows Store账号来提交Apps
- Office Web Apps Server 打造手机移动办公系统
- Microsoft Office 2010 Web Apps
- Office Web Apps安装部署
- 部署 Office Web Apps(2)
- DzzOffice结合office web Apps私有部署的实例
- 如何实现由Google Apps向Office 365的过渡?
- C++ - 默认生成的成员函数
- 2014-项目一--用友元函数实在复数的运算符重载
- 第八周 项目1.2 用友元函数实现复数类中的运算符重载
- java 利用String.trim()函数实现右侧去除空格
- Java第7周实验
- 如何整合Office Web Apps至自己开发的系统(一)
- 正则表达式-零宽度断言详解
- 小波分析 C++库
- PHP依赖注入简单理解
- hiberanate学习笔记(四)flush缓存和hibernate的主键生成策略
- android:layout_weight的一些疑惑的地方
- ueditor 编辑器的配置 实现了上传图片与文件功能---附效果图
- 斯坦福机器学习_神经网络
- WPF第三方控件DXperience的dxn:NavBarControl添加样式