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

禅道企业版2.0版本，集成了collabora office。配置了collabora office后，支持collabora online在线预览和编辑文档。

一、 LibreOffice在线预览功能

在线预览功能需要在禅道所在的主机安装 LibreOffice， 安装路径 不能包含空格。

LibreOffice下载地址：

下载时，请选择适合自己的安装包。

官网： https://www.libreoffice.org/download/download/

安装好LibreOffice之后在禅道后台里开启office转换，并且填写 LibreOffice 的转换程序路径， 路径中不能包含空格。

下图所填路径为windows系统下安装的路径，如果是Linux系统，填写类似这样的路径： /opt/libreoffice/program/soffice。

开启配置成功后，就可以在线预览文档了。

在需求、任务、bug、用例等下添加了附件后，

可以在文档库的附件库里查看到。

直接点击，即可查直接在线预览附件的详情内容。

二、collabora office在线预览和编辑功能

（一）安装collabora office

首先需要安装collabora office，然后在禅道后台--office转换里配置上collabora office的路径。

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

（二）配置 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的路径为 http/https://所在服务器的IP:9980，collabora office的默认端口为9980。(反向代理除外)

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

3、 collabora office目前支持 .doc,.docx,.xls,.xlsx,.ppt,.pptx 格式的在线编辑；编辑保存后，文档直接更新。其他格式的支持在线预览。

配置成功后，我们就可以通过collabora office在线预览和编辑文档了。

（三）collabora office在线编辑功能

下面以word文档为例，介绍collabora office的在线预览和编辑。

1、点击附件里的 开源十年.doc 文档。

2、然后就可以使用collabora office的collabora online在线预览。

3、在线编辑文档。

点击在线预览页面右上角的 编辑图标，就可以进入文档的编辑页面。

勾选 开始修订记录，编辑文档时，会记录当前禅道登录用户的编辑信息。

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

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

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

4、直接创建Word、PPT、Excel格式的文档

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

点击进入文档库后，右上角的创建文档的下拉菜单里，有 创建Word、PPT、Excel格式的入口。

创建页面：

默认会创建成功一个空的 Word、PPT、Excel格式文档。

点击文档详情页面里，文档的标题就可以到文档的在线预览页面。

我们以word文档为例，具体给大家介绍。

点击页面的编辑按钮，进入编辑模式，就可以直接添加文档内容了。

添加完文档的内容，点击左上角的保存按钮，退出即可。

需要再次预览或者编辑时，点击文档的标题即可。

PPT类型文档的在线预览页面：

Excel类型文档的在线预览页面：

三、文档对比功能

添加的文档类型的文档，多次编辑后，可以通过对比，区分开每次修改的部分。

选择了对比版本后，即可查看到两个版本的区别。

绿色部分就是该文档两个版本的差别，也就是该文档#2版本比#3版本多的内容。

注： 文档对比中，显示为红色或者是加了红色边框的是 删除掉的，显示为绿色或者是加了绿色边框的是 新增的。

该文档#2版本和#3版本对比，

红色部分是，版本#4相比较#2版本删除的，绿色的框里的内容则是#4版本新增的。

四、手册类型文档

禅道企业版自2.3版本后，文档模块新增手册类型文档。

创建手册类型文档库后，可以对手册进行维护和编辑。

编辑手册：修改手册名称、权限控制等基本内容。

维护手册：设置手册章节类目，且顺序可以自由调控。

手册目录类型分为章节和文章，且顺序可以自由调控。