Polarion项目仪表板一般通过LiveReport Page和Widget组合展示项目进度、需求状态、缺陷数量、测试执行情况等数据。仪表板页面本身只是展示载体，真正决定组件显示结果的是查询范围、筛选条件、页面参数和当前用户权限。遇到Work Item已经修改，仪表板里的数字或列表却没变化时，可以先检查组件到底在查哪些数据，再判断是页面配置没有更新，还是当前账号读取不到对应对象。

　　一、Polarion怎么配置项目仪表板

　　Polarion的项目首页和普通LiveReport Page都可以配置Widget。页面进入编辑状态后，可以把多个组件放到同一页面，再分别给每个组件设置数据范围和显示条件。

　　1、在LiveReport Page中添加组件

　　①进入目标Polarion项目，打开准备作为仪表板使用的【LiveReport Page】。

　　②点击页面上的【Edit】进入编辑状态。

　　③打开页面侧边栏中的【Widgets】。

　　④从组件列表中找到要使用的Widget。

　　⑤把Widget拖到页面对应位置。

　　⑥选中刚添加的Widget，打开右侧【Parameters】。

　　⑦填写组件标题，并检查当前数据来源。

　　⑧重复添加其他Widget，把需求、缺陷、测试和计划数据分开放置。

　　⑨调整组件位置和页面布局后执行【Save】。

　　例如需求仪表板可以分别放置状态统计、Work Item列表和趋势图，不用把所有数据塞进同一个Widget。

　　2、设置Widget的数据范围和查询条件

　　①进入页面【Edit】状态。

　　②选中需要配置的Widget。

　　③打开【Parameters】。

　　④找到【Data Set】或当前Widget提供的数据设置区域。

　　⑤在【Scope】中选择当前【Project】或指定项目。

　　⑥在【Filter】中设置Work Item查询条件。

　　⑦需要只统计需求时，把类型条件限制为对应Requirement类型。

　　⑧只查看某些状态时，再加入【Status】条件。

　　⑨有排序需求时设置【Sort By】。

　　⑩保存页面并退出编辑状态，检查组件中的数量和列表。

　　Widget类型不同，参数名称会有些差异，但数据范围和查询条件都要和当前项目对应。复制其他项目的页面时，这两项尤其要重新检查。

　　3、使用Page Parameters统一控制多个Widget

　　多个Widget需要使用同一个版本、状态或严重等级条件时，可以通过页面参数统一传值。

　　①进入LiveReport Page的【Edit】状态。

　　②打开【Page Parameters】。

　　③创建当前页面需要的参数。

　　④设置参数ID和默认值。

　　⑤选中一个Widget并进入【Parameters】。

　　⑥把Widget中的对应查询条件改为引用页面参数。

　　⑦其他Widget也使用相同参数时，逐个完成绑定。

　　⑧保存页面。

　　⑨切换页面参数值，检查多个Widget的数据是否一起变化。

　　这种方式适合做版本、状态、负责人等统一筛选，后续修改查询条件时不用逐个Widget重复调整。

　　二、Polarion仪表板组件数据不更新如何检查

　　Work Item已经改变，组件仍显示旧结果时，可以把组件查询复制到Work Item查询界面做一次对照。如果查询本身就找不到新数据，问题在筛选范围；查询有结果而Widget没有变化，再回头看页面参数和组件配置。

　　1、检查Widget的Scope和Filter

　　①进入仪表板【Edit】状态。

　　②选中数据没有更新的Widget。

　　③打开【Parameters】。

　　④检查【Scope】是否仍指向当前项目。

　　⑤查看【Filter】里的Work Item类型。

　　⑥核对【Status】【Assignee】【Priority】等查询条件。

　　⑦复制当前查询条件。

　　⑧进入Work Item查询页面执行同样条件。

　　⑨对比查询数量和Widget中的显示数量。

　　如果从另一个项目复制过仪表板，很容易留下原项目Scope或固定Project条件，看起来像Widget没有刷新，实际是在查另一批数据。

　　2、检查Page Parameters是不是还保留旧值

　　①打开当前LiveReport Page。

　　②进入【Edit】。

　　③打开【Page Parameters】。

　　④查看Widget正在引用的参数。

　　⑤检查参数默认值。

　　⑥确认版本、状态、时间范围等参数没有停留在旧条件。

　　⑦修改参数后保存页面。

　　⑧退出编辑状态并重新加载页面。

　　⑨再次查看Widget结果。

　　例如Work Item状态已经从Open改为Closed，而页面参数仍固定筛选Open，组件数量自然不会包含已经关闭的条目。

　　3、检查当前用户的数据读取权限

　　同一个仪表板管理员能看到数据，普通用户却看不到或数量少一部分，可以直接查权限差异。

　　①使用出现问题的账号打开仪表板。

　　②记录异常Widget中的数据数量。

　　③进入Work Item页面运行相同查询。

　　④查看目标Work Item能否被当前账号读取。

　　⑤再使用具备项目管理权限的测试账号执行相同查询。

　　⑥两个账号结果不一致时，进入【Administration】→【User Management】→【Permissions Management】。

　　⑦检查目标角色对项目和Work Item的【READ】权限。

　　⑧修正权限后重新登录，再查看仪表板。

　　Polarion查询结果会受到当前用户访问权限限制，所以同一个Widget在不同账号下显示不同数量并不一定是组件故障。

　　三、配置没有问题但数据仍不变化怎么继续排查

　　内置Widget和自定义Script Widget的数据来源并不完全一样。普通组件可以继续检查页面保存状态和查询条件，自定义组件还要确认REST请求、账号权限以及组件本身有没有正常执行。

　　1、确认页面已经保存并重新加载

　　①进入【Edit】检查刚修改的Widget参数。

　　②确认页面已经执行【Save】。

　　③退出编辑状态。

　　④重新加载当前LiveReport Page。

　　⑤再次查看目标组件。

　　⑥新建或修改一条符合查询条件的测试Work Item。

　　⑦保存Work Item后重新加载仪表板。

　　⑧检查组件数量是否发生变化。

　　如果同一个查询在Work Item页面已经能找到新对象，而重新加载LiveReport后仍没有显示，再继续检查Widget自身的数据配置。

　　2、自定义Widget检查REST和脚本权限

　　①确认问题组件是不是【Script】或自定义Widget。

　　②打开组件【Parameters】和脚本设置。

　　③检查REST请求使用的项目ID和查询条件。

　　④确认当前账号具备对应项目的REST【GET】权限。

　　⑤查看目标Work Item本身的读取权限。

　　⑥组件使用会话REST Token时，重新登录后测试一次。

　　⑦检查浏览器开发工具中的请求结果。

　　⑧出现403时处理权限，返回数据为空时检查查询和项目范围。

　　近期Polarion版本对REST访问和项目数据读取的权限控制更细，自定义仪表板升级版本后出现数据变化，也可以从这里检查。

　　总结

　　Polarion仪表板组件的数据来源和当前页面配置是绑在一起的，项目范围、查询条件、页面参数或用户权限有一处没有对应上，都可能让组件显示的内容和Work Item实际数据产生差异。项目仪表板配置完成后，可以保留几条固定测试查询作为对照，后续页面调整或版本升级时更容易判断数据是否正常。如需进一步了解Polarion项目仪表板配置、LiveReport Widget设置与组件数据异常排查方法，欢迎联系咨询。