金山文档在线预览

说明

与 LibreOffice 有所区别，如果启用 WPS WebOffice 预览服务，则所有 Office 文档的预览均基于 WPS WebOffice。

本文分别提供金山文档云版本和金山文档私有部署版的配置步骤，请根据实际使用的版本选择。金山文档私有部署版除 AppID 和 AppSecret 外，还需配置 ENV_WPS_HOST 和 ENV_WPS_ISPRIVATE。

网络要求：请确保 HAP 微服务所在服务器与金山文档服务访问地址之间网络连通正常，并确保金山文档平台能够访问 HAP 平台访问地址，以保障文档服务调用及回调正常完成。

金山文档云版本

1. 访问金山文档平台（如果没有账号，请先注册）。

2. 参考接入流程文档，确认是否已完成相关准备工作。

   测试应用与正式应用的类型均选择 在线编辑预览。

3. 配置正式应用的回调网关，格式为 HAP 系统访问地址/wps，如：

   

4. 获取正式应用的 AppID 和 AppSecret

   

5. 在微服务应用对应的 yaml 配置文件中设置环境变量：

   ENV_WPS_PREVIEW_APPID: 'AppID值'
   ENV_WPS_PREVIEW_APPSECRET: 'AppSecret值'

6. 重启服务

金山文档私有部署版

1. 完成金山文档私有部署版的部署和应用配置，获取私有 WPS 预览服务地址、AppID 和 AppSecret

2. 按照金山文档私有部署版的要求配置回调网关，格式为 HAP 系统访问地址/wps

3. 在微服务应用对应的 yaml 配置文件中设置环境变量：

   ENV_WPS_PREVIEW_APPID: 'AppID值'
   ENV_WPS_PREVIEW_APPSECRET: 'AppSecret值'
   ENV_WPS_HOST: 'http://wps.example.com'
   ENV_WPS_ISPRIVATE: 'true'

   其中，ENV_WPS_HOST 为私有 WPS 预览服务地址，ENV_WPS_ISPRIVATE 的值固定为 true。

4. 重启服务