使用zdppy_api+onlyoffice word文档在线共同编辑,附完整的vue3前端代码和python后端代码
Python私教 2024-08-15 14:33:05 阅读 51
参考文档:
https://api.onlyoffice.com/zh/editors/basic
https://api.onlyoffice.com/zh/editors/coedit
基本的架构思考:
文档表:记录的是文档信息
key:这个key可以标识唯一的一个文档,可以是文档的hash值fileType:文档的类型,docx,txt,pdf,其他title:文档的标题,也就是文档的实际的名称,比如 test.docxurl:这个非常关键,应该是一个文档存储服务提供的地址,通过这个地址能够下载文档 用户表:
idname:用户名
我们在共同编辑的时候,每个用户可以打开不同的文档,也可以打开同一个文档。我们在调用打开文档的方法的时候,一定记得配置用户信息,比如:
如果要实现协同编辑(编辑实时生效),应该做如下配置:
简单的实现思路:
1、打开两个tab标签,每个标签都输入前端地址,相当于访问同一个界面2、第一个tab标签打开加载文档,用户的参数填张三3、第二个tab标签打开加载文档,用户的参数填李四4、开启文档的协同编辑模式5、分别在两个tab页面对同一个文档进行编辑,观察效果
另外一个问题:如何使得加载同一个文档,但是用户不一样?
生成随机的ID生成随机的用户名
实现协同编辑的vue3完整代码如下:
<code><script setup>
import { message} from "ant-design-vue";
const onLoadDocumentClick = () => {
message.success("load document")
// isDocument.value = true
new DocsAPI.DocEditor("doc", {
"document": {
"fileType": "docx",
"key": `Khirz6zTPdfd7`,
"title": "Example Document Title.docx",
"url": "http://127.0.0.1:18889/dist/test.docx"
},
"editorConfig": {
"callbackUrl": "http://127.0.0.1:18889/callback",
"lang": "zh-CN",
"user": {
"id": `001-${ Math.random()}`,
"name": `zdp-${ Math.random()}`
},
"customization": {
"forcesave": true,
},
"coEditing": {
"mode": "fast",
"change": true
},
},
"documentType": "word",
height: '500px',
width: '100%'
});
}
</script>
<template>
<div class="bg-indigo-50 p-8 min-h-screen">code>
<div class="bg-amber-200 p-8">code>
<a-button type="primary" @click="onLoadDocumentClick">Load Document</a-button>code>
</div>
<div class="bg-amber-400 p-8 min-h-96">code>
<div id="doc">doc</div>code>
</div>
</div>
</template>
在文档编辑界面中,我们也确实可以看到,有两个用户同时在对同一个文档做编辑:
经过实际的测试,A用户编辑文件的时候,B用户能够实时的看到文档的编辑结果,并且能够查看到是哪个用户在对文档做编辑。
A用户输入ctrl+s保存的时候,文档会被实时保存。当A用户和B用户先后重新加载文档的时候,看到的都是实时保存之后的文档。
配套的后端代码如下:
<code>import json
import req
import api
from api import middleware
from api.zjson.response import JSONResponse
async def doc_callback(request):
data = await api.req.get_json(request)
print("callback === ", data)
# status == 2 文档准备好被保存
if data.get("status") == 2:
req.download(data.get("url"), "data/test.docx")
if data.get("status") == 6:
req.download(data.get("url"), "data/test.docx")
# status == 6 文档编辑会话关闭
return JSONResponse("{\"error\":0}")
app = api.Api(
routes=[
api.resp.dir_route("/dist", "data"),
api.resp.post("/callback", doc_callback),
],
middleware=[middleware.cors()],
)
if __name__ == "__main__":
app.run(port=18889)
声明
本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。