onlyoffice在线编辑

Posted 2020-12-05 cat520

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了onlyoffice在线编辑相关的知识，希望对你有一定的参考价值。

ONLYOFFICE Document Server提供文档协作的服务功能，支持Word，Excel和PowerPoint的协作。但是这里，需要进行文档管理和存储的二次开发。

一、安装ONLYOFFICE Document Server

平台集成onlyoffice,调用onlyoffice的api，需要现在本地的一台服务器上安装onlyoffice的文档服务器，安装文档服务器的方式有很多种，Windows和Linux上都可以安装，但是因为文档服务器的正常使用需要其他插件的配合，所以正常按照官网上来一步步安装，还需要安装redis,rabbitMQ,mysql、Erlang、PostgreSQL等等一系列的插件，十分麻烦，而且如果你是使用windows版本安装的话，因为onlyoffice不支持中文，所以有关于中文的文档基本都是乱码，需要你另行安装字体文件，但是onlyoffice内部对于字体的添加，我查阅网上的一些资料，好像是扫描windows系统中的字体，来进行转换的，系统字体很难去删除添加，所以这种方式我不建议使用，我推荐的是在windows上使用虚拟服务器来安装docker，导入一个整体的镜像文件，（包含了中文字体）来运行onlyoffice,这里需要说明一下，至少需要2G的内存空间来让他正常运行，其流程如下：

第一步：确定电脑打开了cpu虚拟打开。https://jingyan.baidu.com/article/22fe7ced3b4c003002617f17.html

第二步：下载和安装docker，默认安装即可。windows安装docker toolbox，下载地址 http://get.daocloud.io/，下载支持旧版windows的docker toolbox，win10就直接下载docker了;linux安装docker 安装，安装步骤可参考使用docker进行项目一键部署。

第三步：启动docker后在里面拉取Onlyoffice Document Server 的Docker镜像

拉取镜像：启动docker，在里面输入命令

第四步：启动镜像文件：docker run -i -t -d -p 9000:80 onlyoffice/documentserver

如果是导入的镜像，上面的命令中onlyoffice/documentserver用镜像id代替, 查阅镜像用docker images命令。

镜像文件拉取：\192.168.0.6java组共享onlyofficeonlyoffice5.1.4.tar

二、集成onlyoffice的二次开发

文档的管理和引用：

创建一个空的html文件。

使用将用于您的网站的javascript API指定您的ONLYOFFICE文件服务器链接。

< script  type = “text / javascript” src = “https：//documentserver/web-apps/apps/api/documents/api.js” ></ script >

凡documentserver是一台安装ONLYOFFICE文件服务器的服务器的名称。

添加脚本初始化文件编辑器的DIV与您要打开的文档的配置元素。

new DocsAPI.DocEditor("placeholder", {

    "document": {

        "fileType": "docx",

        "key": "Khirz6zTPdfd7",

        "title": "Example Document Title.docx",

        "url": "https://example.com/url-to-example-document.docx"

    },

    "documentType": "text"

});

以上配置即可以打开文档服务器，但是编辑完完页面虽然显示自动保存，但是它是保存在它自己配置的一个缓存数据库中，你下次打开它会从此数据库中获取，但是下载出来的仍然是编辑之前的。

  “documentType”：“text”，

     “editorConfig”：{

         “callbackUrl”：“https://example.com/url-to-callback.ashx”

    }

这里可以设置保存路径，callbackurl即为回调处理，把编辑后文件保存在本地的指定路径上

平台系统中可以参照view_files.jsp这个页面：

<body style="height:100%; margin:0;">

<div  id = "placeholder"> </div >

<script type="text/javascript" >

window.docEditor = new DocsAPI.DocEditor("placeholder",

{

    "document": {

         "fileType": "${FileType}",

         "key": "${key}",//Khirz6zTPdfd9

         "title": "测试查看文档",

         "url": "${fileUrl}"

         

    },

    "documentType": "${documentType}",

    "editorConfig":{

     "autosave": false,

     "mode": "edit",

     "lang":"zh-cmn-Hans",

  "callbackUrl":"${Path}admin/fileView/callBack.do?FileId=${FileId}&FileName=${FileName}",

  

     "高度": "100%",

     "宽度": "100%"

    }

});

</script>

</body>

Document是打开文档编辑的必要组件，filetype是文件类型，平台上目前只支持word、excel、ppt三种文件格式；

key是唯一标识符,文档编辑完成以后路径会保存在Postgresql数据库中，以键值对的形式存在，key值即是取出保存路径的唯一标识符；

documentType是文档类型，这一点不要与文件类型搞混；

editorConfig内是拓展组件，autosave是自动保存，默认值为true,这里设置为false改为手动保存。

三、故障排除：

下载失败

“下载失败”消息显示在编辑器加载过程中。

该文档编辑服务不能上传文件进行编辑。

检查指向document.url中指定文件的链接是否正确。链接必须可以从文档编辑服务访问。

没有变化

在编辑后关闭编辑器时，文件管理器中的文件保持不变。

该文档编辑服务无法将数据发送到文档存储服务。

检查editorConfig.callbackUrl链接是否正确。文档管理器中的保存必须通过回调处理程序来实现

无法保存

编辑器加载了“文档无法保存”消息。

该文档编辑服务无法连接到文件存储服务在editorConfig.callbackUrl地址。

检查回调处理程序是否正常工作。作为回应，文档存储服务必须返回{“error”：0}。

文件版本已更改

编辑器加载了“文件版本已更改，页面将重新加载”消息。

该文档编辑服务无法打开以前编辑和保存的文件进行编辑。

不要忘记，每次文档被编辑和保存时，必须重新生成document.key。

这路的key需要强调一下，key必须是唯一值，因为她是作为唯一标识来从数据库中获取编辑过的文件

四、缺陷

chrome和opera浏览器中输入中文，键入符号的时候，前面的中文会重复输入进去。

浏览器访问不能以localhost，127.0.0.1来直接访问，需要输入你完整的地址（例如：192.168.0.xx：8090/.....）,不然无法打开在线编辑功能

目前只有最新版本的Chrome，Firefox，Safari或Internet Explorer网络浏览器支持文档编辑器（IE9以前的都不支持onlyoffice的文档编辑器）

历史版本功能目前是只支持word的历史版本，PowerPoint和Excel不支持历史版本，并且历史版本只能看，不能再次编辑

五、总结

Onlyoffice的功能十分强大，我们只是使用它的文档服务器，而且文档服务器中还有很多其他的功能，例如多人同时在线编辑，互聊等等，因为平台暂时没有用到，所以暂时没有做很深入的研究。想了解具体详细的资料可以通过链接：

https://api.onlyoffice.com/

https://blog.csdn.net/hotqin888/article/details/79337881