一、应用部署先决条件

1、O2OA已经部署完成，并正常运行。（O2OA开发平台部署文档请参考：系统安装-如何安装部署O2OA(翱途)开发平台? ）

2、已经连接O2云或者下载应用安装文件。

3、此应用需要集成ONLYOFFICE服务器，请自行安装ONLYOFFICE产品.

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

二、如何安装应用

ONLYOFFICE集成应用安装大概需要如下几个步骤：

1、应用市场安装应用

2、应用配置（如果不完成配置将无法正常使用）

3、重启服务器（有自定义应用包需要加载）

操作完成后即可使用，请根据下述过程仔细完成安装和配置操作：

1、以管理员（xadmin）身份登录O2OA开发平台，并且打开应用市场，如下图所示：

2、点击“离线安装”按钮安装“ONLYOFFICE集成应用”，如下图所示：

在弹出的文件选择框里，选择获取的应用安装文件。如果服务器已经连接了O2云，则可以直接在应用市场搜索AI助手进行安装。

（应用市场安装过程暂时不做赘述）

3、安装完成后，可以使用以下链接直接访问ONLYOFFICE在线编辑应用。

链接地址：http://localhost/x_desktop/index.html?app=OnlyOffice

（请注意：其中localhost代表您部署的O2OA开发平台IP地址或者域名，请修改为正确的地址。

此链接所示的界面主要用于管理ONLYOFFICE配置以及测试系统是否能正常使用ONLYOFFICE打开文档）

应用打开后，显示的界面如下图所示：

此时应用无法正常使用，需要重新启动O2OA服务器。

服务器重启完成后，再使用上一步提供的ONLYOFFICE应用链接进入应用，完成系统设置后保存，系统即可正常使用。

（一定要保存一次系统设置才可以正常使用）

三、如何配置应用

点击应用左侧的系统设置可以对应用的参数进行配置，如下图所示：

参数说明：

• 最大文件大小：允许上传的文件大小限制，默认为5242880字节
• 超时时间：上传文件超时时间，默认为120000秒
• 查看文件类型：应用允许使用ONLYOFFICE在线查看的文件类型，默认为.pdf|.docx|.xlsx|.csv|.pptx|.txt
• 编辑文件类型：应用允许使用ONLYOFFICE在线编辑的文件类型，默认为.docx|.xlsx|.csv|.pptx|.txt
• 转换文件类型：应用支持转换的文件类型，默认为：.docm|.dotx|.dotm|.dot|.doc|.odt|.fodt|.ott|.xlsm|.xltx|.xltm|.xlt|.xls|.ods|.fods|.ots|.pptm|.ppt|.ppsx|.ppsm|.pps|.potx|.potm|.pot|.odp|.fodp|.otp|.rtf|.mht|.html|.htm|.epub
• 转换地址：系统用于文件转换的服务器地址，默认http://onlyoffice.o2oa.net/ConvertService.ashx，建议更换为自行部署的ONLYOFFICE服务器，效率和安全性更高
• 临时存储路径：系统用于文件临时存储的服务器地址，默认http://onlyoffice.o2oa.net/ResourceService.ashx，建议更换为自行部署的ONLYOFFICE服务器，效率和安全性更高。
• 前端api地址：系统用于集成的前端ONLYOFFICE API地址，默认为http://onlyoffice.o2oa.net/web-apps/apps/api/documents/api.js，建议更换为自己部署的ONLYOFFICE服务器域名。
• 前端刷新地址：系统用于文件前端刷新的API地址，默认为http://onlyoffice.o2oa.net/web-apps/apps/api/documents/cache-scripts.html，建议更换为自己部署的ONLYOFFICE服务器域名。
• 密钥：ONLYOFFICE鉴权密钥可以到ONLYOFFICE服务器安装目录/etc/onlyoffice/documentserver/local.json文件查看。不配置秘钥时，打开文件系统可能提示：文档安全令牌的格式不正确，请与您的文档服务器管理员联系。
• OnlyOffice访问O2地址：ONLYOFFICE服务器回调O2OA服务器的地址，默认为http://xxx.xxx.xxx.xxx/x_onlyofficefile_assemble_control，请修改为自己部署的O2OA服务器地址，此地址一定要ONLYOFFICE服务器可以访问到。
• 文件下载允许ip：允许下载文件的客户端IP，可以有效限制文件的下载权限。

请注意：

       1）填写的服务器地址，请仔细核对通讯协议（HTTP/HTTPS），自动生成的配置内容可能与实际不符。

       2）ONLYOFFICE服务器和O2OA开发平台服务器需互通，为保证传输效率，请使用内网IP地址或者内网域名。

       3）如果ONLYOFFICE地址使用的是onlyoffice.o2oa.net那么请务必将OnlyOffice访问O2地址填写为公网能访问到的域名或者IP地址。

修改好配置之后，保存即可。文档上传后的效果如下图所示：

打开文件即可对文件进行预览：

四、如何卸载应用

1、停止O2OA开发平台：可以运行stop命令或者kill进程

2、删除前端组件及资源文件：

      删除目录：o2server/webroot/x_component_OnlyOffice

      删除目录：o2server/webroot/x_component_OnlyOfficeEditor

      删除目录：o2server/webroot/o2_lib/onlyoffice

3、卸载自定义Java服务

      删除文件：o2server/custom/jars/x_onlyofficefile_core_entity.jar

      删除文件：o2server/custom/x_onlyofficefile_assemble_control.war

4、启动O2OA开发平台。