2010年欧洲结核病治疗指南解读

2011-02Redmine及SVN在项目管理中应用Page*目录_01Page*关于Redmine Redmine是一个灵活的项目管理工具,它可以有效地管理项目开发的整个流程(需求,,开发) 多项目支持 „在一个Redmine平台上管理您的所有项目在个Redmine平台上管理您的所有项目 „用户在不同项目中可属于不同角色 „项目可设定为公开的（所有人都可见）或者内部的（只有项目成员可见） „可在项目中激活或隐藏模块（即：wiki、版本库、问跟踪……） „基于角色的灵活访问控制 定义您自己的角色并快速设定他们的权限 灵活的问题跟踪系统 „定义您自己的问题状态和问题类型„ 可以通过web管理界面为每种问题类型和角色设置工作流程Page*有用的功能特性 甘特图和日历 „根据为问题设定的开始日期和完成日期自动生成甘特图和日历 时间跟踪功能 „在项目级别或者问题级别设定时间 „根据用户、问题类型、类别或者活动生成工作量报表 „自定义属性 „您可以为问题、项目和用户添加自定义属性 „可以使用多种格式：文本、日期、证书、下拉列表、复选框 自定义属性可以像常规属性那样显示在问题列表中并可以作为过滤器使用 新闻、文档和文件管理 „您可以方便的发布消息和共享文件 为每个项目设置独立的wiki和讨论区 „Wiki使用textile语法注释功能Page*为什么我们要用Redmine Redmine是一个交流的平台，所有跟项目有关的内容都可以放进去，需要的人可以随时查看而不必挨个找人问。 有任何新的想法和发现了新问题都可以随时记录下来，如果坚持使用可以彻底解决优秀想法被遗忘的问题 帮助绩效考核和个人总结Page*关于SVN Subversion（简称SVN）是版本管理工具 Subversion是一个自由/开源版本控制系统 一组文件存放在中心版本库,记录每一次文件和目录的修改 版本化的目录 真实的版本历史 原子提交 版本化的元数据 一致的数据操作 有效率的分支和标签Page*目录_02Page*我的工作台显示你所参与的项目的各种信息块。默认情况下只有下面两个模块启用： 指派给我的问题 提供一个跨项目的指派给当前用户的问题列表，显示问题的ID，项目，跟踪标签类型和主题。 已报告的问题 提供一个跨项目的由当前用户报告的问题列表，显示问题的ID，项目，跟踪标签类型和主题。可个性化定制Page*项目列表 任何页面点击顶端可“项目”即可展现项目列表 列出了所有自己有权限查看的项目 点击项目名称可进入该项目主页 左上角有3个快捷链接： 在一个页面上查看所有项目的问题 在一个页面上查看所有项目的耗时情况 在一个页面上查看所有项目的活动Page*项目概述页 页面提供一个关于该项目的总体概述 左上角的问题跟踪区域列出了目前项中每一种问题跟踪标签的打开数量以及总共数量 在成员区域列出该项目组的所有成员 在最新新闻区域列出了项目的最新新闻 问题跟踪： 错误指该项目中发现的错误 功能指对该项目提出的新增功能需求 支持指为项目做出的贡献，例如提交了一个补丁文件 工作安排指日常的工作安排（需后台添加，管理员可以添加更多问题类型）Page*引申出重要概念——问题 问题是一个宽泛的概念，英文版中用的是Issue，可以翻译成问题、课题 发现的错误、新提的要求、对工作的安排等都可以被当作问 问题是一个过程性的概念，从提出问题到解决问题、关闭问题是一个完整的过程，表示了对错误的处理、对新需求的响应或对工作安排的完成情况正处于什么样的阶段 系统默认的问题状态有5种： 新建：表示错误刚被发现、新需求刚被提出、或者工作任务刚被下达 进行中：表示已经安排了人来处理该问题 已解决：表示此问题已经被解决 反馈：表示有人对问题的解决效果提出了反馈意见 已关闭：表示问题已经彻底解决并通过审核，可以告一段落。默认情况下问题列表中将不再显示已经关闭的问题。 已拒绝：认为该问题提出的错误不存在、工作任务不合理等，拒绝执行此问题Page*项目活动 活动就是指人们在系统上进行各种操作的记录： 所有可以显示的活动类型见右侧边栏（问题、变更、新闻、文档、文件、Wiki编辑记录、帖子、耗时） 对于管理者来说可以看看项目成员每天都在做什么工作 在项目列表页面点击‘全部活动’显示的是所有项目的活动 如果想看看近期有什么新内容，可以把Wiki和帖子选上，则可以看到Wiki新增加的内容和讨论区里面新发布的帖子Page*路线图 路线图提供了一个更高级别的基于项目版本的对于整个问题跟踪系统的概述,它可以帮助制定项目,管理项目开发。 概述 点击"路线图"选项卡,你就可以查看当前项目的进展状态: 版本名称、版本的完成日期、进度条、目标版本相关连的问题列表 管理路线图 如果你的权限合适,你可以为版本添加一个wiki页面,用于描述当前版本的一些主要事件。 边栏 路线图页面的右边栏为你提供了以下功能: 可以根据需要,选择路线图上显示哪些跟踪标签。 可以根据需要,选择是否显示已经完成的版本 所有版本的链接Page*路线图的运用 项目版本同时新建问题（一般来说是功能）时选择对应目标版本 每个版本会列出预定的结束时间和进度（按照已关闭问题占全部问题的比例计算） 画了删除线的问题表示已经解决 所有问题都解决后，表示这个版本可以发布了 对项目经理有一定意义，可预先定义产品特性或者项目需求 对产品经理来说意义非凡，可对多个版本需要实现的产品特性进行分派Page*问题列表 默认显示所有打开的问题（即需要有人处理的问题）： 点击问题列表上的表头可以排序 使用过滤器可以查找特定的问题（如按类别查找、按作者查找等） 使用问题前面的复选框可以选择多个问题，然后点击右键可以通过快捷菜单处理多个问题 可以导出到RSS（新闻订阅）、CSV、PDF 重要操作 过滤器应用 批量编辑 自定义查询 条目上的快捷菜单（编辑、状态、跟踪标签、优先级、目标版本、指派给、完成度、登记工时、跟踪者、副本、复制、移动、删除）Page*新增问题 按照表单填写即可 问题被新建或者被更新后系统将自动发送通知邮件 问题的作者和被指派者将自动收到通知邮件 收到通知邮件后，正确的做法是： 点击邮件中的连接打开问题详情页面 如果对此问题有意见或者需要补充，请点击更新按钮增加说明 更新后新的通知邮件又会自动发送 其他用户（非作者和被指派者）如果也想收到该问题的通知，可以使用‘跟踪’功能（详见问题详情） 创建问题时,最重要的字段是跟踪标签字段,它决定了问题的类型。Page*子任务及相关问题 系统支持子任务和相关问题，即支持任务分解（WBS） 点击某一问题，进入问题查看页面。然后点击子任务区域的新增链接，进入新建子任务页面，父任务字段的值系统自动获得，其他字段像创建问题一样输入，最后点击保存。 点击相关问题区域的新增链接，可根据具体的情况建立不同类型的问题关联。Page*相关问题的关联允许开发者将某一问题与其他问题建立关联,从而起到了删除重复问题,简化工作流的作用。当前版本允许建立的关联类型有: 关联到 普通关联关系，问题A、B需要分别关闭 重复 如果问题B重复于A，那么关闭A将自动关闭B。 阻挡和被阻挡 阻挡：如果问题B阻挡A，A无法关闭，除非B关闭。被阻挡相反。 优先于 如果A优先于B，那么将B的起始日期自动设置为A的截至日期+延迟天数+1。 跟随于 问题B跟随于A（例如A截至于21/04，B开始于22/04），这时如果将A的截至日期延迟2天，那么B的起始和截至日期将自动推迟2天。Page*合理使用跟踪者 新增问题、修改问题都可以添加问题发生变化时需要告知的人员 新增问题时是在跟踪者区域选择人员，修改问题时是在右侧快捷工具区 用户也可以自己来点跟踪按钮实现跟踪功能 通过问题的跟踪者功能来实现对多人的通知 问题有变化后会向所有跟踪者发送通知 跟踪者刚被添加进来后不能立即发送问题现状的邮件给他，必须要等问题有变化后他才能开始收到通知Page*新增问题要求 问题主题即问题的内容，要简洁，但一定要具体，让人能一眼看明白 对问题的详细描述，要尽量写全写细。提供的问题描述越清楚，就越容易被及时响应和修改。不要让负责人去猜测你的意图。如有可能尽量传图片上来（通过最后的文件功能）。最好指定目标版本，这样系统可以为你生成路线图和更新列表 最好指定类别（相当于博客的标签），问题增多时分类将大有帮助 新建问题前请确认已经选择了正确的项目。不要把本项目的问题创建到别的项目中去！项目名称显示在页面左上角! 如果新建问题时已经定下来由谁负责，那就在指派给那里选中他。 如果对问题的解决有时间限制请务必写上开始时间和完成日期Page*更新问题时机 负责人必须在有变化时及时更新问题 需要更新问题的几种情况： 提出的问题有误需要添加说明或者想要提出意见：注意把说明部分写清楚 问题状态变化时：例如状态变为已解决或者已关闭，完成度变为88％等 负责人认为不能按照完成日期完成：可修改完成日期并把原因写入说明 负责人改变：修改指派给 登记工时：登记自己为此项目作出的工作。非常实用的功能，建议每个人都使用。不仅仅是对个人工作的认可，可用于管理者个人绩效。详细的工作量数据将为以后项目的估算提供坚实基础Page*工作中问题编辑的要求 如果工作有进展，问题的负责人务必及时更新问题的状态。如果问题解决完了，就把完成度选成100%并将状态选成已关闭，同时写上说明让关心的人知道问题被如何解决。 更新问题时不必修改指派给谁，因为负责人不会变来变去。创建问题的人、被指派的人、以及跟踪者都会同时收到问题通知。除非问题被错误的指派给你（这时应当将问题指派给创建者并说明原因） 问题解决完后一定要把状态选为关闭，完成度改成100％不会自动关闭问题。 问题关闭后才会在问题列表中隐藏否则永远占着位置 问题是一个过程，一定要有新建->处理->反馈->完成->关闭这种类似流程的事情才应该使用问题来处理 文档的共享和保存应该使用文件或文档功能，而不是问题功能。 信息的共享和保存应该使用Wiki功能Page*甘特图 在项目概述页面点"甘特图"打开或者在问题列表页面,点击右边栏的"甘特图"链接,即可进入甘特图界面。 甘特图显示问题的起止日期以及版本的截至日期 甘特图显示每个问题的进度 如果定义了版本，甘特图会显示每个版本的结束时间 可以导出到PDF或者PNGPage*日历 在问题列表页面,点击右边栏的"日历"链接,即可进入日历界面。 日历提供了一个按月份显示的项目预览。在这里你可以看到一个任务状态的起止日期。 日历上显示的是每天开始的问题和结束的问题 以比较直观的显问题的进度可以比较直观的显示问题的进度Page*新闻 有“新闻”权限的用户可以为项目添加新闻 可以用来介绍项目的新进展 最新的新闻也会显示系统首页和项目主页上 通过右上角的添加新闻按钮来添加（没权限看不到）通过右上角的添加新闻按钮来添加（没权限看不到） 右下角有RSS订阅按钮 详细信息只有点击了该新闻条目时才能看到Page*文档 与本项目相关的文档可以统一放在这里管理 管理员可以增加文档的类别 可以为文档添加说明 一份文档可以包含多个文件 在列表页上可以按照文档类别、日期、标题、作者进行排序 默认文档类别为“技术文档”、“用户文档”Page*WIKI Redmine包含一个简单的Wiki系统 不需要会编写网页可以很容易把各种资料做成网页形式分享不比使用WORD更困难 所有有权限的用户都可以随时增加条目或者编辑现有内容，实现协作创造 所有修改都有历史记录，并可还原至前面的某一版本 右侧连接可以查看所有条目的列表，并按照标题或者日期排序 可以包含附件，如图片等 提供丰富的格式，包括粗体、列表、超链接、嵌入的图片、代码语法高亮等 因为创建和修改十分方便，因此不必等资料完善后才开始添加Page*Wiki使用 创建一个新的Wiki页面 在任何一个wiki页面，仅仅需要添加一个你想要创建的新页面的链接。[[MyNewPage]]保存当前页面，点击刚添加的链接，恭喜：你已经成功创建了一个名为"MyNewPage"的新页面。 保护wiki页面 如果你拥有保护wiki页面的权限，你可以点击"锁定"链接保护该Wiki页面。 已经锁定的wiki页面只允许拥有保护wiki页面权限的用户编辑。 拥有此权限的用户同样可以为该页面解锁。 Wiki页面的历史 Redmine保存每一次wiki页面的改动历史。通过点击"历史"链接你可以浏览这些变更。 点击变更的序列号可查看某一个具体版本的页面信息。 你可以通过点击"回退到这个版本"的链接回退该页面到先前的版本。Page*讨论区 讨论区是用户可以任意发布各种信息、讨论、求助等内容的地方 每个项目有自己的讨论区（1个或多个） 管理员可以随时为项目添加或删除讨论区 需要在项目配置中新增讨论区才可以看见Page*文件 为用户提供文件下载服务的地方 按照版本分类?按照版本分类 可以上传与某个版本相关的各种文件 文件大小限制：10M 不要传过大文件，大文件应该放到其他地方保存Page*版本库 点击"版本库"选项卡,你可以浏览项目的版本库以及最近的提交。 你可以通过打开目录前面的"+"按钮,展开目录。 你也可以点击目录链接进入该目录。 点击某一修订号你可以查看该次提交的详细信息。 想要浏览已知提交号的某一次提交的具体信息,你可以将该提交号直接输入右上角的输入框里,按回车键即可查看。 提交修订需要采用SVN客户端，这里只提供web查看。 Redmine生成两种关于变更和修订数量的版本库图片。一幅按月份显示变更和修订数量;一幅按提交者显示变更和修订数量。 修订是版本库的提交次数,显示为橘红色。 变更是对版本库中文件的修改次数,显示为蓝色。Page*项目配置 项目的配置界面，可以修改项目的各种参数 信息 在这里可以设置 项目名称 项目描述 是否公开 如果选中,该项目将允许所有用户浏览,包括非项目成员的用户。 如果不选,只有项目成员才有权限访问。 跟踪标签 在这里可以设置开启哪些跟踪标签,默认可用的有三种:错误,功能和支持。 模块 在这里可以设置该项目开启的功能模块 成员 在这里可以指定项目的成员,以及他们的角色。Page*项目配置2 版本 项目版本可以对变更进行跟踪和计划。你可以给问题指定目标版本,然后在路线图中就能看到与该版本关联的问题列表。 版本包括的属性: 名称、描述、状态 Wiki页面 可以将该版本的主要事件写入Wiki里,以供浏览该版本时显示可选属性。 日期 版本的完成日期可选属性 问题类别 问题类别功能可以有效组织管理项目的问题。 问题类别的属性: 名字必填字段 指派给 新建属于该类别的问题将自动指派给该项目成员可选字段。Page*项目配置3 wiki 每一个项目拥有它自己的wiki。 版本库 每一个项目能跟一个版本库(SCM)建立关联。一旦版本库配置成功,你就可以点击"版本库"选项卡,浏览版本库的变更集了。版本库的变更集也能在活动页面浏览到。 讨论区 每一个项目可以有一个或者多个讨论区。讨论区的属性有: 名称 描述 活动 默认情况下,活动阶段有"开发"和"测试"两种类型,管理员可以根据需要创建新的活动阶段。 只有选中的活动阶段才会出现在登记工时页面的下拉框中。Page*目录_03Page*目录_04Page*TortoiseRedminePlugin 可在提交文件是预览关联的问题 下载地址：http://code.google.com/p/redmine-projects/downloads/list 需要.net运行库 其参数设置直接从项目列表页面拷贝（可先设置查询条件再拷贝）Page*项目代码和非代码管理 将代码和非代码分别作为两个子项目管理 代码对应的仓库建立trunk、tags、branches三个目录来存放代码（需手工建立）Page*代码中svn:keywords保存信息 Date这个关键字保存了文件最后一次在版本库修改的日期。 Revision这个关键字描述了这个文件最后一次修改的修订版本。 Author这个关键字描述了最后一个修改这个文件的用户。 HeadURL这个关键字描述了这个文件在版本库最新版本的完全URL。 Id 这个关键字是其他关键字一个压缩组合 自动 vi~/.subversion/config *.java=svn:keywords=IdRevisionDate *.cpp=svn:keywords=IdRevisionDate [miscellany] enable-auto-props=yesPage*SVN提交时commitLog写法 使用关键字来描述提交的代码引用了哪些问题、解决了哪些问题。用于解决问题的关键字后问题的变更设置:应用后的状态和完成度 默认的关键字有: 引用:refs,references,IssueID 解决:fixes,closes 例如： 日志：修正了以下bug：closes#2，#4，#5，并参考了refs#8 这次代码提交解决了问题2、4、5，引用了问题8 格式要求： 每个关键字和问题ID之间可以用空格,逗号或者&分开 功能性用closes，bug用fixes。感谢您的关注