Redmine使用手册

一、 Redmine简介

Redmine是基于ROR框架开发的一套跨平台项目管理系统，是项目管理系统的后起之秀，据说是源于Basecamp的ror版而来，支持多种数据库，除了和DotProject的功能大致相当外，还有不少自己独特的功能，例如提供wiki、新闻台、时间跟踪、feed聚合、导出pdf等，还可以集成其他版本管理系统和BUG跟踪系统，例如SVN、CVS、TD等等。
它具有以下功能：
● 多项目和子项目支持
● 可配置的用户角色控制
● 可配置的问题追踪系统
● 自动日历和甘特图绘制
● 支持 Blog 形式的新闻发布、Wiki 形式的文档撰写和文件管理
● RSS 输出和邮件通知
● 每个项目可以配置独立的 Wiki 和论坛模块
● 简单的任务时间跟踪机制
● 用户、项目、问题支持自定义属性
● 支持多种版本控制系统绑定（SVN、CVS、Git、Mercurial、Darcs）
● 支持多 LDAP 用户认证
● 支持用户自注册和用户**
● 多语言支持（已经内置了简体中文）
● 多数据库支持（MySQL、SQLite、PostgreSQL）
● 外观模版化定制（可以使用 Basecamp 、Ruby安装）
接下来详细介绍redmine的使用。

二、 Redmine操作详解

2.1、 登录系统

使用Internet输入192.168.5.158:3000 连接到redmine页面，会看到下面的界面

点击新闻标题或者项目标题都可以看到具体的内容。但是未登录只能查看，不能进行实质性操作。
点击右上角的“登录”按钮。

未登录状态仅显示公开的项目

页面左面是“最近的新闻”，右面是“最近更新的项目”

左上角是快键菜单，点击“项目”可以看到所有公开的项目

右上角有登陆和注册按钮

用户注册：

输入登录名，密码。点击登录
登陆后注意要修改密码

界面跟未登录时板块显示相同，但是能看到未公开的项目。左上角显示操作菜单，右上角是个人快捷菜单

2.2、 设置账号

点击右上角的“我的账号”，会看到下面的界面，根据实际情况进行编辑

2.3、 我的工作台
点击主页的左上角的“我的工作台”会看到下面的界面。

2.4、 项目

点击窗口左上角的“项目”看到下面的界面

从下拉列表里选择想要添加到工作平台上的模块

平台上各个板块的位置可以通过拖拽实现移动，也可点击板块右面的 删除板块

主窗口显示所有建立的项目

右上角菜单依次是“新建项目”“查看所有问题”“全部活动” 

2.4.1、 新建项目

点击快捷菜单的“新建项目”，我们会看到下面的界面

来看一下我们建立的新项目

1. 输入项目的名称
2. 从下拉列表里选择上级栏目（不选择表示一级项目）对项目简单描述
3. 填写标识（默认为tt）
4. 公开：为登录也能看到
5. 选择跟踪链接（项目包含的跟踪，在建立问题时使用）
6. 模块：项目包含的模块（这些是现存的模块，管理员可以添加新的模块以供选择）

建立子项目的界面跟新建项目是项目的，不过上级目录那里自动生成了，其他的都可以进行相应的编辑、设置。
现在这个项目是空的，左上角的各个模块里也没有内容可显示，我们先来看一个有了活动的项目，回到项目列表主页，我们点击“测试项目1”会看到下面的界面

选择的模块显示在这里

四个跟踪标签

上图右侧有一个名称为“耗时”的列表，详情和报表对都是对项目中问题的统计图表，通过过滤器设置条件就可以看到不同的表格。

2.4.1.1、 新建问题

点击上图中的“新建问题”我们看到下面的界面

该项目中前三个模块：概述、活动、问题主要起到查看的功能，必须在给项目添加了内容以后才能进行实质性操作

我们从“新建问题”问题开始

信息设置完成后点击创建或创建并继续（继续创建新的问题），我们来看一下我们刚刚创建的问题

设置信息的基本属性，带星号的是必填的。

跟踪：从我们在新建项目时设置的跟踪标签里选择其中一个。（现在有错误、功能、支持、改进四种标签。在需要时可以通过管理员添加新的标签）。
可以上传附件

上图主窗口显示的就是我们刚刚建立的问题的各个属性，右上角的快捷菜单依次是：
更新：对该问题进行更新，可以增加或修改属性。打开的界面给新建问题时类似，操作方法也类似。
登记工时：登记问题可能的耗时，以便形成甘特图，时间进度表
跟踪：选中此项则有跟踪权限的人员可以随时了解该问题的进展
副本：为该问题创建一个副本，也可以将它放在其他的栏目下面
复制：将该问题复制，可以选择在原栏目下复制，也可以复制到其他栏目下面
删除：从栏目中删除该信息

2.4.1.2、 新闻

点击栏目“信息管理”下的新闻

完成新闻的输入后点击“创建”会看到下面的界面

2.4.1.3、 文档

点击栏目模块里的“文档”，选择“新建文档”，我们看到下面的界面

类别那里现在又两个选项：用户文档、技术文档（这里的类别可以根据工作需要添加）
点击创建则新文档创建成功

2.4.1.4、 Wiki

Wiki简单说来就是一种集体写作的平台，我们可以在某个项目下建立wiki，然后将针对这一项目所进行的工作都记录到里面。这不是简单的个人日志，其他跟此项目相关的人员也可以对wiki进行编辑。
具体一点，整个项目小组的人都可以编辑wiki，这样大家可以看到彼此的工作，可以提高用户协作能力，提高工作效率。
同新闻、文档的建立方法相同，我们可以在项目“信息管理”下建立wiki

工具栏上的前几项字体设置跟Word里的相同
无序列表：等同于Word里的项目符号
排序列表：等同于Word的编号
引用：在对wiki具体的某些内容回复时，可以使用此功能，引用想要回复的问题。

可以在主窗口进行编辑。
工具栏里依次为：加粗、斜体、下划线、删除线、程序代码、标题1、标题2、标题3、无序列表、排序列表、引用、删除引用、格式化文本、链接到wiki页面、图片
连接到wiki页面：可以理解为链接到wiki
Pre：pre 元素可定义预格式化的文本。被包围在 pre 元素中的文本通常会保留空格和换行符，而文本也会呈现为等宽字体。
来看一个例子
有两种设置方法：
1.在编辑内容之前，点击工具栏上的对应工具
2.编辑完成后，选中要设置内容再点击工具栏上的工具
3.注意除了前面几个字体设置工具在使用时不用空行继续外，其他的工具在使用时前后都要空行。特别的不同的标题也要空行，否则会全部显示为第一个使用的标题。
设置完成后可以预览一下，可以对不满意的地方进行修改，满意后点击保存，我们来看一下上面那个wiki呈现的结果

这四句从上到下依次设置为加粗、斜体、下划线、删除线

依次为标题1、2、3

无序列表

排序列表

引用

格式化文本

连接到wiki

2.4.1.5、 文件

点击项目“信息管理”菜单上的“文件”，我们会看到空的文件列表，点击列表右上方的“新建文件”，看到下面的界面

可以对wiki进行上面的操作，前提是拥有对应的权限

点击文件名，我们就可以下载查看了。

2.4.1.7、 配置

此功能对项目实施具体的，全面的配置：

信息：描述项目的基本信息，包括名称、描述、标识、跟踪标签等

模块：选择项目可以使用的模块，也就是我们在前面讲的项目的各个部分，像问题、文件这些

成员：为项目选择成员，可以从成员列表中添加，可以编辑、删除

版本：项目版本可以对变更进行跟踪和计划。 你可以给问题指定目标版本,然后在路线图中就能看到与改版本关联的问题列表。
版本包括的属性:
名称：输入版本名称
描述：详细介绍版本
状态：
打开：默认值, 没有限制
锁定：不能再给该版本指定新的问题
关闭：不能再给该版本指定新的问题, 而且不能重新打开已经指定目标版本的问题。
Wiki页面：可以将该版本的主要事件写入Wiki里, 以供浏览该版本时显示 可选属性 。
共享：该属性决定该版本是否能被其他项目共享，从而使其他项目的问题也可以指定到该版本
在版本列表页面点击"关闭已完成的版本"链接,
那些处于完成状态的版本(到达截至日期并且没有处于打开状态的问题)将自动关闭。

如果问题类别不满足需求可以在这里新建。

图 2-31 讨论区截图
讨论区：可以理解成针对项目的论坛

图 2-32 活动截图
活动：默认情况下, 活动阶段有"开发"和"设计"两种类型, 管理员可以根据需要创建新的活动阶段。
只有选中的活动阶段才会出现在登记工时页面的下拉框中。

版本库
新建版本库：

四、 Redmine进行项目管理的流程及其他

4.1 软件开发当中用Redmine进行管理的流程

1. 管理人员建立新项目

2. 开发人员和管理人员共同商议预测完成任务工时（以小时为单位估计时间不包括测试时间），建立项目中的问题/任务。

注意：在建立问题之前一定要利用项目的设置功能建立版本号，新建立的问题必须放在版本号下。

3. 问题指定的人员要及时更新问题状态，每天下班前和任务状态发生变化时“logtime”（登记工时）

4. 问题解决完成后将问题状态更改为“已解决”发给管理员，由管理员审核任务是不是真的已经解决。

5. 管理员将问题状态更改为“测试”发给测试人员

6. 测试人员测试完成后更改问题状态为“反馈”发给管理员，登记测试的结果。

7. 管理员根据反馈的具体内容（测试结果）决定是问题完成关闭任务，还是将反馈不合格的任务重新以打开的方式指派给开发人员

8. 3-6的过程可循环进行直到问题圆满完成

9. 如果问题在估计完成时间内为完成，可将问题复制到下一版本（迭代）继续进行，同时未完成任务者提交任务未及时完成原因报告。

4.2 绩效考核指标

1. 问题/任务创建是否正确，包括描述是否详细正确，有无给问题/任务正确指定版本号，跟踪者，实施者。

2. 开发人员反馈问题/任务及时性，是否每天都进行工时登记

3. 完成问题/任务时间与估计时间差距

4. 问题/任务超时时原因是否合理有效

4.3 注意事项

1. 在上传附件时最好用pdf格式，压缩文件必须用zip格式的，而不能用rar格式的。

2. 附件的名字要直观。

3. 任务到期时管理人员要及时关闭任务。

4. 出现新的问题时，并且需要花费时间就一定要管理员建立新任务，要保证所工作过的任务在redmine系统中看到。

5. 不要认为问题/任务越多考核就差，考核是结合任务的实际完成情况（估计工时，更新频率，反馈标注，是否延迟等）进行的，在解决问题过程中又发现新的问题时一定要登记到redmine

五、Redmine与其他系统的集成方式

5.1 Firefox

推荐大家用Firefox使用redmine程序，添加它的附加组件，如果平时截图比较多的话还可以下载Firefox的另一个组件—screengrap
Firefox redmine下载地址：
https://addons.mozilla.org/zh-CN/firefox/addon/11545/
Firefox screengrap下载地址：
https://addons.mozilla.org/en-US/firefox/addon/1146/

六、常见问题

6.1 为什么不能看到程序中的统计图形？

问：为什么不能看到程序中的统计图形？
答：必须安装SVGView程序才可以看到统计图形，另外，程序中很多图形都是flash的，浏览器中要有flash插件
SVGView下载地址：
ftp://192.168.1.11/dev_tool/redmine/

6.2 文件管理和文档管理的区别？

问：文件管理和文档管理有哪些区别
答：文档管理对项目由一定的描述意义，是为描述项目的某一件事而建立。而文件管理就是直观上传各种方式的附件。