四、Office和系统对接问题

1.文档保存时,提示:强制保存出错

答:1.业务系统的回调保存方法正常保存文档后必需返回如下 json 内容给编辑器后台: { "error": 0 } ;

   2.如果返回值正确,则需要获取编辑器日志做进一步分析。


2.打开文档,提示:这份文件无法保存,请检查连接设置或联系您的管理员,<br>当你点击“OK”按钮,系统提示您下载文档。

答:1、判断编辑器后台和业务系统网络连接情况

callbackUrl指定业务系统后台保存接口的 URL

业务系统后台需要返回 json 格式 {“error”:0}

 

3.在畅写Office中下载文档时提示:下载文档失败

答:1、检查指的文档 URL 和编辑器服务网络是否通。(如服务器防火墙没有关闭)

2、检查业务系统是否有鉴权设置

 

4.SDK引入的api.js可以下载到本地使用吗?

答:我们的编辑器不止有一个JS文件的,还会通过这个文件调用很多同目录下的方法,所以还是需要引用您私有化部署的服务器上的js


5.需要加载新文件时,已经更换文档URL的情况下,打开还是旧文档(使用文档转换接口时也会遇到同样的问题)

答:需要加载新文件时,同时需要更新URL和Key值。

(新key,旧url,识别的是旧文档;旧key,新url,读取缓存,识别的是旧文档)


6.业务系统的回调保存接口保存的数据是编辑器里面已经更新的内容还是说保存的是当前更新好的文件。

答:回调接口会接收到更新好的文件下载地址。


7.是否支持业务系统替换文档选中内容接口

答:支持,通过当前光标处插入内容进行替换。


8.是否支持通过前端接口插入文档水印

答:目前不支持,暂未列入产品计划,将在2021年6月进行考虑


9.如何开启token

答:参照编辑器token文档


10.是否支持操作记录留痕

答:畅写Office以修订的形式记录操作记录留痕。(对同一内容进行连续修订,只记录最后一次修订记录。)


11.部署完成后,调用SDK,出现websoket的报错

 

image.png

答:畅写服务经过客户的nginx的网关,与客户方网络管理员确认有没有安装安全防护软件,安全防护软件有没有禁止websocket


12.服务器日志如何查看?

答:服务器目录:/data/appdata/var/log/changxieoffice/documentserver/docservice/out.log


13.客户业务是https,使用畅写时报跨域错误

答:在业务nginx中添加以下配置

image.png

注意加

proxy_set_header X-Forwarded-Proto  https;

 

14.如何使用畅写Office的修订模式(打开文档默认为修订模式进入,不可接受/拒绝修订)

答:前端配置参数,permissions中edit传false,review传true。

 

15.SDK的调用,是文件必须要存储到你们系统里面去才行吗?

答:文件不需要存储到畅写Office系统里,畅写Office打开编辑器的时候需要获取到原文档做文档编辑,文件是存储在业务系统指定的位置。

 

16.SDK里面需要获取到单元格内容,或者表格内容的,这种是怎么实现的?

答:业务系统应用页面嵌入畅写Office编辑器,打开电子表格文档,畅写Office有相应前端api来提取单元格内容。


17.用户需要先调用业务系统的API,将文件拉到编辑器,然后再调用你们的API来获取文件内容?

答:是的,用户先调用业务系统的API,将文件拉到编辑器,再打开文档,通过畅写的API来获取文件内容。

 

18.想要实现文档内容的权限分配,需要系统做什么?

答:需要记录文档的权限分配结果(部分编辑区域、用户、权限),在使用畅写进行部分编辑的时候把权限记录组织成参数传给畅写。

 

19.key是如何传给编辑器的?

答:生成规则由系统指定,作用是作为文档的识别id,类似于主键


20.编辑修改后的文件回调中有一个文件地址。过了一段时间再拿个这个地址在浏览器中下载文件找不到了。

答:编辑器后台生成的文档15分钟过期,15分钟后将取不到生成的文档