项目组合项查询示例

自定义列表”和“项目组合看板”应用程序中提供的查询字段有助于您通过多个条件来筛选显示的数据。您可以在字段中输入 SQL 样式的查询来查找特定项目组合项或其关联的工作项。

查询字段

示例

名称中包含特定文本的项目组合项:

如果您使用各种命名约定来标识不同的项目组合项组,此示例将非常有用:

(Name contains "Technical Debt")

具有特定投资类别的项目组合项:

(InvestmentCategory = "Cost Savings")

具有特定自定义字段值的项目组合项:

(c_MyCustomField = "MyCustomValue")

创建自定义网格,显示附加到某个功能的所有叶情景:

((Feature.FormattedID = F3550) AND (DirectChildrenCount = 0))

未排定的功能:

(Release = null)

当前发布中的功能:

((Release.ReleaseStartDate = today) AND (Release.ReleaseDate >= today))

附加到当前发布中的功能的叶用户情景:

(((Feature.Release.ReleaseStartDate = today) AND (Feature.Release.ReleaseDate >= today)) AND (DirectChildrenCount = 0))

已为发布排定:

(Release.Name = "PSI 2013.Q1")

具有特定父项的项目组合项:

(Parent.Name = "Design new login page")

不含父项的项目组合项:

(Parent = null)

不含子级项目组合项或用户情景的项目组合项:

(DirectChildrenCount = "0")

注意:在 WSAPI 中查询项目组合项状态(如“已完成”状态),会导致错误。要基于项目组合项的状态来查看结果,可以使用“自定义列表”应用程序中的筛选字段。

状态不是“正在发现”或“已完成”的项目组合项:

((State.Name !="Discovering") AND (State.Name !="Done"))

状态介于“正在发现”和“已完成”的项目组合项:

在此示例中,项目组合项中的“状态”字段使用了有序的值来标识自定义状态。“正在发现”是第一个可用的状态,具有值 1。“已完成”是最终状态,其值为 4:

((State.OrderIndex > 1) AND (State.OrderIndex 4))

总完成百分比(按情景计数)小于或等于 50% 的项目组合项:

(PercentDoneByStoryCount = ".50")

标记中不含特定文本的项目组合项:

(Tags.Name !contains "Blue")

包含两种标记(Red 和 Blue)的项目组合项:

((Tags.Name = "Blue") AND (Tags.Name = "Red"))

包含三种标记(Red、Blue 和 Green)的项目组合项:

(((Tags.Name = "Blue") AND (Tags.Name = "Red")) AND (Tags.Name = "Green"))

Mike 或 Sally 所拥有的项目组合项:

((Owner.UserName = "[email protected]") OR (Owner.UserName = "[email protected]"))

实际开始日期在 2012 年 11 月 5 日之后的项目组合项:

(ActualStartDate > "2012-11-05")

计划开始日期晚于上周的项目组合项:

(PlannedStartDate > "lastweek")

(PlannedStartDate > "today - 7")

提示:使用以下日期变量和日期表达式:today、yesterday、tomorrow、lastweek、nextweek、lastmonth、nextmonth、lastquarter、nextquarter、lastyear、next year、today + 以及 today - . 有关示例和用法详细信息,请参阅“日期变量”。

具有计划日期但是并非所有关联的用户情景都已完成的项目组合项:

(((PlannedStartDate != null) AND (PlannedEndDate != null)) AND (PercentDoneByStoryCount = ".50"))

特定项目组合项下的所有子级情景:

设置自定义网格应用程序以查看用户情景,然后在查询中输入父项项目组合项的格式化 ID:

(PortfolioItem.FormattedID = "F123")

查询情景层次结构中的情景,这些情景汇总到分配给特定发布的叶项目组合项:

在此示例中,我们显示的自定义网格显示了未分配给迭代的叶情景,这些情景汇总到分配给版本 2014.Q2 的子级别 PI(功能)。

(((Feature.Release.Name = "2014.Q2") AND (Iteration.Name = null)) AND (DirectChildrenCount = 0))

筛选出不含状态的功能或已存档功能:

((Tags.Name = "RPM") AND (State.Name != null) AND (State.Name != "Archived"))

正在进行的项目组合项:

((PercentDoneByStoryCount > 0) AND (PercentDoneByStoryCount 1))

其中包括至少已接受一个情景的项目组合项。

((ActualStartDate != null) AND (ActualEndDate = null))

这包括有正在进行的情景但是尚未接受任何内容的项目组合项。

已完成的项目组合项:

((ActualStartDate != null) AND (ActualEndDate != null))

最近的项目组合项和正在进行的项目组合项:

(((ActualStartDate != null) AND (ActualEndDate = null)) OR ((ActualStartDate != null) AND (ActualEndDate = LastQuarter)))

常用字段

以下是部分有助于您构建特定查询的字段。此处并未列出所有字段。要查看某个字段是否可用,请查看“Web 服务 API 文档”。

语法 说明
已验收的叶情景计数 与状态为“已接受”的项目组合项关联的用户情景(不含子级)数。
实际开始日期 真正开始处理项目组合项的日期,在设置状态为“进行中”的第一个与项目组合项关联的最低级情景时生成。
说明 搜索“说明”字段的内容。您可以使用 contains 或 !contains 条件。
上次更新日期 编辑或创建项目组合项的最后日期,该日期也会在编辑关联的工作项时更新。
叶情景计数 与项目组合项关联的用户情景(不含子级)数。
父项 项目组合项层次结构中的上一级。使用此字段查找一组具有常见父项的项目组合项。
按情景计数已完成百分比 与状态为“已验收”的项目组合项关联的用户情景(不含子级)百分比。
按情景计划估算已完成百分比 与状态为“已验收”的项目组合项关联的用户情景(不含子级)计划估算百分比。
计划开始日期 开始处理该项目组合项的日期。
状态 项目组合项的看板状态。请不要与关联用户情景的“排定状态”字段混淆。

常见问题

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

类型设置

应用程序设置中的“类型”字段可控制要显示的项目组合项的级别。如果您的查询未返回任何结果,则可能会看到错误的项目组合层次结构级别。

“自定义网格”应用程序 项目组合看板应用程序
自定义网格 项目组合看板

正确的括号语法

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

不正确
((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"))

此外,请注意您的工作区中的“自定义字段”以“c_”开头。对于名为“Color”的自定义字段:

不正确
(Color = "Blue")

正确
(c_Color = "Blue")

区分大小写

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

项目设置

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

用户权限

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

如何构建查询

了解有关”查询“字段中的格式语法的更多信息。

反馈

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