私有版WPS预览集成

1. 概述

1.1 功能简介

私有版 WPS 预览集成指的是，成员在使用产品过程中，进行 Excel 、Word 预览时，通过调用企业本地部署的私有版 WPS 服务实现预览效果。

1.2 应用场景

适用于集团内需要严格使用本地化服务资源的各类场景中。

2. 准备独享版企业访问地址

管理员登录独享版控制台，点击「基础信息」，在「平台信息」处即可获取独享版企业访问地址。

请复制并保存，下文需要使用。

3. WPS端配置

3.1 登录WPS

独享版用户登录企业自身的私有版 WPS 系统后台。

3.2 创建应用

1）在「WPS 系统后台 > 集成应用」处，点击「创建集成应用」。

2）进入应用管理平台页面，在「应用中心 > 集成管理」处，点击「创建应用」。并在创建应用详情页中，填写好应用的应用图标、应用名称和应用描述。填写完成后，点击「提交」。

3.3 获取应用AK和应用SK

应用创建完成后，在「应用中心 > 集成管理」处，点击已经创建好的应用的应用名称，进入应用详情页中。在「基础信息」处，查看并获取应用 AK 和应用 SK。

3.4 配置预览接口权限

在「应用详情 > 应用授权」处，打开「在线预览」权限右侧开关，并点击「预览编辑配置」。

在「预览编辑回调配置 >> 域名配置」中，填写回调域名。

回调域名配置格式：第2节独享版企业访问地址/_/file/wps_self_hosted

例如：https://example.com:8080/test/_/file/wps

3.5 配置跨域白名单

在「配置管理 > 跨域白名单」处，点击「新增」，添加独享版的访问域名。添加完成后，点击「确定」。

4. 独享版控制台配置

管理员登录独享版控制台，在「系统管理 > 集成配置 > Office 预览配置」中，进行如下所示配置：

全部设置完成后，点击「保存」按钮。

5. 注意事项

1）预览失败时，可检查如下配置是否正确：

2）跨域白名单。若跨域白名单出现配置错误，则接口 /weboffice/office/s/xxxxxxx 将出现如下报错 ：

3）本地化 WPS 服务没有配置可信证书，导致请求被浏览器拦截。

4）本地化 WPS 和独享版协议不一致，会导致请求被浏览器拦截。WPS 需要 https+公网域名访问。

5）WebSocket 连接报错，WPS 预览依赖 WebSocket 通信失败会导致无法正常预览，排查本地化 WPS 服务的网络配置是否正常处理 WebSocket 协议。