我们用Polarion做项目汇报、评审材料，或者搞审计资料的时候，这个报告模板不能只当成是“弄出一个好看的文件”，其实真正有用的报告模板，需要大家把需求、测试、缺陷，还有变更、评审、追溯关系这些数据，都按照固定的口径给整理出来，在Polarion里面有一个LiveReport功能，大家可以用它来做自定义的仪表盘和报告，里面的小组件也就是Widget，主要是用来把Polarion的数据按照不一样的格式给展示出来的。

　　一、Polarion报告模板怎么制作

　　我们在做报告模板之前，得先搞清楚这个报告是用来干嘛的，如果是给项目经理看的报告，我们就要把重点放在进度、风险和没关闭的问题上面；如果是给评审人员看的报告，那重点就是需求的状态、评审的意见，还有变更的记录；如果是用来审计的报告，重点就变成了追溯链、状态的历史，还有验证的证据了。

　　1、确定报告范围和数据对象

　　我们先要明确这个报告里面到底要包含哪些东西，像【需求】、【测试用例】、【测试执行结果】、【缺陷】、【变更请求】、【评审意见】这些，大家千万别在一开始的时候把所有数据都塞进一个报告里面，不然的话这个模板就会变得特别重，后面我们维护起来也会觉得很麻烦。

　　2、创建LiveReport页面并添加Widget

　　我们可以在项目空间里面去新建一个LiveReport页面，新建完了就进入到编辑模式，在里面添加一些表格、图表、查询结果，还有文本说明、追溯矩阵这些组件，而且Polarion后面的版本也提升了LiveReport页面的内容复用能力，我们可以把一个页面或者页面的片段直接放到别的报告里面用，这样就能少做一些重复维护的事情。

　　3、配置查询条件和字段列

　　我们的报告数据都是从查询条件里面弄出来的，像需求报告就可以把当前版本下的Requirement筛选出来，缺陷报告就去筛选那些没关闭的Defect，测试报告就去筛选某一个Test Plan下面的执行结果，这些查询条件大家不能只写在标题里面，必须得真正配置到小组件或者报告的数据源里才行。

　　二、Polarion报告导出后字段缺失怎么办

　　大家在报告页面上能看到这些字段，但是这并不代表导出来以后也一定是完整的，要是导出来发现字段没有了，我们得先判断一下，到底是模板里面没有配置，还是查询的时候没取到，或者是字段的值本来就是空的，甚至有可能是因为权限和导出的格式不对导致的。

　　1、检查模板字段是否配置进去

　　我们最常遇到的问题就是网页上明明显示了一些字段，可是导出的模板里面却没有把这些字段的列给加进去，比如我们在LiveReport的表格里能看到严重级别和验证方式，但是Word或者Excel的模板里只配了ID、标题和状态，那导出来以后肯定就看不到别的字段了。

　　2、检查字段是否有值

　　有时候有些字段并不是在导出的时候弄丢了，而是这个工作项本身就没填内容，比如我们的需求里面没有写验证方式，或者缺陷里面没有填修复的版本，那导出来看起来就是一片空白，Polarion的REST API也写了，字段只有在具体的数据上面有不是空的值时才会返回，像那些空字符串、false的布尔值，还有null对象引用这些，可能根本就不会出现在响应里面。

　　3、检查权限和导出用户

　　我们在导出报告的时候，系统通常都是按照当前操作的用户的权限去读取数据的，要是用户在页面上本来就看不到某些字段、文档或者工作项，那导出来的时候也一样会缺掉，Polarion挺强调通过细粒度的权限来控制大家能看什么、能改什么的，这种权限的控制会直接影响到数据的展示和大家协作的范围。

　　三、报告模板怎么维护才稳定

　　我们的报告模板做好了以后，可不能就这么丢在那不管了，因为项目的字段、状态、版本、流程还有权限一旦变了，报告就很容易出现字段漏了、统计错了或者导出报错的情况，一个稳定的报告模板，必须得跟着项目的配置一起去维护才行。

　　1、统一字段口径

　　报告里的每一个字段都必须有特别明确的意思，比如说“关闭缺陷”到底算不算那些被拒绝的Rejected状态，“需求覆盖率”是只要关联了测试用例就行，还是说必须要测试执行通过才算，还有“变更完成”指的是Implemented还是Verified，要是大家的口径不统一，报告上的数字就很容易被别人看错。

　　2、字段变更后同步改模板

　　要是项目里面加了新字段、删了旧字段，或者改了枚举值、调了状态流，我们都得同步去检查一下报告模板，比如以前那个字段叫targetVersion，后来大家把它换成了fixVersion，如果我们的模板里面还在取以前的那个旧字段，那导出来肯定就会缺值了。

　　3、用样例数据做导出验证

　　我们每次去调整完报告模板以后，最好都准备那么几条样例数据来测试一下导出，这些样例数据最好能把正常的需求、已经关闭的缺陷、失败的测试用例、已经批准的变更，还有带着自定义字段的工作项都包含进去，这样我们就能提前发现字段是空的、列错位了、枚举显示不正常，或者追溯关系没导出来之类的问题。

　　总结

　　我们要想做好Polarion的报告模板，关键就是得先确定报告是干嘛用的、数据范围有哪些，然后再靠着LiveReport、Widget、查询条件和字段列把内容给凑起来，要是报告导出来发现缺了字段，我们就从模板字段、字段ID、字段值、查询范围、用户权限，还有导出的格式这几个方面去排查，等模板做完了，我们还要跟着项目的字段、状态、权限和版本的变化去不断地维护它，把这些事情都处理好以后，Polarion报告模板怎么制作、Polarion报告导出后字段缺失怎么办这两个让人头疼的问题，才不会在每一次交付和评审之前反反复复地出现了。