常规查询示例

自定义列表”中提供的“查询”字段以及其他网格式应用程序将为您提供使用多个条件来筛选所示数据的方法。您可以在该字段中输入 SQL 式查询以根据工作项的状态、所有者或其他字段来查找特定的工作项。

查询字段

示例

名称中带特定文本的工作项

如果您使用各种命名约定来标识不同分组的工作项,该示例则十分有用:

(Name contains "Technical Debt")

特定迭代中的工作项(按 ID)

您必须知道迭代 OID 才能使用以下查询。查看某一迭代的详细信息页面时,您可以通过 URL 末尾显示的数字来找到 OID,如 rally1.rallydev.com/#/483229521d/detail/iteration/6082450599。

(Iteration.OID = "6082450599")

特定迭代中的工作项(按名称)

(Iteration.Name = "September Sprint 2")

自定义下拉字段未选择任何值的工作项

(DropDownField = "")

没有父用户情景的用户情景

(Parent = null)

有父项但不属于项目组合项的用户情景

((PortfolioItem = null) AND (Parent != null))

有父项为用户情景或功能级项目组合项的用户情景

((PortfolioItem != null) OR (Parent != null))

未结缺陷

(State "Closed")

与某一父项关联的用户情景

(Parent.FormattedID = 18)

需要估算值的用户情景

((PlanEstimate = null) AND (ScheduleState = "Defined"))

需要估算值的迭代中的用户情景

(((PlanEstimate = null) AND (ScheduleState = "Defined")) AND (Iteration != null))

带介于“已定义”和“已验收”排定状态值的用户情景

((ScheduleState > "Defined") AND (ScheduleState "Accepted"))

没有缺陷的用户情景

(Defects.ObjectID = null)

带缺陷的用户情景

(Defects.ObjectID != null)

回顾注释

针对此查询,对迭代对象使用“注释”字段以存储回顾反馈。如果只显示“注释”列,应用程序则会展开以显示所有富文本内容。确保在应用程序设置中选择将迭代作为对象。

(Notes != null)

将顺序设为“降序”并将页面大小设为 1,以仅显示最近迭代的注释。

当前迭代中的我的任务

此查询使用“today”语法以仅在当前活动迭代中显示工作。

(((Owner.UserName = "[email protected]") AND (Iteration.StartDate = today)) AND (Iteration.EndDate >= today))

多个客户报告的独立缺陷

此示例使用名为“报告客户”的自定义字段。“要求”字段可用于标识某一缺陷可能与之关联的用户情景。

(((ReportingCustomers > 1) and (State "Closed")) and (Requirement = null))

与某一特定用户情景关联且所有者为 Bob 的未结缺陷

(((Owner.UserName = "[email protected]") and (State "Closed")) and (Requirement.Name = "Story 2"))

George 找到的未结缺陷

((SubmittedBy.UserName = "[email protected]") and (State != "Closed"))

特定于客户的未结缺陷

此示例使用名为“受影响客户”的自定义字段。

((AffectedCustomers contains "ShotzBrewery") AND (State != "Closed"))

没有标记的缺陷

(Tags.ObjectID = null)

有标记的缺陷

(Tags.ObjectID != null)

常用字段

有助您构建具体查询的部分字段如下。此处并未列出所有字段。

语法 说明
验收日期 工作项的排定状态更改为“已验收”的日期。
受阻 标识某一工作项是否已被标记为“受阻”。
说明 搜索“说明”字段的内容。您可以使用 contains 或 !contains 条件。
直接子项计数 与某一用户情景关联的直接子项(不包括孙子项或更深的级别)的数目。
迭代 在其中排定某一工作项的迭代。使用该字段时,您必须知道迭代 OID。
计划估算 工作项“计划估算”字段中显示的值。
发布 在其中排定某一工作项的版本。使用该字段时,您必须知道版本 OID。
排定状态 在迭代或版本中排定的某一工作项的状态。标准值为“已定义”、“进行中”、“已完成”和“已验收”。
状态 缺陷的状态。不得与“排定状态”字段相混淆。
任务估算总计 与某一工作项关联的任务的总估算小时数。
任务剩余总计 与某一工作项关联的任务的总剩余待做小时数。

常见问题

如果查询未返回您预期的数据,请查看以下建议。

正确的括号语法

在具有多个条件的查询中使用括号时必须仔细权衡。对于查询中的每个条件,都必须在字符串前添加一个 (。还必须以 )) 结束第一个字符串以外的每个条件。

不正确
((Name = "A") AND (Name = "B") AND (Name = "C"))

正确
(((Name = "A") AND (Name = "B")) AND (Name = "C"))

正确的字段名称语法

在查看“Web 服务 API 文档”时,请务必注意许多字段都是对象,其中包括子元素。例如,Tags 是 CA Agile Central 中的对象,但是包含用于查找 Name 的元素。

可能会返回不一致的结果
((Tags = "Blue") AND (Tags = "Green"))

正确的语法
((Tags.Name = "Blue") AND (Tags.Name = "Green"))

确保正确的字段名称位于运算符的左侧,而值或日期变量则位于运算符的右侧。例如,如 (AcceptedDate InProgressDate) 一类的查询无效,因为它在运算符两侧均包含字段名称。

区分大小写

请注意,必须使用正确的大小写查询字段值。例如,如果 CA Agile Central 中的用户名首字母大写为 [email protected],将不会运行格式为 (Owner.UserName = "[email protected]") 的查询。该值在查询中必须完全匹配。

不含指定文本的字段

对文本或字符串字段使用 !contains(而非 contain)条件时,看到的结果可能比预期更少。例如,以下查询将查找“注释”字段非空不含“blue”一词的工作项:

(Notes !contains "blue")

要查找包含除“blue”一词以外的文本带空字段的工作项,请按以下方式构建查询:

((Notes !contains "blue") OR (Notes = null))

项目设置

请确保应用程序设置菜单中的项目范围必须正确。查询将不会返回包含在项目之内而在选择范围之外的工作项。

用户权限

查询不会返回包含在项目之内而您无权查看的工作项。确保您在项目中具有要查询的权限

如何构建查询

了解“查询”字段格式语法的详细信息:

反馈

需要更多帮助? CA Agile Central 社区为您提供一站式自助和支持。要将反馈或支持请求提交到 CA Agile Central 支持、获取解答并与其他用户协作,请加入我们的 CA Agile Central 社区