Jira使用手册

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。

注意：

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

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

更新任务

·        Fix the project entity links?—?当你把JIRA和其它Atlassian应用程序链接时，JIRA项目和其他应用程序相关的项目（如Confluence spaces）之间的实体链接会被自动创建。如果JIRA项目的键更改了，那你需要修改项目的实体链接。

·        Updating JIRA Agile board filters?-?如果JIRA敏捷主板使用旧项目键，过滤器板需要更新到新的项目键。否则，版上可能不会显示更名后的项目问题。

变更管理注意事项

编辑项目的键是一个大的更改，多数情况下， 期望JIRA项目以新键运行。注意以下少数情况。

·        旧的项目键可用于JQL查询 - 用户将不必更新引用旧项目键的问题过滤器。

·        如果将Confluence和JIRA一起使用，Confluence中的JIRA问题宏将继续有效。注意，如果你没有马上看到更改，是因为缓存更新需要时间。

·        你不能使用旧的项目键来创建一个新的项目。但你可以将重命名的项目改回旧的项目键。如果删除该项目，所有相关的键将被释放，你就可以重新使用它们。

·        无论是来自JIRA内部或是外部的链接都将正常工作。然而，链接别名不会被更新 - 例如，如果有一个链接到名为“EXAMPLE-1”的链接，将该项目的键“EXAMPLE”改为“DEMO”后，别名'EXAMPLE-1'不会更新为'DEMO-1'，但该链接还是会链接到DEMO-1。

·        如果你在全局过滤器使用Activity Stream小工具，你需要在项目重命名后更新过滤器。

·        当项目的键更改后所有附件也可访问。但注意，它们的存储目录（<JIRAHome>\data\attachments）将保留旧的项目键。例如，如果把项目的键从TEST改为DEMO后，附件的存储目录仍是<JIRAHome>\data\attachments\TEST。

·        如果导出一个重命名的项目再将其导入，将显示更新后的项目键，即不会保留原来的项目键。事实上，该项目的所有历史键都将被移除。有一种解决方法，就是直接在你的数据库修改数据。

相关话题

Changing the maximum project key length?

你可以修改项目键的最大字符长度。导航到JIRA管理控制台的General Configuration页面修改Maximumproject key size字段。
Changingthe project key format?

你可以修改项目键的格式，但当创建或编辑项目键时，这将限制其格式。

开发人员注意事项

·        在项目键更改后REST API调用指定关键问题时仍用旧的项目键。例如，项目键从EXAMPLE 改为 DEMO后，/rest/api/issue/EXAMPLE-100仍可用。

·        ProjectUpdatedEvent事件被创建，任何时候项目的细节包括项目的键发生改变该事件将被触发。

·        要想检索所有问题键和项目键，你可以通过以下方式：
REST:

o    获取所有项目键:/rest/api/2/project/<project key>?expand=projectKeys

Java API:

o    获取所有项目键:com.atlassian.jira.project.ProjectManager#getAllProjectKeys

o    获取所有问题键:com.atlassian.jira.issue.IssueManager#getAllIssueKeys

 

5.7  简单问题跟踪

JIRA项目提供了一个快速简便的方法来启动JIRA进行简单的问题跟踪。旨在利用JIRA的其它强大功能的优势为用户提供简单的三步工作流程来进行问题跟踪。同时也很容易延伸至JIRA提供的其它更复杂的工作流程。

 

创建简单问题跟踪

根据下面的步骤来创建简单问题跟踪，确保第三步时选择Simple IssueTracking。

1. 以JIRA全局权限管理员身份登录。
2. 选择Projects > Create Project。
3. 选择你想要创建的 type of project。
4. 点击进入project details。注意谨慎选择项目键，因为在项目创建后不容易更改。
5. 点击Submit提交，然后创建下一个。

模板详细信息

问题类型

·        父类型：NewFeature、Task

·        子任务类型：Sub-Task

JIRA自动创建一个名为<项目键>：Simple IssueTracking issue type scheme的方案。

简单的问题项目工作流程
项目工作流程图如下：

流程描述

·        三个状态：To Do、In Progress和Done

·        直到状态Done项目结束

JIRA自动创建一个名为<项目键>：Simple IssueTracking workflow scheme的方案。

流程转换
转换具有以下特性：

·        当前用户指定'Start Progress'转换完成。

·        当前用户指定'Reopen and Start Progress'转换完成。

·        当任何'Done'执行转换完成。

·        当'Reopen'字段被清除时转换完成。

·        没有转换页面。

·        没有转换受理条件（除了整个方案的权限）。

 

5.8  创建软件开发项目

JIRA为软件开发项目提供了一个模板。包括简单工作流程以及开发评审过程中的各种任务状态。你也可以自定义模板来满足团队不断发展的过程。

创建软件开发项目

根据以下步骤来创建软件开发项目，确保在第三步时选择SoftwareDevelopment。

1. 以JIRA全局权限身份登录。
2. 选择Projects > Create Project。
3. 选择想要创建的项目类型。
4. 点击进入project details。注意谨慎选择项目键，因为在项目创建后不容易更改。
5. 点击Submit提交，然后创建下一个。
    

模板详细信息

问题类型

·        父类型：Story、Task、NewFeature和Bug

·        子任务类型：Sub-Task

JIRA自动创建一个名为<项目键>：Software Development issue type scheme的方案。

软件开发项目工作流程图：

流程描述

·        四个状态：To Do、In Progress、In Review和Done。

·        直到状态Done项目结束。

·        你可以从任何一个状态转换到关联的状态。

JIRA自动创建名为<项目键>: Software Development workflow scheme的方案。

 

5.9  共享搜索结果

JIRA可以使你很容易通过电子邮件或其它方式与其他用户共享搜索结果或过滤器链接。还可以在电子邮件中选择性添加注释。
要访问共享按钮，你的JIRA系统管理员必须配置有JIRA的SMTP邮件服务器。此外，还需要全局用户权限。
与一个或多个JIRA用户或任何电子邮件地址共享检索结果方法如下：

1. 选择Issues > Search for Issues.
2. 精确搜索，然后选择共享图标。
3. 指定JIRA用户（通过输入其用户名或其注册IRA帐户全名的部分/全部），或键入想分享的任何人的电子邮件地址。当开始输入一个JIRA用户的用户名或姓名，或先前指定的电子邮件地址，自动完成下拉菜单就会出现。

4. 添加注释。
5. 点击Share按钮。

 

5.10   基础搜索

本文主要介绍如何在JIRA中定义和执行基础搜索。你也可以定义和执行使用快速搜索或使用JQL（高级搜索）。
基础搜索截屏：

执行基础搜索

在JIR中执行基础搜索

1. 选择Issues > Search for Issues显示问题导航仪。

o    如果有现有搜索条件，点击New filter按钮重置搜索条件。

o    如果Basic是以链接形式存在，那么点击Basic切换到Basic搜索模型，基础搜索截图如下：

2. 输入搜索条件。你可以搜索特定的字段或搜索文本，如下所述：

o    按特定的字段搜索-你需要选择相应的字段然后指定该字段取值。

§  选择字段作为条件-Project, Issue Type, Status and Assignee字段作为搜索条件一直都可用，如果你需要其它字段作为搜索条件，点击More，勾选你想要的字段。
找不到想要的字段？字段成灰色？见下面的问题部分。

§  给字段指定值-点击字段下拉菜单选择或输入希望的字段值。如果下拉菜单中没有想要的值，在下面标红的框内输入该字段的值：

如果你最近选择过Assignee/Reporter字段来查找问题或查看了某个用户的个人资料页面，那么在选择Assignee/Reporter字段值时，系统会推荐该用户或组。

o    按特定文本搜索-在Contains text文本框输入查询条件然后点击Enter。Summary, Description, Comments, Environment等所有的文本自定义字段都会被检索。你可以在搜索文本里使用修改器，如通配符和逻辑运算符，详见执行文本搜索。

3. 搜索结果会自动更新，除非管理员关闭了自动更新搜索结果功能。如果是这样的话，在每次更改搜索条件后都要点击字段下拉菜单里的Update。
    

保存搜索 将搜索结果存储为过滤器。 执行保存搜索： 选择Issues > Search for Issues。 选择左边列表里的的任何过滤器： o    System filter — My Open Issues, Reported by Me, Recently Viewed, All Issues o    Favorite filters (按字母顺序列出) o    Find filters可以搜索任何被共享的过滤器，你也可以订阅（添加到你的Favorite Filters）。 选择某个filter后，搜索结果和搜索条件也都被显示出来。 如果选择了系统过滤器里的Recently Viewed，JIRA将切换到高级搜索，因为在过滤器中基础搜索不能呈现ORDER BY子句。 你可以添加，删除或修改搜索条件来细化搜索结果。你还可以保存修改后的搜索条件（更新自己的过滤器），或者将搜索条件的副本保存为一个新的过滤器。

过滤器列表截屏：

可能遇到的问题

·        为什么找不到想要选择的字段？某些字段只适用于特定项目/问题类型。因此你必须选择适用的项目/问题类型，否则不能选择该字段。

·        为什么字段选项呈灰色？某些字段只适用于特定项目/问题类型。如果在搜索中选择某字段，然后删除引用该字段的所有项目/问题类型，则该字段是无效的。无效字段不能用于搜索并且显示为灰色文本。

·        为什么会在字段里出现？有些字段值仅适用于特定项目/问题类型。例如，你可能已经配置了一个项目，在其工作流中使用status 进行QA审核。如果在你的搜索中选择此项目和status，然后更改不使用QA审查的项目搜索为过滤器，那么该状态将是无效的并且在搜索中被忽略。

·        为什么搜索结果不自动更新？当任何字段改变时搜索结果会自动更新，前提是你的管理员没有禁用搜索结果自动更新的功能。向管理员咨询是否关闭搜索结果自动更新。

Next steps

·        阅读使用问题导航查询如何将搜索结果进行分来排序或查看个人的问题。

·        跳转到对搜索结果数据进行操作，查询如何将搜索结果保存为一个问题过滤器，输出搜索结果并共享。

 

5.11   快捷搜索

有时候你只希望去了解你感兴趣的特定JIRA问题，但不记得具体问题是什么，只记得是一个分配给你未决的问题。这种情况下快捷搜索可以帮助你。

跳转到一个问题

Quick Search框在屏幕的右上方。如果输入一个项目的建，将直接跳转到该问题。例如，输入'ABC-107' (或'abc-107')然后单击回车键，将直接跳转到JIRA问题'ABC-107'。

很多情况下，你甚至不需要输入完整的键，只需数字部分即可。如果你当前正在'ABC'项目上里操作，输入'123'就可以直接跳转到'ABC-123'。

智能查询

快捷搜索可以使你通过最少的输入进行智能查询。例如，要查询'TEST'项目里所有的open bugs，你只需简单输入'test open bugs'，快捷搜索就可以找到它们。
搜索结果将会呈现在问题导航里，你可以通过多种可用格式（Excel, XML,等）来查看。
快速搜索关键词：

关键词	描述	示例
my	查找分配给自己的问题。	my open bugs
r:	通过在r:前缀后面添加用户来查找问题 注意"r:"和用户之间没有空格。	r:me - 查找自己发布的问题 r:Samuel - 查找"samuel"用户发布的问题 r:none - 查找没有发布者的问题
项目名称或项目键	查找具体项目里的问题。	test project TST tst
overdue	查找已经逾期的问题 。	overdue
created: updated: due:	通过使用created:, updated:和 due:前缀来搜索问题。你可以采用today, tomorrow, yesterday, 一个日期范围(如 '-1w'), 或两个日期范围 (如'-1w,1w')。注意日期范围里不能有空格。有效日期/时间的缩写：'w'(week),'d'(day),'h'(hour),'m'(minute)。	created:today created:yesterday updated:-1w - 搜索上一周更新的问题 due:1w - 搜索下一周即将逾期的问题 due:-1d,1w - 搜索从昨天到下一周之间的问题 created:-1w,-30m - 搜索从过去一周到30分钟之前创建的问题 created:-1d updated:-4h - 搜索昨天创建并且4小时前更新的问题
优先	通过具体的优先查找问题 。	blocker major trivial
问题类型	通过具体的问题类型搜索问题。注意问题类型也可以用复数。	bug task bugs tasks
解决方案	通过具体的解决方案搜索问题。	fixed duplicate cannot reproduce
c:	通过具体组件搜索问题，注意"c:"和组件名称之间无空格。	c:security - 查找组件名称里含有"security"的问题
v:	通过版本号搜索问题。使用通配符“*”查找包含该版本号的所有版本问题。 注意"v:"和版本名称之间无空格。	v:3.0 - 搜索匹配该版本的所有问题如： ·         3.0 ·         3.0 eap ·         3.0 beta 但不会匹配如下版本，如： ·         3.0.1 ·         3.0.0.4
ff:	查找特定修复版本，使用方法与v:相同。
*	通配符'*可以用于v:和ff:。	v:3.2* - 搜索包含有v:3.2的所有版本相关问题，如： ·         3.2 ·         3.2-beta ·         3.2.1 ·         3.2.x

自由文本搜索

你可以通过输入你想查找的问题里的任何词，该词是包含在下列任一字段中的内容：

·        Summary

·        Description

·        Comments

通过浏览器的查询框搜索JIRA问题

如果你是用Firefox或IE8浏览器，你可以通过浏览器搜索框旁边的下拉菜单添加你的JIRA网站作为一个搜索引擎。一旦添加了，你可以任何时候在该JIRA网站执行快捷搜索。

 

5.12   高级搜索

什么是高级搜索？

高级搜索可以让你使用结构化查询搜索JIRA问题。搜索结果将显示在问题导航器，你可以将其导出到MS Excel等多种格式。你还可以保存和订阅你的高级搜索。
当你执行高级搜索时，你是用的是JIRA搜索语言（JQL）。JQL简单查询（也称为一个“语句”）包括一个字段，包括一个运算符、一个或多个值或功能。例如，下面的简单的查询会搜索在“TEST”项目中的所有问题：
project = "TEST"
这个例子使用Project字段，EQUALS 运算符以及"TEST"值。
JQL提供一些类似于SQL的语法，比如ORDER BY SQL关键字和ISNULL（）SQL函数。然而，JQL不是数据库查询语言。例如，JQL不具有SELECT语句。

如何执行高级搜索

1. 选择Issues > Search for Issues将出现问题导航界面。

o    如果有现有的搜索条件，请单击New filter按钮复位搜索条件。

o    如果Advanced是以链接显示，点击该链接切换到高级搜索。

2. 使用字段、运算符、字段值或函数输入查询条件。
3. 点击Search按钮执行查询。

执行文本搜索

当在以下字段执行搜索时，可以使用Lucene的文本搜索功能的CONTAINS运算符：

·        Summary

·        Description

·        Environment

·        Comments

·        custom 字段采用“自由文本搜索器”，包括以下内置自定义字段类型：

o    Free Text Field(无限制文本)

o    Text Field (<255字节)

o    Read-only TextField

在JQL中使用文本字段的"some words"值搜索问题。这会搜索所有文本自定义字段如总结、描述、环境、评论。如果你有很多文本自定义字段，你可以通过搜索特定的字段来改进搜索，例如：
Summary ~ "some words" OR Description ~ "some words"

使用自动填写功能

当你在输入查询条件时，JIRA会自动识别上下文并提供一个自动填写推荐列表。自动填写推荐列表按字母顺序排列，包括前15个匹配值。注意自动填写推荐不提供函数参数。
注意：
如果自动填写推荐没有出现，可能是因为你的管理员关闭了JIRA实例的该功
自动填写推荐不会出现在所有字段。点击字段参考查看那些字段支持自动填写。

在高级搜索和简单搜索之间切换

通常情况下，使用“简单搜索”创建查询可能会被转换成“高级搜索”（JQL），然后再简单查询查询。
然而，使用“高级搜索”创建查询就不会被转换成“简单搜索”，特别是当：

·        查询包含OR运算符（注意你可以使用IN运算符，但它将被转换，例如：project in (A, B)）

o    例：尽管(project= JRA OR project = CONF)查询等同于(project in (JRA, CONF))，但只有第二个查询会被转换

·        查询包含NOT运算符

·        查询包含EMPTY运算符

·        查询包含任何!=, IS, IS NOT, >, >=, <, <=运算符

·        查询指定相关项目中的字段和值（如版本，组成，自定义字段），并且该项目没有明确包括在查询中（如fixVersion=“4.0”，没有AND project=JRA）。这些自定义字段特别棘手，因为它们可以在一个项目/问题类型的基础上进行配置。一般的经验规则是，如果该查询不能在“简单搜索”的形式创建，那么如果使用“高级搜索”创造该查询，那么该查询将不会被转换成'简单搜索'。

设置运算符优先

你可以通过使用括号来强调JQL语句中运算符的优先级。例如，如果你想查找SysAdmin项目中所有被解决的问题，以及目前被分配给系统管理员（bobsmith）的问题。你可以在你的查询中使用括号强制执行布尔运算符的优先级，即：
tatus=resolved AND project=SysAdmin) OR assignee=bobsmith
需要注意的是，如果你不使用括号，该语句将使用运算符优先级评估。你还可以使用括号来组合语句，这样就可以将NOT运算符应用于组。
如果你添加括号强制符的优先级，但他们没有严格要求的运算符优先级执行但返回相同的结果，当你保存查询时JIRA会删除你查询语句里面的优先级。