附件预览常见问题汇总

说明：

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打开苍