如何整合Office Web Apps至自己开发的系统

Posted 2023-05-17

实际上Office Web Apps也是可以接入自己开发的系统的。下面介绍一下整合OfficeWeb Apps的一些理论知识。

要想让自己的系统与Office Web Apps整合就一定要清楚一些概念，首先要理解什么是”WOPI”。
WOPI的英文全称是“Web Application Open Platform Interface”，中文名为“Web应用程序开放平台接口协议”。

WOPI协议提供一系列基于web方式的，使文档能在Office Web Apps中查看与编辑的接口服务（WebService）。
只要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 WebApps根本不涉及文档的权限管理。

我们在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自己判断。 参考技术A 实际上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的。实现文档的在线编辑查看。本回答被提问者采纳 参考技术B WOPI项目的创建
首先用vs2012创建一个mvc4的程序。如图：

从上一篇我们可以知道，WOPI通讯主要通过两个服务：
一个是CheckFileInfo服务，
一个是GetFile服务。
所以下面我们主要介绍这两个服务的创建。

1. 首先创建CheckFileInfo服务:
我们先确定这个服务的路由地址
设置为：http://<ServerName>/files/<filename>?access_token=<token>

修改App_Start文件夹下面的WebApiConfig.cs文件。
插入下列代码：
config.Routes.MapHttpRoute(
name: "FileInfo",
routeTemplate: "wopi/files/name",
defaults: new controller = "files", action = "GetFileInfo"
);
如图所示

创建一个名称为files的Controller，

设置为空API控制器：

之所以我们不用平常的MVC控制器，而选API控制器，是因为我们做的是服务，来返回信息，所以要换成ApiController。

这个服务要返回的是json，属性包括为
BaseFileName
OwerId
Size
SHA256
Version
所以我们要创建一个model，包含上述属性
如下图：

在上述的路由器规则中，action用的是GetFileInfo方法，所以要在FileController规则中写一个GetFileInfo方法，这个方法返回CheckFileInfo类型。

public CheckFileInfo GetFileInfo(string name, string access_token)



string _access_token = access_token;

var file = HostingEnvironment.MapPath("~/App_Data/" + name);//从硬盘中获取name文件

FileInfo info = new FileInfo(file);

var json = new CheckFileInfo



BaseFileName = info.Name ,//"test.docx",

OwnerId = "admin",

Size = info.Length,

SHA256 = "+17lwXXN0TMwtVJVs4Ll+gDHEIO06l+hXK6zWTUiYms=",

Version = "GIYDCMRNGEYC2MJREAZDCORQGA5DKNZOGIZTQMBQGAVTAMB2GAYA===="

;

return json;

BEGINNING SHAREPOINT&#174; 2013 DEVELOPMENT 第11章节--为Office和SP解决方式开发集成Apps Office的JavaScript对象模型

BEGINNING SHAREPOINT? 2013 DEVELOPMENT 第11章节--为Office和SP解决方式开发集成Apps  Office的JavaScript对象模型

        Office JavaScript对象模型提供给你的Web应用程序和Office host应用程序交流的能力，