Jira使用手册

1    概述

跟踪并管理在项目开发和维护过程中出现的问题（如：缺陷、新特性、任务、改进等）是项目管理很重要的任务，但是很少有团队能做的很好。 JIRA作为一个专业的问题跟踪系统可以帮助您把缺陷管理起来，让跟踪和管理在项目中发现的问题变得简单，而且充分利用JIRA的灵活配置和扩展特性，可以将JIRA作为一个项目管理系统或者IT支持系统。

2    JIRA特性

1.    管理缺陷，新特性，任务，改进或者其他任何问题

2.    人性化使用的用户界面

3.    灵活的工作流定制

4.    全文搜索和强大的过滤器

5.    企业级的权限和安全控制

6.    非常灵活的邮件通知配置

7.    可以创建子任务

8.    方便的扩展及与其他系统集成：包括email、LDAP和源码控制工具等

9.    丰富的插件库、

10. 项目类别和组件/模块管理

11. 可以在几乎所有硬件，操作系统和数据库平台运行

3    JIRA角色

JIRA作为一个缺陷跟踪管理系统，可以被企业管理人员，项目管理人员，开发人员，分析人员，测试人员和其他人员所广泛使用。

3.1  管理人员：

根据JIRA系统提供的数据，更加准确地了解项目的开发质量和状态，以及整个团队的工作效率

3.2  项目管理者

可以针对登记进JIRA系统中问题，进行评估，分配缺陷；还可以通过JIRA系统的统计报告了解项目进展情况以及团队的工作量，工作效率等信息。

3.3  开发人员

在JIRA系统中查看分配给自己的问题，及时进行处理，填写处理情况并提交工作量记录。

3.4  测试人员

根据测试情况，在JIRA系统中及时快速的记录问题并对开发人员处理后的问题进行验证和跟踪。

 

 

4    责任

版本	修改日期	修改人
V0.1	2016.07.25	陈芹峰

5    JIRA管理使用

5.1  创建新项目

一个JIRA项目是所有问题的集合，它可以根据你的需求帮助你的团队协调产品开发，跟踪项目，管理帮助或更多。注意，必须以JIRA管理员身份来添加或配置项目。

1)   点击Projects > Create project

2)   按照向导来创建项目

关于项目的类型：

·        Simple Issue Tracking：该项目为你提供了一种快速简便的方法来启动和运行JIRA进行简单的问题跟踪，详见创建简单问题跟踪项目。

·        Project Management：这种项目类型创建一个默认的JIRA项目。

·        Agile Software Development— Scrum：该项目为你提供了Scrum的软件开发模板，包括Scrum主板以及特定敏捷的问题类型，如Story和Epic。

·        Agile Software Development— Kanban ：该项目为你提供看板软件开发模板，包括看板以及特定敏捷的问题类型，如Story和Epic。

·        Software Development：该项目提供了一个用于软件开发的模板，详见创建软件开发项目。

·        JIRA Default Schemes：这是使用共享JIRA默认方案创建项目（默认JIRA项目）的唯一项目类型。如果你使用任何其他项目类型创建一个项目，那么该项目将使用具体的项目方案（如问题类方案，工作流程方案，屏幕方案和问题类屏幕方案）。

关于项目的详细信息：

·        项目重点将作为该项目关键问题的前缀（如“TEST-100”），选择一个描述性且易于输入的。

·        项目负责人是唯一的。选择负责管理该项目的项目负责人。如果JIRA系统中只有一个用户，那该用户为默认的项目负责人，但这个领域将不可用。

5.2  配置已有项目

在JIRA中配置项目：

1. 导航到项目的管理页面：

o    选择Projects或

o    导航到所需项目的汇总并点击项目导航栏底部的Project Administration按钮。

2. 使用左侧的选项卡并在不同项目设置之间进行切换。阅读以下部分，了解每种设置的说明。

Summary | Issue types |Workflows | Screens | Fields | Settings | Roles | Versions | Components |Permissions | Notifications | Development tools

Project details

点击Project Summary页面顶部的EditProject，编辑想要的项目描述。注意以下几点：

·        编辑项目关键：编辑项目键之前阅读此页：编辑项目的Key。

·        项目描述URL：注意，这是完全未经过滤的URL，因此，很容易受到跨站点脚本攻击。

·        选择一个项目头像：如果你不想使用项目头像，你可以上传一个透明的像素。

关于项目类别：

项目类别不是在Edit Project对话框里编辑的。相反，点击项目管理员界面Category（项目名称下面）旁边的链接。类别可以通过Administration> Projects > Project Categories创建或查看。
为什么类别有用JIRA可以搜索特定项目类别中的所有问题（如高级搜索“building”类），并能按项目类别分类显示项目。一个JIRA项目只能属于一个类别。注意，项目类别不是项目层次结构的一部分。此外，JIRA不支持子项目或父项目。

Issue types

JIRA使你通过使用不同类型的问题跟踪不同类型的东西 –如 错误、任务等 。你可以查看已经指定为你项目的配置了字段和工作流的问题类型。如果你有JIRA管理员权限（全局权限），你还可以配置这些问题类型。
点击左侧菜单的Issue Types或它下面的任一问题类型如：Bug, Task, Story等：

·        Issue Types:单击该按钮可查看哪些问题类型适用于这个项目，（即问题类型方案）。也可以查看在该项目中的工作流、字段和屏幕问题类型，但它更容易通过点击问题类型之一来做到这一点。
如果是JIRA管理员，单击Actions菜单，在当前方案编辑问题类型或为你的项目使用不同的方案。

·        任一问题类型 (如Bug, Task,Story): 点击这个查看项目里的工作流或屏幕问题类型。
如果你是JIRA管理员，你同样可以通过标签来配置工作流和字段问题类型。

Workflows

JIRA问题遵循一个过程，来反映团队的工作。工作流定义一系列步骤（或状态）并且问题将会随之而来，如打开、在建、已解决。你可以配置使问题如何在状态间转换，如谁可以转换它们，在什么条件下，以及哪个转换对应哪个屏幕。

·        Workflow Scheme —项目的工作流程方案确定哪些工作流程（问题状态转换）适用于本次的项目类型。

Screens

JIRA可以通过定义屏幕显示在特定时间特定问题的信息。屏幕仅仅是字段的集合。你可以选择当通过工作流中的特定步骤创建、查看、编辑或转换问题时显示哪个屏幕。

·        Screen Scheme —该项目的屏幕方案决定了屏幕显示不同的问题操作（如查看、编辑、创建）;
或

·        Issue Type Screen Scheme —该项目的问题类型屏幕方案决定了哪个屏幕显示不同问题类型的操作（如查看、编辑、创建）。

Fields

JIRA允许定义字段：每个字段可以要求或自选、富文本或纯文本、隐藏或可见。通过使用字段配置来定义这些行为。

·        Field Configuration Scheme —项目的字段配置方案确定该项目的问题类型需要哪些字段配置。（字段配置将决定每个字段的整体可见性，需求度，格式（维基/富文本或纯文本）以及帮助文本）。

Settings

·        Application Links (Configure Project Links) —如果你已将自己的JIRA实例链接到其他Atlassian的应用程序，如Confluence, FishEye或其他JIRA实例，那么你能将该JIRA项目链接到那些包含你的项目或团队信息的应用领域。例如，Confluence空间，FishEye库，JIRA项目（在另一个JIRA实例）等等。这使你可以利用这些应用程序之间的集成点优势。详情请参阅Linking to AnotherApplication。

Roles

不同的人在不同的项目中承担不同的角色—同一个人可能是一个项目的负责人，也可能是另一个项目的遵循者。JIRA根据你所在的项目分配具体的角色。

·        Project Lead —用户履行项目负责人的角色。作为“默认受托人”（如下），也有可能在JIRA其他地方存在（如权限方案，通知方案，问题保障方案和工作流）。

·        Default Assignee —在创建项目问题时初始分配的用户。可以是“项目负责人”（如上）或者在JIRA的一般配置中Allow unassigned issues被设置为’On’，’Unassigned’。也有默认组件受托人。
默认情况下，新的项目将’Default Assignee’设置为’Unassigned’。你可将其设置为一个特定的角色，如’Project Lead’。

·        Project Roles —用户成员或组成员在项目中完成特定的功能。项目角色用于权限方案，通知方案，问题保障方案和工作流。

Versions

如果使用JIRA来管理产品的开发，你可能要定义不同的版本来帮助你跟踪哪些问题涉及到不同版本的产品（如1.0、1.1、1.2、2.0测试版、2.0）。 JIRA可以帮助你管理，发布和归档版本。版本可以设置发布日期，发布日期已过且尚未发布的将自动突显为”overdue”。

·        Versions —在项目中定义版本。详见version management。

Components

你可能需要定义各种部件进行分类和管理不同的问题。例如，对于一个软件开发项目，你可以定义组件 “数据库”，“可用性”，“文档”（注意，一个问题可以属于多个组件）。你可以为每一个组件选个默认受托人，在项目中让不同的人负责不同的子团队是很有用的。

·        Components —项目问题所在的逻辑组。详见component management。

Permissions

通过使用JIRA项目权限，你可以控制谁可以访问你的项目，他们可以做什么（例如“在问题作出评论”，“问题上开展工作”，“分配问题”）。你还可以通过使用安全级别来控制访问个别问题。你可以选择允许特定用户或组或角色有访问权限（注意这类角色往往是容易管理的）。

·        Permission Scheme —项目的权限方案决定谁有权在项目中查看或更改问题。

·        Issue Security Scheme —项目的问题安全方案决定了在这个项目中的可见性级别。

Notifications

当项目发生特定事件（如“问题创建”，“问题解决”）时JIRA可以通知相关人员。当不同的事件发生，你可以选择特定的人或群体或角色收到通知邮件。（注意此类角色往往是最容易管理的）

·        Notification Scheme —项目的通知方案决定当项目里的问题发生改变时谁可以收到通知邮件。

·        Email —仅当SMTP邮件服务器已经配置在JIRA，才可以指定“发件人”地址是该项目。

注意，Default Notification Scheme（JIRA附带）默认与所有的新项目关联。这意味着如果你有一个发送（SMTP）邮件服务器设置，当新项目中有任何活动（如问题创建）时，通知邮件将立刻发送。

Development tools

开发工具部分为你提供了连接的开发工具的概述以及哪些用户可以使用下面的集成功能：

·        View permission –这部分列出了哪些用户可以在问题屏幕上看到的集成功能的开发工具（如创建分支链接），以及其他开发相关的信息，如提交，审查和构建信息。这个功能是通过“View Development Tools”项目权限控制。

·        Applications –这部分将展示什么开发工具与JIRA通过应用链接连接以及和谁有资格使用JIRA的开发工具功能。

有关项目管理员的注意事项

JIRA中的项目管理员是有具体项目的管理项目权限，但不一定是JIRA管理员全局权限。
尽管没有JIRA管理员的全局权限，但项目管理员可以做如下操作：

·        编辑项目名称

·        编辑项目描述

·        编辑项目头像图片

·        编辑项目URL

·        编辑项目负责人

·        编辑项目角色成员

·        定义项目组成部分

·        定义项目版本

·        查看但不允许选择或编辑项目方案（通知方案、权限方案等）

更改JIRA项目的类别需要JIRA管理员全局权限。

 

5.3  创建问题

要创建一个JIRA问题，你需要有这一问题相关项目的创建问题权限。如果没有此权限，请联系JIRA管理员。

创建一个新的JIRA问题

1. 点击屏幕上方的Create打开Create Issue对话框。
2. 在Create Issue对话框中选择相应的项目以及问题类型。
3. 对问题进行总结，并完成相应的字段 – *为必填。
4. 如果要访问未显示在此对话框中的字段或要想隐藏现有字段：

o    点击屏幕右上方的Configure Fields按钮。

o    单击Custom，然后通过复选框来分别隐藏或显示相关字段，或是单击All显示所有字段。

o    当你下次创建问题时，JIRA会记住你上次选择的字段。

5. 选择：选择对话框底部的Create another复选框来创建一系列相同项目和类型的相似问题。
6. 当对你的问题内容满意时，单击Create按钮。

如果选择了Createanother复选框，将出现一个新的问题创建对话框。某些字段将根据以前的配置预先填充。请务必在创建下一个问题之前确保所有字段都正确。

温馨提示

·        可以通过Description或Comment字段提醒其他用户，点击Update按钮后邮件将发送到用户邮箱（注册JIRA账号时用的）。

·        某些文本字段的问题，可以链接到其他问题、插入宏、插入图片等等。

·        要想查看所有已创建但未解决的问题列表，到你的用户名下点击Profile> Filters > Reported & Open。

·        你可以自动成为你创建的问题的查看者，这由你的用户配置文件里的Autowatch设置的。注意，如果没有更改这个设置，你将继承由JIRA管理员设置的权限（通过> System > User Preferences设置）。

·        通过JIRA管理员适当的配置后，还可以通过邮件来创建问题。

·        如果你正在使用Scrum敏捷板，你可以通过创建内嵌问题将问题添加到你的待办事项。

创建问题示例

 

5.4  搜索问题

JIRA提供了强大的问题搜索工具，使你可以通过一系列搜索条件在整个项目、版本以及组件中搜索问题。 JIRA也可自定义搜索条件来进一步优化搜索。
搜索可以保存在JIRA过滤器中，以便再次调用相同条件的搜索，并且可以与其他用户共享。
你可以在JIRA搜索中：

·        修改和重复使用搜索结果

·        排序和操作个别问题

·        共享和输出问题

·        将问题显示在仪表板上

定义搜索条件

搜索问题的第一步是定义新的搜索条件。三种定义搜索条件的方式：quicksearch、basic search、advanced search。
如果你已经保存了以前的搜索（即作为一个过滤器），并希望再次运行它，你可以运行过滤器来加载保存的搜索条件。

搜索方法	描述
Quick search	最快的定义搜索条件方式。然而，在复杂的查询时相比其他检索方法不太精确（如project = JIRA AND status = Open AND priority = High）。快速搜索在导航栏里可见。点击快捷搜索查看详细信息。
Basic search	比快速搜索更精确，并且比高级搜索更容易使用。提供了一个友好的用户界面允许自定义复杂的查询，且无需知道如何使用JQL。点击基础搜索查看详细信息。
Advanced search	是三种搜索方式中最强大的。可以定义无法在其他搜索方式里定义的条件（如ORDER BY）。但是，你需要知道如何构建使用JIRA查询语言（JQL）。

关于filters
JIRA过滤器是保存搜索条件的集，类似于书签。一些过滤器是在JIRA中预定义的- 如My Open Issues,Reported by Me, Recently Viewed, All Issues – 这些被称为系统过滤器。过滤器也可以是一组由用户自定义和保存的搜索条件。
点击filter，你最喜欢的过滤器将示于左侧的面板。你可以在这里查看自己所有的以及共享给你的过滤器。
运行过滤器时，之前保存的搜索条件将加载到问题视图，这些条件既可以显示在基本搜索中又可以显示在高级搜索中，这取决于你所用的搜索方式。

修改搜索结果

一旦定义并运行搜索后，你可以修改搜索结果。 JIRA允许更改搜索结果的排序顺序，以及对个别问题的进行操作。
问题导航搜索结果示例:

 

保存搜索

要想以后再次运行此搜索，点击Saveas输入过滤器名字，把搜索存储为一个过滤器。该过滤器被创建并添加到你最喜欢的过滤器。

对搜索结果进行操作

搜索结果可以导出为多种格式（如Microsoft Excel）并且可通过邮件或RSS共享搜索结果。同样你也可以将搜索结果作为列表或图表显示在仪表板上。

 

5.5  查看项目

当你在JIRA中查看一个项目时，首先呈现的是项目概览页面。
该页面呈现出项目的所有动态概览，并且可以根据导航查看详细信息。你也可以添加快捷方式到信息中心和其他网页，以便所有用户访问该项目。

点击Projects下拉菜单选择你的项目进入项目概览页面。如果列表中没有你的项目，选择View all projects找到你的项目。
在项目概览页面，你可以通过选择项目导航栏的链接查看以下内容：

·        Project:

o    Summary — 显示项目最近的动态、项目负责人、项目中最活跃的用户以及该项目的键。

o    Releases * — 显示项目所有版本的快照，并且可以通过发布与未发布进行筛选。

o    Reports — 显示特殊用户、版本、问题或问题在其他领域的统计报告。

o    Components * — 显示项目所有组成部分的摘要。

o    Issues — 链接到项目的问题列表或详细视图。

o    Add-ons — 显示JIRA附加组件的链接，如日历或测试阶段。如果你集成了JIRA的其他产品，还可能看到其他链接。

* Releases和Components只有当项目管理员创建项目版本或组件后才可用。

·        Project Shortcuts:

o    项目的快捷方式可以被添加到项目导航页面以及你的团队可以访问的任何在线资源。这些快捷链接仅供有权访问该项目的用户使用。

 

5.6  编辑项目Key

编辑JIRA项目的键不是一个简单的任务。当创建项目时，你应该选择一个满足长期需求的键，而不是根据项目创建之后再更改。不过，也有需要更改现有项目键的情况，如更改产品名称。

本页面主要教大家如何更改项目的键，以及描述这种变化所带来的影响。

首先

·        项目键的格式必须是JIRA限制规定的格式。默认情况下，项目键格式必须至少为2个字符，并且只包含大写字母。
你可以更改项目键的格式来实现不同的限制。

·        在低使用率期间执行此更改—当保存更新项目键时JIRA将启动后台重新索引。这可能会对实例的性能产生影响。注意，不能选择 “Lock JIRA and rebuild index”，尽管它会使后台索引变快，但是将受限于项目的问题。

·        将更改传达给用户 – 确保你知道更改项目键的后果，且用户已做好充分准备。

编辑项目键

1. 导航到JIRA项目，并访问项目管理页面。选择Project Administration（项目导航栏的底部）。
2. 选择Edit Project按钮。
3. 选择Key字段旁边的edit key。
4. 更改键并点击Update。

注意：

·        页面上的其它字段，保存后可以直接看到更改后的信息。而不需要等待重新索引完成。

·        不要取消后台重新索引。如果取消，那么搜索与项目有关的问题时将出错。如果需要取消，你可以稍后再取消。

更新任务

· 

来源：Joker的逆袭