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 （按具体版本名字是填写）。

开启配置成功后，就可以在线预览文档了。在需求、任务、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”创建

或者直接点击产品库、项目库、执行库以及自定义库的“创建文档库”，选择“手册”作为文档库类型进行创建。

点击手册目录旁的更多按钮，手册进行维护和编辑。

• 编辑手册：修改手册名称、权限控制等基本内容。
• 维护手册：设置手册章节类目，且顺序可以自由调整。

点击“维护手册”-“章节”，可以对手册进行章节和文章的添加，且其顺序可以自由拖拽进行调整。