高级 Word 导出
Codebeamer 20.07 引入了新的高级文档导出功能,该功能支持模板开发人员借助 cbQL 查询来访问 Codebeamer 跟踪器数据。虽然现有模板可供继续使用,但新功能支持通过多个跟踪器创建复杂文档。
基本功能
现在,模板可以在参数部分中包含 cbQL 查询,而 cbQL 查询结果可以使用书签循环进行引用和迭代。为此,需执行以下操作:
1. 定义查询,如下面查询参数中所述。
2. 创建 loop_{queryName} 书签循环。
3. 在该循环中,引用查询执行所返回的项的属性作为合并字段:<<{queryName}.{attribute}>>
结果是列出 {queryName} 查询的所有最后所得项的 {attribute} 属性。
多个互相关查询
多个查询必须相互引用并在查询树中构建,这类似于可追溯性浏览器的多级筛选。
根据查询参数表定义查询后,即可嵌入书签循环。这些循环会遍历其他书签循环中的相关查询结果。为此,内部循环需要引用外部循环。具体操作如下:
1. 定义查询,例如将查询命名为 epic 和 userStory。
2. 创建一个书签循环来引用外部查询:loop_{outerQueryName}。例如,loop_epic。
3. 创建一个内部书签循环来同时引用内部查询和外部查询:loop_{outerQueryName}_{innerQueryName}。例如,loop_epic_userStory。
4. 按如下方式,引用内部查询所返回的项的属性作为合并字段:<<{outerQueryName}.{innerQueryName.{attribute}>>。例如,<<epic.userStory.id>>。
上下文相关模板
对于上下文相关的导出,模板还可以引用 UI 上被选定要进行导出的项,就像使用 cbQL 查询它们一样。
为此,需要创建查询,并将其设置为依存于名为 item 的特殊初始级别,如下面的示例所示:
<<query.epic.dependson>> = item
类似查询的结果可被引用如下:<<item.epic.id>>d
主要概念是将词语 item 用作初始级别,而非实际初始级别。
在模板参数中不需要“初始级别”表格,因此第一级别的“依存于”值必须将此级别引用为 item。
书签也应将此级别引用为 item。
必须从项详情页面开始导出。