业务系统里的Office文档如何在线编辑
在数字化转型的背景下，现代企业的诸多业务系统（合同管理系统，OA,邮件，客户管理系统等）已经可以用浏览器直接使用，但是word,excel,ppt等Office文档在业务系统中还经常以*.docx,*.xlsx,*.pptx的附件的形式存在，用户依然需要先下载到本地，然后用Office打开编辑，完成后再上传回去。那么如何实现对业务系统中Office文档的多人在线编辑，实现业务系统的体验闭环和应用创新？答案是和zOffice在线文档系统集成。
zOffice简介
zOffice提供云端Office能力，包括word、excel、ppt三类办公文档的在线协同编辑，通过专业级的文档能力，高效的协作体验，内容级的安全管控，丰富的集成开发接口，来赋能企业的业务系统，帮助业务系统实现文档在线预览和编辑，文档操作过程全部线上进行，完成在线办公的场景闭环。
zOffice链接：https://www.filez.com/zoffice
集成介绍文档： https://lenovocloud.zbox.filez.com/l/a0OsO0
多人在线编辑的三要素：
zOffice最大化简化集成复杂度，把多人在线编辑的需求抽象成“人”、“物”、“权”三要素：
- 人：zOffice系统需要知道当前是哪个用户正在打开编辑；
- 物：即当前编辑的是哪个文档，zOffice系统需要能在打开的时候获取该文档的文件流,保存的时候把经过修改的文件流回传给业务系统；
- 权：即“人”对“物”的访问权限，zOffice系统在某“人”要打开编辑某“物”的时候，需要验证该人对文档是否有读取/写回等访问权限。
以上三要素的管理和提供方都是业务系统，zOffice系统和业务系统通过约定好的前后端接口来获取三要素的信息。
根据三要素信息传递方式的不同，有两种集成方式：
方式一：“后端集成”。
zOffice和业务系统通过约定好的服务端对服务端接口获取三要素信息。适用于业务系统服务端代码可以修改，前端代码不需要改动太多的场景。
- 人：业务系统服务端实现 /{context}/profiles GET接口用于根据cookie返回当前用户的信息，zOffice服务端调用该接口获取用户信息，返回值示例如下：
Get http://172.16.52.223/v2/context/profiles （其中172.16.52.223假定为业务系统的服务端地址）返回
{
"id": "301",
"display_name": "docstest02",
"email": "[email protected]",
"photo_url": "/testOrg/people/301.png",
"name": "docstest02",
"job_title": ""
"org_name": "",
"org_id": "",
}
- 物：业务系统服务端实现 /{context}/{docId}/content GET/POST接口，供zOffice获取和回传文件内容流。
- 权：业务系统服务端实现 /{context}/{docId}/meta GET接口，供zOffice获取当前用户对当前文档的权限信息，例如针对docId为123的文档调用GET meta接口返回值示例如下：
Get http://172.16.52.223/v2/context/123/meta 返回
{
"id": "123" //必须有,
"name": "/study/Nodejs/Demo/mytest.xlsx", //必须包含文件的扩展名
"modified_at": "2020-03-25T02:57:38.000Z"，//必须有
"created_by": { //必须有
"id": "301", //必须有
"email": "[email protected]", // 可选
"name": "docstest02" // 可选
},
"permissions": { //必须有
"write": "true", //必须有，控制文档是否可以被编辑
"read": "true", //必须有
“download”: false, //可选。
“print”: true //可选。
},
"size": 9897, //必须有
}
业务系统服务端实现上述3个rest接口并且和zOffice服务端配置连通后，用户在浏览器里点击 https://oa.demo.com/docs/app/thirdparty-rest/123/edit/content 即打开zOffice在线编辑id为“123”的文档。
方式二：“前端集成”。
zOffice系统需要的“人”“物”“权”的相关信息都从业务系统前端用url参数的形式传递给zOffice服务器。适用于业务系统的服务端代码不方便修改，前端js代码可以修改，并且业务系统已经具备了从前端上传下载文档，获取用户信息，获取权限信息等功能。
例如，用户在浏览器点击文档123时，业务系统的前端js直接构造如下的地址并用window.open或iframe src的形式打开zOffice在线编辑：
https://oa.demo.com/docs/app/driver-callback? action=edit&repoId=thirdparty&docId=123 &userinfo=xxxxxx&meta=yyyyyy&downloadUrl=zzzzzz&uploadUrl=zzzzzz
- 人：即userinfo=xxxxxx部分，业务系统前端js代码按照上述profiles返回值格式构造好传入；
- 物：即downloadUrl=zzzzzz 用于指定下载文件流的url；uploadUrl=zzzzzz 用于指定回传文件流的url；
- 权：即meta=yyyyyy部分，业务系统前端js代码按照上述meta返回值格式构造好传入。
总结
综上，业务系统的开发者可以根据情况选择“后端集成”或“前端集成”的方式集成zOffice，简单快捷的实现多人在线编辑功能。