Skip to content
W3S101

JIRA - 搜索

Jira - 搜索 Issue

Section titled “Jira - 搜索 Issue”

Jira 提供强大而灵活的 Search（搜索）功能，帮助您在 Project、Version 和 Component 中查找 Issue。您可以将 Search 条件保存为“Filter”（过滤器）以供重复使用，并与您的 Team（团队）共享或在 Dashboards（仪表盘）和 Reports（报告）中使用它们。

主要 Search 方法

Section titled “主要 Search 方法”

Jira 主要提供两种 Search Issue 的方式：

  • Basic Search: 用户友好的基于表单的界面。
  • Advanced Search (JQL): 使用 Jira Query Language（Jira 查询语言）进行复杂且精确的查询。
  • Quick Search: 用于通过 Issue Key 或 Keywords（关键字）快速查找。
Section titled “Basic Search”

Basic Search 提供了一种直观的方式来查找 Issue，而无需了解 JQL。要执行 Basic Search：

  1. 导航到顶部导航栏中的“Issues”，然后选择“搜索 Issue (Search for issues)”（或类似的选项，如“查看所有 Issue 和 Filter”）。
  2. 如果先前的 Search 处于活动状态，您可能会看到其条件。您可以点击“新建 Filter (New filter)”或修改现有条件。
  3. 使用下拉菜单为“Project”、“Issue Type”、“Status”和“Assignee”等 Field 选择条件。
  4. 点击“更多 (More)”以添加其他标准或 Custom field 的条件。
  5. 在文本搜索框（通常标记为“Contains text”）中输入 Keywords，以查找其 Summary、Description 或 Comments 中包含特定术语的 Issue。

使用 Basic Search 时，Jira 会在后台构建一个 JQL 查询。您通常可以切换到“Advanced Search”来查看和编辑此 JQL。

Advanced Search (JQL)

Section titled “Advanced Search (JQL)”

对于更复杂的查询，Jira Query Language (JQL) 提供强大且灵活的语法。要使用 JQL：

  1. 导航到 Issue Search 页面，如 Basic Search 中所述。
  2. 如果您处于 Basic Search 模式，请点击“切换到 JQL (Switch to JQL)”或“高级 (Advanced)” Link（具体措辞可能有所不同）。
  3. 在 Search bar 中输入您的 JQL 查询。Jira 提供 Auto-complete suggestions（自动完成建议），帮助您构建有效的查询。

常见的 JQL 示例：

  • 查找分配给当前用户的 Issue： assignee = currentUser()
  • 查找由当前用户报告的 Issue： reporter = currentUser()
  • 查找特定 Project 中的 Issue： project = "Project Alpha" 或 project = "PROJA" (使用 Project Key)
  • 查找 Open 状态的 Bug： issuetype = Bug AND status = Open
  • 查找过去 7 天内创建的 Issue： created >= -7d
  • 查找文本 Field 中提及“performance”的 Issue： text ~ "performance"
  • 查找没有到期日期 (due date) 的 Issue： duedate IS EMPTY

JQL 支持各种 Operators（运算符，例如 =, !=, >, <, IN, NOT IN, IS, IS NOT）、Keywords（关键字，例如 AND, OR, NOT, ORDER BY）和 Functions（函数，例如 currentUser(), now(), membersOf()）。

保存和管理 Search (Filters)

Section titled “保存和管理 Search (Filters)”

定义 Search 条件后（通过 Basic Search 或 Advanced Search）：

  1. 点击“另存为 (Save as)”按钮（通常位于 Search 结果上方）。
  2. 为您的 Filter 输入描述性名称，然后点击“提交 (Submit)”或“保存 (Save)”。
  3. 您保存的 Filter 将显示在 Sidebar（侧边栏）中（通常在“收藏的 Filter (Favorite filters)”或“我未解决的 Issue (My open issues)”等下方）。您可以管理您的 Filter，与他人共享，或订阅以接收 Filter 结果的电子邮件 Notifications（通知）。
Section titled “Quick Search”

Quick Search bar 通常位于 Jira 的主 Navigation header 中，是查找特定项的最快方式。

  • 输入 Issue Key（例如 PROJ-123），直接跳转到该 Issue。
  • 输入 Keywords 以 Search Issue 的 Summary、Description 和 Comments。
  • 使用“智能查询 (smart queries)”（Jira 通常在您键入时建议）：
  • my open issues: 显示分配给您且未 Resolved 的 Issue。
  • r:me: 您报告的 Issue。
  • 您还可以键入 Project 名称或用户名称的一部分。

实际应用

Section titled “实际应用”

高效 Search 对于在 Jira 中的日常工作至关重要。保存的 JQL Filters 被广泛用于创建自定义 Dashboards，以监控 Project 运行状况、跟踪 Team 进度、管理个人工作负载（例如，“我本周关键的 Bug”）或为 Stakeholders（相关方）生成特定 Reports。

常见学习障碍：掌握 JQL 语法需要练习，特别是 Custom fields 或更复杂的逻辑 Conditions。利用 Jira 的 JQL Auto-complete feature，并参考 Atlassian 官方 JQL Documentation，获取完整的 Field、Operators 和 Functions 列表。