私有版WPS预览集成

1. 简介

1.1 功能简介

私有版 WPS 预览集成指的是，在简道云平台进行 Excel 、Word 预览时，通过调用企业本地部署的私有版 WPS 服务实现预览效果。

1.2 应用场景

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

1.3 预期效果

以合同管理为例，进行合同模板打印时调用 WPS 服务预览，效果如下所示：

2. 设置步骤

2.1 登录WPS

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

2.2 创建应用

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

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

2.3 获取应用AK和应用SK

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

2.4 配置预览接口权限

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

2.5 配置IP白名单

在「应用设置 >> IP 白名单设置」处点击「设置」，进入 IP 白名单设置详情页，将独享版文件服务到私有云 WPS 的所有可能的出网 IP 均配置上。配置完成后，点击「确定」。

2.6 配置跨域白名单

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

2.7 独享版控制台配置

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

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

2.8 效果演示

效果参见本文【1.3 预期效果】。

3. 注意事项

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

1）IP 白名单。若 IP 白名单配置错误，则接口 /_/file/preview_office? 将出现如下所示报错，独享版管理员可在「配置中心 >> 自助运维 >> 监控服务 >> 仪表板 >> 简道云服务日志」中查看。

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