WPS预览集成
1. 简介
1.1 功能简介
WPS 预览集成指的是,在简道云平台进行 Excel 、word 预览时,通过调用 WPS 服务实现预览效果。
1.2 应用场景
适用于集团内需要严格使用国产化资源的各类场景中。
1.3 预期效果
以合同管理为例,进行合同模板打印时调用 WPS 服务预览,效果如下所示:
2. 设置步骤
2.1 登录WPS
开发者注册并 登录 WPS 开放平台。
2.2 开发者认证
1)进入开放平台「控制台」中,在「总览 >> 开发者认证」处,点击「去认证」。
2)进入开发者认证页面,填写好开发者名称、邮箱、联系电话等信息后,点击「提交」,完成认证。
2.3 获取AppID和AppSecret
2.3.1 创建测试应用
在「创建测试应用」处,点击「免费创建测试应用」。进入创建应用页面中,设置好应用名称、应用介绍,选择应用类型和应用环境后,点击「创建应用」,完成创建。
2.3.2 查看AppID和AppSecret
应用创建完成后,在「应用管理 >> 应用」处点击「配置」,进入应用信息详情页中,查看并保存应用的AppID 和 AppSecret。
2.4 配置回调信息
2.4.1 配置回调地址
在应用的「回调配置 >> 回调网关」处,配置对应的回调地址。
- 回调地址配置格式为:https://{你的独享版服务域名}<:非标端口></二级路径>/_/file/wps,举例如下:
- 正常情况回调地址为: https://dachengkeji.com/_/file/wps
- 带有非标端口、二级路径回调地址为: https://dachengkeji.com:8000/test/_/file/wps
2.4.2 开启端口
开启如下所示 2 类端口:
- 文档预览:文档预览中的 3 个端口均默认开启;
- 用户信息:用户信息中的 1 个接口需手动开启。
2.5 独享版控制台配置
管理员登录简道云独享版配置中心,在「系统管理 >> 集成配置 >> Office 预览配置」中,进行如下所示配置:
- 预览方案:选择「WPS」;
- app_id:将【2.3.2 查看 AppID 和 AppSecret】中获取到的 APPID 配置进去;
- app_key:将【2.3.2 查看 AppID 和 AppSecret】中获取到的 APPSecret 配置进去。
全部设置完成后,点击「保存」按钮。
2.6 效果演示
效果参见本文【1.3 预期效果】。
3. 注意事项
3.1 IP白名单配置
内网用户需开启 IP 白名单,可选用回调 IP 地址:120.92.55.139。若回调地址失败,可参考 回调服务出口 IP 并根据企业需求自行选取。
3.2 预览失败问题
若集成预览失败,可检查以下配置是否正确,并重新尝试预览:
- WPS 回调地址配置是否正确
- IP 白名单地址是否开启
3.3 创建正式应用
根据【2. 设置步骤】完成 WPS 预览集成测试工作后,需在「WPS 开放平台 >> 总览」处,根据企业需求创建正式应用并进行集成。