说明：

1. 本汇总贴根据各项目顾问、实施老师和客户老师反馈问题持续更新。

1. 附件为什么不显示预览按钮或无法预览？

答：登录当前环境的 monitor，进入注册中心，在列表中选择任意一行，点击系统属性，输入fileserver.attachment.preview，查看预览参数是否设置为 true，若为 false，则不支持预览。

2. 附件预览失败如何分析？

答：参考文档《附件预览失败问题分析》。

3.  word、excel不能预览；图片、pdf可以预览如何解决？

答：此为文件服务问题，参考文档《文件服务问题排查》，密码：hzvq 。

4. 附件预览时提示“该文件暂不支持预览”，右键控制台查看preview.do响应显示“文件可能已被损坏，无法进行pdf转换，预览失败”如何解决？

答：此为文件服务问题，参考文档《文件服务问题排查》，密码：hzvq 。

5. F12查看preview.do请求的响应，提示云盘服务响应失败如何解决？ 

答：此为文件服务问题，参考文档《文件服务问题排查》，密码：hzvq 。

6.  为什么附件只显示预览和下载按钮？

答：检查单据是否是查看态，若是，则不允许做上传和下载操作，不显示上传、删除等按钮。

7.  附件预览如何使用自己的预览服务？

答：参考文档《想要了解“文件预览二开流程”，看这里！》。

8. 附件面板的备注按钮是否支持隐藏？

答：附件面板的备注按钮暂不支持隐藏。

9. 如何获取预览Url？

答：临时附件和持久化附件的预览url获取接口如下：

/**
  * 获取临时附件的预览url
  *
  * @param path 临时附件的downloadUrl全路径
  * @return 临时附件的预览url
  *
  * 入参示例：http://localhost:8080/ierp/tempfile/download.do?
  * configKey=redis.serversForCache&id=tempfile-1688297935936176128
  */
 kd.bos.entity.datamodel.IAttachmentModel#getTempFilePreviewUrl(String path)

 /**
  * 获取持久化附件的预览url
  *
  * @param path 持久化附件的downloadUrl相对路径
  * @return 持久化附件的预览url
  *
  * 入参示例：
 /tenant_devcore_dev/1402323749146986496/202305/1683569603244172288/5b3c272f9d5a42fdbecddf2d84bcdd56/Wo rd文档.docx
  */
 kd.bos.url.UrlService#getAttachmentPreviewUrl(String path)

10. 为什么附件面板或附件字段上预览word文件时所展示的内容和下载之后客户端展示的内容会有差异？

答：检查文档里是否做了文档超链接，默认预览时会把链接的真实标题显示出来。

11. 文件预览失败，preview接口报错“云盘服务下载文档失败”的原因是什么？

答：此报错一般为网络问题，参考文档《文件服务问题排查》，密码：hzvq 。若还是无法确定原因，补充检查nginx是否能正常转发，nginx的SSL证书最近是否有替换。

12. 通过云之家打开单据，为什么在移动端预览附件时不显示水印，在PC端却可以显示？

答：因为在云之家移动端预览时，是用的云之家自带的预览功能，所以水印配置对云之家会不生效。

13. 在开启了path加密之后，为什么预览附件时提示文件不存在？

答：path加密之后，需要做对应的解密才能够正常预览，原因为获取真实路径的配置类未找到，请做如下检查：

图片相关的控件请检查是否配置此mc参数：

image.filepath.impl.classname = kd.bos.service.image.ImageFilePathService

附件字段和附件面板等控件请检查是否配置此mc参数：

filepath.impl.classname = kd.bos.service.attachment.FilePathService

若未配置，请添加对应的配置。

14. 默认预览方式预览时繁体字乱码，如何处理？

答：首先需要联系运维对云盘进行升级，升级之后测试是否解决，若仍未解决，请升级到5.0.025 以上版本；无法升级版本请提单联系总部出私包。

15. 苍穹6.0以上版本附件预览配置了新页签打开，预览的时候提示“新页签打开失败”，如何排查？

答：【公共设置】—【参数配置】—【系统参数】-【文件服务参数】查看当前的预览方式，若是默认方式，请检查【公共设置】—【参数配置】—【系统参数】—【自定义参数】 查看SPREAD_JS_PREVIEW参数的值，若为true，则代码开启了spreadjs预览模式，不支持新页签打开。若是其它的预览方式，f12查看preview.do请求，看响应的内容是否为{“status”:“success”,“url”:“https://xxxx”}，响应内容不是类似的json串，证明获取预览链接失败，查看preview.do的traceid并根据traceid查找日志，根据错误日志去判断是网络问题或者其它问题，做对应的配置调整。

16. 对接第三方预览服务，客户是否需要自行购买？移动端是否支持预览？

答：客户需要去对应的第三方平台官网自行购买，金蝶不提供购买渠道。苍穹标准产品已经支持使用OnlyOffice，WPS，永中进行移动端预览。

17. 业务通过iframe打开苍穹预览链接，预览界面展示{"RedirectUrl":"index.html"}，该怎么解决？

答：首先检查是否存在mc参数is_need_check_csrf且其值是否为true。此参数为安全校验参数，临时关闭可解决此问题。若不能关闭此参数，则检查预览链接是否带有kd_cs_ticket参数，若没有，可以通过如下代码获取参数值，

String param =

SessionManager.getCSRFTokenValue(RequestContext.get().getGlobalSessionId());

在预览链接之后拼上&kd_cs_ticket=param。

18. WPS试用版的水印是否可以去除？

答：试用版无法去除水印。

19. V6.0之前的版本可以标准产品支持WPS预览吗？

答：V6.0之前的版本只支持使用WPS开放平台2023年2月份之前的版本，对接方法详见：附件预览集成wps网页在线预览功能。

20.  WEBOFFICE、WPS客户端编辑和Wps在线编辑后台实现区别？二开时能在afterUpload方法做干预吗？

答：WEBOFFICE和WPS客户端保存走的是kd.bos.form.control.WebOffice#save(java.lang.String, java.lang.String)这个方法，此方法会给前端发送save指令，前端收到此指令就会发送uploadFile.do请求，做文件上传操作，上传成功之后，返回新文件的临时下载地址，前端会再发一个upload请求给后端更新附件。

wps在线编辑实现方式与客户端不一样，保存时触发wps回调，回调到苍穹的接口后，后端会给前端发一个ws消息，前端接收到ws消息之后调用平台的kd.bos.form.control.WebOffice#upload方法，更新附件。

两种方式均会走到afterUpload方法，二开可以在插件里做上传干预。

21. 为什么WPS文档中台融合版本在苍穹平台配置完成之后还是无法预览？

答：目前苍穹对接的文档中台版本为V6通用版本，V7大部分功能也可以适配，但是融合版本与通用版本接口存在较大差异，当前版本无法兼容。

22. WPS文档中台能否被多个服务使用？

答：不可以，一个文档中台服务（即一个许可）生态上只能对接一个系统，回调地址也只能配置一个，这就限制了一个文档中台服务只能被一个系统所使用。

23. 预览方式为永中或者WPS时，业务通过iframe打开预览链接，未打开文件预览界面，而是扎实了一串json信息，该如何做才能打开文件预览呢？

答：首先自行通过iframe打开预览链接做文件展示的方式只适用于默认预览方式，所以为了兼容其它预览方式的场景，业务需要判断预览类型，当预览类型为用永中或者WPS时需要先发一次http请求preview.do接口获取到第三方的预览链接，再把此预览链接放到iframe上去。

24. 使用WPS文档中台预览时preview请求返回Target host is null错误信息，该如何解决？

答：出现此错误的原因是WPS文档中台服务部署的服务器不支持https请求。可以通过nginx配置使其支持https，也可以暂时使用http，即【公共设置】—【参数配置】—【系统参数】-【文件服务参数】下配置的WPS文档中台预览的文件服务部署地址配置成http://xxxx。

25. WPS文档中台预览时一直转圈，如何排查？

答：f12查看preview.do请求的响应，若是提示超时，检查在WPS服务台配置的回调域名是否正确，回调域名为：苍穹访问地址+/attachment。

26. 预览方式选择WPS开放平台，“服务部署地址”如何获取？

答：通过WPS提供的回调服务出口IP获取。每个ip以英文逗号（,）拼接为一个字符串来配置。