Redmine 管理员手册

Redmine管理员手册Redmine管理员手册作者:北京群英汇信息技术有限公司网址:版本:1.0.0-8+日期:2010-07-2912:23:45版权信息:目录1说明2项目管理3用户管理4用户组管理5LDAP认证6角色和权限7问题跟踪系统8自定义属性9枚举值10配置11高级配置o11.1版本库配置o11.2发送邮件配置o11.3接收邮件11.3.1方案11.3.2各种方案的详细说明11.3.2.1从邮件服务器转发邮件11.3.2.2从IMAP服务器读取邮件11.3.2.3从POP3服务器读取邮件11.3.2.4从标准输入读取邮件11.3.3开启匿名用户通过邮件提交问题11.3.4工作原理11.3.5例子演示o11.4发送提醒邮件o11.5LDAP认证o11.6配置单点登录o11.7从LDAP同步账号o11.8Subversion基于路径授权1说明关于手册中方框标记部分的说明Note是需要注意的部分。Hint是群英汇为Redmine扩展的部分。2项目管理项目列表默认情况下,项目列表显示所有活动的项目。要想浏览所有项目(包括活动和归档项目),需要调整项目状态过滤器为全部。项目列表截图新建/编辑项目项目存档在项目列表页面点击存档链接,可将该项目存档。存档项目对用户不可见。管理员可以取消存档。当父项目存档,它的所有子项目也都自动存档。复制现有项目在项目列表页面,点击复制链接复制你想要复制的项目。复制项目的表单将会预填原项目的设置(如:跟踪标签,自定义属性...)。在该表单的底部,你可以选择复制原项目的哪些内容。删除项目在项目列表页面,点击删除链接,界面将跳到删除页面,选中是复选框,然后点击删除按钮,该项目以及子项目的所有数据都将被删除。Note存档与删除的区别:存档只是隐藏项目及子项目,而项目的数据还存在。删除则是将项目以及子项目的数据一同删除,无法恢复。3用户管理用户列表用户列表截图默认情况下显示活动的用户,你可以调节用户状态过滤器,选择浏览不同状态的用户。通过点击右侧锁定链接,可将用户从活动的状态变为已锁定状态。同样点击解锁链接,可以将用户从已锁定状态变为活动的状态。添加用户点击右上角的新建用户链接,跳转到新建用户页面:必填字段:o登录名o名字o姓氏o邮件地址o管理员选中之后,该用户将是管理员的身份。o认证如果你已经配置了LDAP,那么认证区域将会出现一个认证模式的下拉选择框。Redmine提供了两种认证机制内部认证将用户的密码经过加密后存入数据库中。外部认证(如LDAP)用户的密码存储在一些外部认证中,如LDAP。o给用户发送账号信息选中它,创建账号后,新建的用户将收到一封关于账号信息的邮件。Hint从LDAP同步账号Redmine的LDAP认证模式是:首先管理员配置好LDAP认证,并且选中即时用户生成选项,然后当用户用LDAP账号第一次登录Redmine时,系统自动将LDAP里的用户信息存入数据库,为用户创建Redmine账号。但这样会有一个问题:如果管理员想批量给某一项目添加项目成员,这时不得不一一通知这些人,让他们都立马登录一下Redmine(因为只有这样,他们才拥有Redmine账号,管理员才能给这些用户划分角色,授予权限)。显然这很麻烦,给管理人员带来不必的烦恼,似乎管理人员的权利需要员工给予。群英汇给Redmine的管理人员带来了福音,我们添加了管理人员可以直接从LDAP服务器同步账号到Redmine的功能。实际上，如果配置了外部的认证源（LDAP或者单点登录），点击“新建用户”，会直接跳转到LDAP帐号同步界面。操作步骤,参见从LDAP同步账号。编辑用户想要编辑用户信息,只需点击用户名,就跳转到修改该用户信息的页面了。o一般属性和新建用户界面的属性一样。o组如果你创建了组,在这里会显示组选项卡。o项目在这里可以给该用户指定项目。4用户组管理用户组列表截图从Redmine-0.9开始,管理员可以定义用户组。用户组可以像添加常规用户一样添加到项目中去。当把用户添加到一个已存在的用户组里,该用户将拥有该组的一切权限。5LDAP认证在1.0以前，新建LDAP需要一系列繁杂的操作：管理--配置--认证--LDAP认证（右下角处）。为了方便用户操作，固将LDAP操作置于管理员界面右边栏。6角色和权限角色决定用户在项目中拥有的权限。每个项目成员在项目中可以有一个或者多个角色。每个用户在不同的项目中可以有不同的角色。管理员可以创建新的角色;也可以编辑已经存在的角色;只有当某一角色下没有用户时,该角色才能被删除。角色的属性o名称o问题可指派给此角色如果不选,问题就不能指派给该角色里的成员。o从以下选项复制工作流程新建的角色可以从已经存在的角色中复制工作流,如果不选则新建角色的工作流为空。权限当编辑一个角色的时候,你可以通过(选中/取消)那些不同的行为给该角色定义权限。权限描述项目权限新建项目允许非管理用户创建根项目编辑项目允许用户编辑项目的属性权限描述选择项目模块允许用户开启/禁用项目的模块管理成员允许用户添加/删除项目组成员或者改变项目组成员的角色管理版本允许用户添加/删除项目的版本新建子项目允许用户为该项目创建子项目讨论区权限管理讨论区允许用户添加/编辑/删除项目的讨论区发表贴子允许用户在讨论区发表贴子编辑贴子允许用户编辑任何贴子、删除贴子的附件编辑自己的贴子仅允许用户编辑自己的贴子删除贴子允许用户删除任何贴子和回复删除自己的贴子仅允许用户删除自己的贴子和回复文档权限权限描述管理文档允许用户添加/编辑/删除项目的文档查看文档允许用户查看文档文件权限管理文件允许用户添加/编辑/删除项目的文件查看文件允许用户查看文件问题跟踪权限管理问题类别允许用户添加/编辑/删除问题类别查看问题允许用户查看问题新建问题允许用户新建问题更新问题允许用户编辑问题管理问题关联允许用户添加/删除问题之间的关联管理子任务允许用户给问题（issues）添加/删除子任务权限描述添加说明允许用户给已存在的问题添加说明编辑说明允许用户编辑任何的问题说明编辑自己的说明仅允许用户编辑自己添加的问题说明移动问题允许用户将已存在的问题移动到别的项目中删除问题允许用户删除问题管理公开的查询允许用户添加/编辑/删除公开的问题查询保存查询允许用户保存自定义问题查询查看甘特图允许用户浏览甘特图查看日历允许用户浏览日历查看跟踪者列表允许用户查看问题的跟踪者添加跟踪者允许用户给已存在的问题添加跟踪者删除跟踪者允许用户删除问题的跟踪者权限描述新闻权限管理新闻允许用户添加/编辑/删除项目的新闻为新闻添加评论允许用户给新闻添加评论版本库权限管理版本库允许用户配置项目的版本库浏览版本库允许用户浏览并查看项目版本库的内容查看变更允许用户查看变更集访问提交信息给予Redmine.pm具有访问项目版本库写的权限时间跟踪权限登记工时允许用户给项目登记工时查看耗时允许用户查看项目的耗时历史编辑耗时允许用户编辑任何耗时记录权限描述编辑自己的耗时仅允许用户编辑自己的耗时记录管理项目活动允许用户添加/编辑/删除活动Wiki权限管理Wiki允许用户创建/删除项目的Wiki删除Wiki页面是不可恢复的操作,它会删除所有相关的页面及附件重命名Wiki页面允许用户重命名Wiki页面,或者指定Wiki页面的父页面删除Wiki页面允许用户删除Wiki页面,此操作是不可恢复的,页面以及修改历史将被统统删除查看Wiki允许用户查看Wiki页面导出Wiki页面允许用户将Wiki页面导出为各种格式（pdf,html,...)查看Wiki历史记录允许用户老版本的Wiki页面,或者查看不同版本之间的差别编辑Wiki页允许用户编辑没有保护的Wiki页面权限描述面删除附件允许用户删除Wiki页面的附件保护Wiki页面允许用户锁定/解锁Wiki页面,并具有编辑已锁定的WIki页面的权限系统角色在Redmine共有2种系统角色,他们供Redmine内部使用,因此不能被删除。oNonmember非项目成员角色,用于定义那些不属于该项目成员的用户的权限。oAnonymous匿名角色,用于定义匿名用户在项目中的权限。Note这两个角色仅被用于公开项目,因此匿名用户和非私有项目成员用户不能看到它。一些权限不能赋给这两个角色。例如管理成员7问题跟踪系统跟踪标签新建跟踪标签截图跟踪标签代表不同的问题类型。默认情况下有三种标签:错误,功能和支持。管理员可以新建跟踪标签:o名称o在路线图中显示问题o从以下选项复制工作流程新建的跟踪标签可以从已经存在的跟踪标签中复制工作流。如果不选,那么新建的跟踪标签的工作流为空。o项目可以指定新建的跟踪标签用于哪些项目中。问题状态管理员可以根据需要自由地添加和删除问题状态。问题状态含有的属性:o名称o已关闭的问题如果选中,则表示处于该状态的问题属于已经关闭的问题(可以声明多个状态属于已关闭的状态)。o默认值指定新建问题的默认状态(只能有一个状态属于默认状态)。完成度该选项（即问题状态一览表中的完成度列）只有在计算问题完成度选项设置为使用问题的状态时才显示。更新问题的完成度该链接只有在计算问题完成度选项设置为使用问题的状态时才显示。当点击该链接后，系统将根据问题的状态更改问题的完成度。以后每当问题的状态更新，系统自动根据这里设置的完成度更改完成度字段的值。设置问题状态对应的完成度工作流工作流使你可以定义不同角色的项目成员对不同类型的问题所能做的问题状态变更。定制工作流截图在工作流设置页面,选择你想要编辑的角色和跟踪标签,点击编辑按钮,跳转到编辑页面,此页面可以编辑该角色对该标签所能做的变更状态。左侧列出了该跟踪标签所有的状态,你可以在右侧选择针对该状态该角色可以变更的状态。Note要改变问题的状态，用户需要具有更新问题或者添加说明的权限。（参见权限）。8自定义属性自定义属性截图Redmine允许管理员给以下实体添加属性,从而给这些实体添加额外的描述信息:问题耗时项目版本库用户组活动(时间跟踪)问题优先级文档类别自定义的属性有以下几种数据类型:整数字符串单行输入框文本多行输入文本域日期布尔值复选框列表下拉列表自定义属性的约束条件:最小-最大长度决定自定义属性的字段长度(0表示没有限制)。正则表达式通过指定的正则表达式,对自定义属性的内容进行验证。默认值自定义属性的默认值跟踪标签设置该自定义属性可以在哪些跟踪标签中使用必填该自定义属性是否是必填字段用于所有项目该自定义属性是否用于所有项目中作为过滤条件该自定义属性是否作为过滤器的过滤条件可用作搜索条件该自定义属性是否可以用作搜索时的搜索条件9枚举值枚举值截图Redmine允许管理员对以下实体添加枚举值,从而扩充这些实体可选择的值:活动(时间跟踪)问题优先级文档类别这些枚举值是跨项目的管理员可以任意地添加/修改/删除。枚举值包含的字段:名称活动只有活动的枚举值才能被使用默认值如果选中,那么在使用同类枚举值时该枚举值默认被选中同一类枚举值的默认值只能设置一个10配置一般o应用程序标题显示在应用程序头部的文字o欢迎文字这些文本将显示在项目概述页面o附件大小限制上传文件的最大值。默认为5120KBo每页显示条目个数的设置这个主要用于分页显示,在这里可以填入你想要每页显示的记录数,多个值之间用逗号分开。默认值:25,50,100o在项目活动中显示的天数在这里可以设置每页显示多少天之内的活动默认值:30表示显示30天之内的活动o主机名称在这里设置Redmine服务的主机名称和路径。Redmine用这个值生成邮件签名里的URL,从而收件人通过点击邮件签名里的URL访问系统。o协议协议指邮件通知里生成的链接打开方式。默认值:http邮件里的链接是“guessed”，因此不会诊断你使用的是不安全的Http协议还是安全的https协议。o文本格式格式文本用于问题,新闻,文档,Wiki等