# 金山weboffice&OA配置详解（V9.0之前）
# 适用版本
适用于V9.0及更早版本。
V9.0SP1配置地址有变化，此版本参考离线手册或《金山中台V7安装维护手册（致远V9.0SP1）》在线文档配置即可。
# 背景：
区域同事经常在OA配置好金山weboffcie的相关配置后，遇到预览/编辑功能无法正常使用、页面报错等问题，大部分原因还是配置不正确或者网络不通导致。故在此详细介绍一下相关配置，和常见的配置使用场景。
# V5中台相关配置
中台部署完，在管理中心-创建应用后需要修改的配置，不需要考虑OA使用场景：
- ip白名单和跨域白名单必须配置
将OA的访问ip或域名填写到对应位置。建议将OA和金山的访问ip和域名都加上。注意：若有微协同、致信也需要将域名地址添加；宁可多配，也不能漏配
跨域白名单不要带http/https和端口，只需要填ip或者域名，如图：
- 编辑回调
点击编辑回调，填写回调域名为：OA内网地址(OA为集群请填写负载均衡地址)/ webOffice 如：http://10.3.4.85:8080/seeyon/webOffice (opens new window)
其他项按默认填写，无需更改，点击保存。
这里回调地址配OA的：内网地址 内网地址 内网地址 重要的事情说三遍。
- 预览回调
点击预览回调，填写回调域名为：OA内网地址(OA为集群请填写负载均衡地址)/ webOffice/previewCallBack
如：http://10.3.4.85:8080/seeyon/webOffice/previewCallBack (opens new window)
其他项按默认填写，无需更改，点击保存。
这里回调地址配OA的：内网地址 内网地址 内网地址 重要的事情说三遍。
# 必须注意点：确认中台服务器上能够访问上面配置的OA回调地址
# V5版本对接OA相关配置
特别说明：建议一定使用可视化图形界面配置，若无图形化系统，建议找有图形化的环境，将配置配好之后，在将配置文件拷贝过来，尽量避免手动修改配置导致 参数字母缺少/大小写错误/有空格 等一系列问题。
在线预览配置：
配置文件为.../base/conf/systemCtp.properties
officeTrans.type=wps
officeTrans.wps.appId=AK20210611GISDDJ （金山应用APPID，根据实际情况修改）
officeTrans.wps.appKey=0b22738e5c07fd2e2d1b829c12e536e7 （金山应用APPKEY，根据实际情况修改）
officeTrans.wps.openServiceUrl=https://kdocs.seeyoncloud.com/open
（金山预览服务地址，注意以地址open结尾，参考下述常见3种场景配置）
officeTrans.wps.callBackUrl=http://10.4.7.21/seeyon/webOffice/previewCallBack
（OA为集群请填写负载均衡地址，配置内网地址 内网地址 内网地址 重要说三遍)
seeyonconfig可视化配置位置：
在线编辑配置：
配置文件为.../base/conf/plugin.properties
weboffice.enable=true
weboffice.networkType=PRI （weboffice网络类型，PUB-公网；PRI-内网）
weboffice.url=https://kdocs.seeyoncloud.com/open
（金山预览服务地址，注意以地址open结尾，参考下述常见3种场景配置）
weboffice.appId=AK20210611GISDDJ
（金山应用APPID，根据实际情况修改）
weboffice.appKey=0b22738e5c07fd2e2d1b829c12e536e7
（金山应用APPKEY，根据实际情况修改）
weboffice.callBackUrl=http://10.6.3.63/seeyon/webOffice
(OA为集群请填写负载均衡地址，配置内网地址 内网地址 内网地址 重要说三遍)
可视化配置位置：
# V6&V7中台相关配置
中台部署完，首先登录金山中台管理界面，入口为http://ip:port/micsweb/sys/login (opens new window)
点击 "预览编辑回调配置" 填写回调域名为：OA内网地址(OA为集群请填写负载均衡地址)/ webOffice 如：http://10.3.4.85:8080/seeyon/webOffice/v6
其他项按默认填写，无需更改，点击保存。
这里回调地址配OA的：内网地址 内网地址 内网地址 重要的事情说三遍。
# V6&V7版本对接OA相关配置
特别说明：建议一定使用可视化图形界面配置，若无图形化系统，建议找有图形化的环境，将配置配好之后，在将配置文件拷贝过来，尽量避免手动修改配置导致 参数字母缺少/大小写错误/有空格 等一系列问题。
在线预览配置：
配置文件为.../base/conf/systemCtp.properties
officeTrans.type=wps
officeTrans.wps.appId=AK20210611GISDDJ （金山应用APPID，根据实际情况修改）
officeTrans.wps.appKey=0b22738e5c07fd2e2d1b829c12e536e7 （金山应用APPKEY，根据实际情况修改）
officeTrans.wps.openServiceUrl=https://kdocs.seeyoncloud.com/open
（金山预览服务地址，注意以地址open结尾，参考下述常见3种场景配置）
officeTrans.wps.callBackUrl=http://10.4.7.21/seeyon/webOffice/v6
（OA为集群请填写负载均衡地址，配置内网地址 内网地址 内网地址 重要说三遍)
seeyonconfig可视化配置位置：
在线编辑配置：
配置文件为.../base/conf/plugin.properties
weboffice.enable=true
weboffice.networkType=PRI （weboffice网络类型，PUB-公网；PRI-内网）
weboffice.url=https://kdocs.seeyoncloud.com/open
（金山预览服务地址，注意以地址open结尾，参考下述常见3种场景配置）
weboffice.appId=AK20210611GISDDJ
（金山应用APPID，根据实际情况修改）
weboffice.appKey=0b22738e5c07fd2e2d1b829c12e536e7
（金山应用APPKEY，根据实际情况修改）
weboffice.callBackUrl=http://10.6.3.63/seeyon/webOffice/v6
(OA为集群请填写负载均衡地址，配置内网地址 内网地址 内网地址 重要说三遍)
可视化配置位置：
在线编辑/在线预览的配置，最需要注意的是：
OA在不同的客户端访问场景下，配置唯一的区别就是officeTrans.wps.openServiceUrl和weboffice.url 这2个weboffice服务地址的配置。
必须根据OA的部署和客户端（PC、M3、微协同等）访问场景（内网/外网，http/https），进行配置。
Weboffice服务和OA需在使用https和http保持一致，换言之，OA使用https访问，则weboffice服务也需配置成https访问，若OA使用http访问方式，则weboffice服务也配置成http。
# 注意点：OA服务器上必须要能访问通上面配置的中台地址
# 场景1：客户访问OA只通过内网IP访问（http）
officeTrans.wps.openServiceUrl和weboffice.url 这2个配置weboffice的内网地址
# 场景2：客户访问OA通过外网IP/域名访问(http)
officeTrans.wps.openServiceUrl和weboffice.url 这2个配置weboffice的外网地址（IP或域名）
还需要注意：OA服务器必须要能访问配置的weboffice外网IP或域名
如果不能访问，请客户调整网络。域名访问可通过配置内网DNS，或者OA主机添加hosts解析解决。
# 场景3：客户访问OA通过https访问
officeTrans.wps.openServiceUrl和weboffice.url 这2个配置weboffice的https地址
还需要注意：OA服务器必须要能访问配置的中台https地址
如果不能访问，请客户调整网络。域名访问可通过配置内网DNS，或者OA主机添加hosts解析解决。
