Office在线协作（三）- O2OA连接本地部署的OnlyOffice Docs Server服务器 For Windows Server

Office 在线协作是 o2oa 与 onlyoffice 结合实现的在线办公套件，包含文本、电子表格和演示文稿的查看器与编辑器，完全兼容 Office Open XML 格式：.docx、.xlsx、.pptx，并支持实时协作编辑。O2OA 提供了便捷的在线文档预览、编辑与文档在线协作应用，提升了在线办公体验。但默认下载的相关应用使用兰德网络的公用服务器，出于数字资产安全与效率考虑，O2OA 也支持修改配置，让服务器连接本地单独部署的 OnlyOffice 服务器。本文将详述修改配置的两种方式。

    接下来，首先从应用市场安装 office 在线协作控件：

一、从应用市场安装 OnlyOffice 控件

    点击“office在线协作”进行部署，如下图所示：

    安装后，务必编译所有数据表（数据中心平台--office在线协作数据--数据表--document表--编译所有数据表）

二、编译 Office 在线协作涉及的自定义数据表

    1、以管理员身份登录 O2OA，从左上角菜单中打开数据中心

    2、进入 Office 在线协作数据应用，点击“编译所有数据表”完成编译，如下图所示：

    完成“Office在线协作”应用安装部署后，需要重启 O2OA 服务器。

三、修改“Office 在线协作”应用配置

    应用安装后，服务器会生成与 OnlyOffice 服务器相关的配置文件。

    应用部署目录：o2server/servers/applicationServer/work/x_onlyoffice_assemble_control

    修改配置，使 O2OA 集成此前安装的 OnlyOffice 服务器：

    方法一：直接修改 onlyofficeSetting.json 配置文件后重启生效    1、复制 OnlyOffice 配置到 config 文件夹    onlyofficeSetting.json 所在目录：o2server/servers/applicationServer/work/x_onlyoffice_assemble_control/WEB-INF/classes/

    2、复制此文件到 config 文件夹下    目标文件夹：o2server/config（如果没有该文件夹，可自行创建）

3、修改 onlyofficeSetting.json 文件    onlyofficeSettings.json 默认配置参数如下：

    onlyofficeSettings.json 配置参数说明

    1、storageFolder：文档存储路径；如果为空，默认为 o2oa 安装目录下的 local/repository/storage/onlyoffice；

    2、storageFolderTemplate：模板文档存储路径；如果为空，默认为 o2oa 安装目录下的 local/repository/storage/onlyoffice/template；    3、storageFolderIndex：文档存储路径；如果为空，默认为 o2oa 安装目录下的 local/repository/storage/onlyoffice/index；    4、storageFolderMark：文档转 pdf 文件的暂存路径；    5、docbuilderEXEPath：onlyoffice 的 docbuilder 程序安装地址；    6、filesizeMax：最大上传文件大小；    7、timeout：上传超时时间；    8、docserviceViewedDocs：onlyoffice 可查看的文档类型；    9、docserviceEditedDocs：onlyoffice 可编辑的文档类型；    10、docserviceConvertDocs：onlyoffice 支持转换的类型；    11、docserviceConverter：onlyoffice 转换程序地址；    12、docserviceTempstorage：onlyoffice 临时暂存地址；    13、docserviceApi：onlyoffice 前端 api 地址；    14、docservicePreloader：onlyoffice 前端缓存地址；    15、secret：onlyoffice 与应用交互时的参数签名密码；（可在 .../ONLYOFFICE/DocumentServer/config 的 local.json 文件中查看）    16、header：参数加密后字串的前缀；    17、ipWhiteList：应用系统控制文件下载请求的地址；通常配置为 onlyoffice 所在服务器 ip；    18、callbackUrl：应用程序回调接口地址，便于前端应用二次开发；如果为空，默认服务接口名称为“cloudDocumentSrv”；    19、gobackUrl：浏览器打开 onlyoffice 文档报错后的默认打开地址，这里填写自己的 o2oa 服务器地址；

    20、rmi：rmi 是否启用；只有在集群环境下才设置为 true，作用是使全文检索目录保持一致；    21、rmiPort：rmi 端口；    22、searchRangeCount：全文检索内容范围内，找出有权限文档的尝试次数；    23、searchReturnCount：全文检索返回的符合条件文档的最大数量；    备注：上面标粗的为重要参数

    注意：secret 的密码可在 C:/Program Files/ONLYOFFICE/DocumentServer/config 的 local.json 文件中查看

    在C:/Program Files/ONLYOFFICE/DocumentServer/config/local.json文件中查看secret信息

    完成后的系统配置样例（For Linux 操作系统）：

完成后的系统配置样例（For Windows 操作系统）：

    方法二：在线配置 OnlyOffice 相关参数后重启生效（目前新版本不会显示这个界面，请使用方法一）    O2OA 系统在安装 OnlyOffice 相关组件或在线协作之后重启服务器，即可访问一个配置页面，从而避免复杂的配置文件编辑操作。

    配置文件访问地址：http://{youserver}/o2_lib/onlyoffice/config.html
    浏览器打开地址： 把红框中的office.o2oa.net改成实际部署的onlyOffice服务器名字，如下图所示：

    至此，即可在 O2OA 服务器上访问 onlyoffice 实现在线编辑。

    访问地址：http://o2serverhost/x_desktop/document.html?app=CloudDocument

    注意：样例，http://172.26.64.1 是onlyoffice服务器能访问到的o2oaserver服务器域名

    至此，O2OA 与 OnlyOffice 的安装与配置工作完成，Office 在线协作应用可正常使用。

    以下文档可能对您有帮助：

    《Office在线协作（一）- 在本地服务器上安装ONLYOFFICE Docs Community Edition For Windows Server - 超详细安装教程》

    《Office在线协作（二）- 下载并安装O2OA服务器 For Windows Server 2019》

兰德网络O2OA平台软件

开源、自主可控的协同办公底座

研发与运营

纵横翱途（杭州）科技有限公司

企业级协同应用 · 工作流引擎 · AI 智能体

www.o2oa.net ｜ 400-888-0545