Question

禅道企业版增加了附件在线预览和文档版本对比功能。

禅道企业版2.0版本起，集成了 Collabora Office。用户配置了 Collabora Office后，可以使用 Collabora Online 在线预览和编辑文档。

一、LibreOffice在线预览功能

在线预览功能需要在禅道所在的主机安装 LibreOffice 。

注意：LibreOffice 不要安装在有空格和中文的目录。

LibreOffice 下载地址：https://www.libreoffice.org/download/download/

安装好 LibreOffice 之后，在禅道“后台”-“系统设置”-“Office”里开启功能，并且填写LibreOffice的转换程序路径。

下图所填路径为 Windows 系统下安装的路径，如果是 Linux 系统，填写类似这样的路径：/usr/bin/libreoffice6.4 （按具体版本名字是填写）。

windows系统中libreOffice的路径复制出来是：D:\LibreOffice\program\soffice.com，
需要修改为：D:/LibreOffice/zentaopms/soffice.com，然后再填入。

开启配置成功后，就可以在线预览文档了。在需求、任务、bug、用例等下添加的附件，直接点击，即可查看附件的内容。

二、Collabora Office 在线预览和编辑功能

1、安装 Collabora Office

首先需要安装 Collabora Office，然后在禅道“后台”--“系统设置”--“Office”里配置上 Collabora Office 的路径。

选择适合自己的安装方式： https://www.collaboraoffice.com/code-install-and-test/

2、配置 Collabora Office

1）要使用 Collabora Office，禅道的访问方式必须是 PATH_INFO

1.1 配置禅道企业版的安装运行环境的伪静态，url 支持重写。

1.2 把禅道企业版 config 目录下，my.php 的 $config->requestType= 'GET' 改为 $config->requestType= 'PATH_INFO'。

1.3 修改完成后，重启禅道企业版服务。

1.4 GET 访问方式时，在“后台”--“系统设置”-“Office”下，Collabora Office 默认隐藏，改为 PATH_INFO 方式访问时才会显示。

2 ）Collabora Office 的路径仅支持 url 地址

2.1 Collabora Office 与禅道企业版可以安装在同一服务器上，也可以安装在不同的服务器上。

2.2 Collabora Office 的路径为https://所在服务器的 IP:9980，Collabora Office 的默认端口为 9980。(反向代理除外)

2.3 禅道的服务器和 Collabora Office 所在的服务器网络必须是互通的。

3) Collabora Office 目前支持 .doc, .docx, .xls, .xlsx, .ppt, .pptx 格式的在线编辑

编辑保存后，文档直接更新。其他格式的支持在线预览。

3、Collabora Office在线编辑功能

以 Word 文档为例，介绍 Collabora Office 的在线预览和编辑。

点击附件里的文档，关于禅道.doc。

Collabora Office 的在线预览功能会打开该文档。

点击在线预览页面右上角的“编辑”，进入文档的编辑页面。勾选“编辑”--“编辑修订”--“开始修订记录” ，那么在编辑文档时，会记录当前禅道登录用户的编辑信息。

编辑文档后，右侧会标注出不同用户的修改记录。

可以接受和拒绝修改该记录。当该修改记录被拒绝或接受后，右侧的标注会消失。

保存退出后，将会自动记录修改，保存在原文档上。

三、创建 Word、PPT、Excel 格式的文档

禅道企业版3.2版本起，文档新增加了创建 Word、PPT、Excel 格式文档的功能。

点击进入文档下我的空间、产品空间、项目空间、接口空间、团队空间均支持创建文档，均可以选择创建Word、PPT、Excel 类型的文档。

默认会创建一个空的 Word、PPT或Excel格式文档。
文档详情页面里，点击文档的标题就可以进入在线预览页面。

四、创建Wiki文档

禅道企业版自2.3版本起新增Wiki类型文档，可以在各个空间下创建Wiki文档。