# 变更记录
|产品版本|更新内容|更新日期|
|-|-|-|
|V 6.0.1|新增了WPS的第三方文件服务，支持使用WPS开放平台和文档中台进行附件预览和文件编辑|2023年10月28日|
# 1 V6.0.0及以上版本
## 1.1 简介
### 1.1.1 功能介绍
WPS支持选择使用两款产品：开放平台和文档中台。开放平台支持直接使用WPS服务（无需部署服务器），文档中台支持私有化部署以使用WPS服务（需自行部署服务器）。
开放平台和文档中台都是购买后即可同时使用预览和编辑功能，因此历史购买了开放平台的用户，更新版本后即可使用其编辑功能。**WPS的开放平台和文档中台都需自行前往WPS官网购买**。
### 1.1.2 应用场景
1）当使用默认的预览方式预览如 doc、xlsx 、ppt 等格式的办公文档时，需要经过格式转换，因此容易出现兼容问题，效果往往不能达到预期。例如 pdf 文档缺失电子签章、签名，xlsx 文档合并行展示效果有误等情况。因此新增 WPS在线预览功能，提升文件预览体验。
2）编辑文件时，旧的编辑方式只能使用本地客户端，不支持在线编辑，存在诸多不便和缺陷。为了提升用户体验，苍穹系统集成了WPS在线编辑功能，以达到更好的编辑效果。
### 1.1.3 系统路径
【公共设置】 → 【参数配置】 → 【系统参数】 → 【文件服务参数】
## 1.2 主要操作
### 1.2.1 配置预览方式
**步骤1**：进入如下配置页面
【公共设置】 → 【参数配置】 → 【系统参数】 → 【文件服务参数】 → 【文件预览配置】 → 【WPS】
**步骤2**：填入开放平台或文档中台的配置项。WPS预览支持选择开放平台和文档中台两种解析方式，下面分别介绍两种解析方式所需配置的获取方式（在预览配置中填写WPS配置项，对应的WPS编辑配置会被自动填充）。
#### 1.2.1.1 开放平台
| **配置名称** | **详细解释** |
| ------------ | ------------------------------------------------------------ |
| 应用ID | 在 WPS 开放平台申请成为服务商后获取，申请链接：[https://open.wps.cn/case-detail?id=docs_online_edit](https://vip.kingdee.com/tolink?target=https://open.wps.cn/) |
| 客户端秘钥 | 在 WPS 开放平台申请成为服务商后获取，申请链接：[https://open.wps.cn/case-detail?id=docs_online_edit](https://vip.kingdee.com/tolink?target=https://open.wps.cn/) |
**参数获取方式**：
①【APPID】和【APPKEY】获取。
申请完成应用之后，进入WPS总览界面，点击【配置】按钮。
跳转到应用管理界面，“AppID”和“AppSecret”参数对应配置界面的配置项【APPID】和【APPKEY】。
② 【服务部署地址】获取。
出口IP获取链接：https://solution.wps.cn/docs/callback/ip.html
WPS开放平台提供了出口IP的查询地址，打开链接获取到所有的ip，通过英文逗号（,）拼接所有ip，填入【服务部署地址】配置项。
**回调地址配置**：
在苍穹配置界面完成WPS参数的配置之后，还需要在WPS开放平台配置上苍穹的回调地址，才能正常的预览和编辑。
接上面配置参数时跳转到的应用管理界面，此处选择回调配置页签，配置回调网关，填入的地址为：苍穹服务访问地址+/attachment。
#### 1.2.1.2 文档中台
此处以文档中台V6版本为示例，不同的版本可能会存在一些差异，以实际版本为准。
| **配置名称** | **详细解释** |
| ------------------ | ------------------------------------------------------------ |
| 应用包名 | 部署WPS文档中台服务后，访问WPS的管理后台（ip+端口+/micsweb/sys/login）导入许可之后生成。|
| 应用密钥 | 部署WPS文档中台服务后，访问WPS的管理后台（ip+端口+/micsweb/sys/login）导入许可之后生成。|
| 文件服务器访问地址 | 部署的WPS服务器地址 |
**参数获取方式**：
部署完服务导入证书之后，选择集成应用
点击详情跳转到应用管理平台，在基础信息里的“应用包名”和“应用秘钥”参数对应苍穹配置界面的配置项【应用包名】和【应用秘钥】。
【文件服务器访问地址参数】一般是对应WPS文档中台部署手册里所写的app.conf文件里所配置的scheme:+domain:+port，根据实际情况找部署服务的人员获取。
**回调地址配置**：
在苍穹配置界面完成WPS参数的配置之后，还需要在WPS开放平台配置上苍穹的回调地址，才能正常的预览和编辑。
在文档中台应用管理平台找到对应的应用之后点击【详情】按钮
选择【应用依赖】菜单之后，点击右侧对应功能的配置按钮，如此处点击了【预览编辑配置】，在弹窗里填入【回调域名】，填入的地址为：苍穹服务访问地址+/attachment，接口配置可以忽略，使用的都是默认的。
### 1.2.2 配置编辑方式
**步骤1**：进入如下配置页面
【公共设置】 → 【参数配置】 → 【系统参数】 → 【文件服务参数】 → 【文件编辑配置】 → 【WPS】
**步骤2**：填入开放平台或文档中台的配置项（获取方式与WPS预览配置相同）。
# 2 V6.0.0以下版本
V6.0.0以下版本WPS开放平台配置页面系统路径如下：
【配置工具】 → 【参数配置】 → 【系统参数】 → 【附件配置】 → 【附件预览方式配置】
注：V6.0.0以下版本仅支持旧版WPS开放平台，且不支持文档中台。**旧版WPS开放平台指2023年2月以前购买的版本**。
