ALM软件：Polarion二次开发_（7）.Polarion报告和仪表板定制.docx

PAGE1

PAGE1

Polarion报告和仪表板定制

在Polarion中，报告和仪表板是重要的工具，用于展示项目的状态、进度、质量和风险等关键信息。通过定制报告和仪表板，您可以根据项目的需求和团队的偏好，创建更加符合要求的可视化工具。本节将详细介绍如何在Polarion中定制报告和仪表板，包括数据源的配置、报告模板的设计、仪表板组件的选择和布局等。

报告定制

1.数据源配置

在Polarion中，报告的数据源可以是Polarion数据库中的工作项、变更请求、测试用例等。配置数据源是报告定制的第一步，确保报告能够获取到所需的数据。

1.1配置工作项数据源

工作项数据源是最常用的数据源之一，可以通过以下步骤进行配置：

打开报告编辑器：

在Polarion中，导航到“报告”模块。

选择要编辑的报告或创建一个新的报告。

点击“编辑报告”按钮进入报告编辑器。

选择数据源：

在报告编辑器中，点击“数据源”选项卡。

选择“工作项”作为数据源。

点击“添加数据源”按钮，选择项目和工作项类型。

配置查询条件：

在数据源配置页面中，可以设置查询条件来筛选特定的工作项。

例如，您可以设置查询条件来获取所有状态为“已关闭”的工作项：

query

projectid=your_project_id/

workItemTypeid=workitem_type_id/

filter

statusvalue=closed/

/filter

/query

1.2配置变更请求数据源

变更请求数据源用于展示与变更管理相关的信息。配置步骤与工作项数据源类似：

选择数据源：

在报告编辑器中，点击“数据源”选项卡。

选择“变更请求”作为数据源。

点击“添加数据源”按钮，选择项目和变更请求类型。

配置查询条件：

在数据源配置页面中，设置查询条件来筛选特定的变更请求。

例如，获取所有状态为“已批准”的变更请求：

query

projectid=your_project_id/

changeRequestTypeid=change_request_type_id/

filter

statusvalue=approved/

/filter

/query

1.3配置测试用例数据源

测试用例数据源用于展示与测试管理相关的信息。配置步骤与工作项数据源类似：

选择数据源：

在报告编辑器中，点击“数据源”选项卡。

选择“测试用例”作为数据源。

点击“添加数据源”按钮，选择项目和测试用例类型。

配置查询条件：

在数据源配置页面中，设置查询条件来筛选特定的测试用例。

例如，获取所有优先级为“高”的测试用例：

query

projectid=your_project_id/

testCaseTypeid=test_case_type_id/

filter

priorityvalue=high/

/filter

/query

报告模板设计

2.1创建报告模板

Polarion支持创建自定义报告模板，以便生成符合项目需求的报告。报告模板可以使用Polarion提供的HTML和Velocity模板语言。

打开模板编辑器：

在Polarion中，导航到“报告模板”模块。

点击“创建新模板”按钮。

设计报告结构：

使用HTML设计报告的基本结构。

例如，创建一个简单的表格报告：

html

head

title工作项报告/title

/head

body

h1工作项报告/h1

tableborder=1

thead

tr

thID/th

th标题/th

th状态/th

th负责人/th

/tr

/thead

tbody

#foreach($workItemin$workItems)

tr

td$workItem.id/td

td$workItem.title/td

td$workItem.status/td

td$workItem.assignee/td

/tr

#end

/tbody

/table

/body

/html

2.2使用Velocity宏

Velocity宏是Polarion报告模