定制化开发 Rational Team Concert 的 Project Dashboard 报表物件

本文将介绍如何利用 Eclipse Business Information and Reporting Tools (BIRT) 开发 BIRT Report 来展示 Rational Team Concer

本文将介绍如何利用 Eclipse Business Information and Reporting Tools (BIRT) 开发 BIRT Report 来展示 Rational Team Concert 上工作项目 (Work Items) 的数据报表并将报表转换成报表物件 Micro Report 展示于 Rational Team Concert 的 Project Dashboard。 BIRT Report 开发人员可以透过将 Rational Team Concert 作为输入存储库以制作定制化报表来展示工作项目的数据,透过将此报表转化成 Micro Report ,此定制化报表将能成为 Rational Team Concert 的报表物件,并动态即时展示报表于 Rational Team Concert 的 Project Dashboard。你将看到以 Rational Team Concert 为数据来源的 Micro Report 开发实例。

本文纲要:

  • Rational Team Concert 的 Project dashboard 报表物件 Micro Report的介绍
  • 开发环境 : Micro Report 开发环境介绍
  • 开发过程 : 以 Rational Team Concert 为数据来源开发 Micro Report 以展示工作项目 (Work Items) 的数据报表
  • 实例演示 : 部署 Micro Report 于 Rational Team Concert 以及展示于 Project Dashboard
  • 参考资料

Rational Team Concert 的 Project dashboard 报表物件 Micro Report 的介绍

Rational Team Concert( 以下简称 RTC) 的 Project Dashboard 为展示项目状态及管理项目进度的平台,使用者可以依据需求部署小部件(Widget)于 Project Dashboard 来即时动态展示所关注的项目资讯及状态。其中报表小部件更是具有丰富的项目资讯,除了默认的报表小部件之外,使用者可以透过进行利用 Eclipse Business Information and Reporting Tools (BIRT) 开发定制化 BIRT Report 并将之转换成 Micro Report 而成为能部署于 Project Dashboard 的报表小部件,定制化的数据报表将能展示满足使用者需求的数据资讯。

开发环境 : Micro Report 开发环境介绍

RTC 服务器为 5.0.1 而 Eclipse Business Information and Reporting Tools (BIRT) 为 2.6.2。

开发过程 : 以 Rational Team Concert 为数据来源开发 Micro Report 以展示工作项目 (Work Items) 的数据报表

以下的例子,将会新增一个报表来展示 RTC 的当前项目區域的 Defect 资讯数据,并给予报表参数使得使用者可以设定查询条件来呈现所需的报表内容。

  1. 新建报表文档 : 首先开启 Eclipse,从文件 -> 新建 ->Report 来创建一个全新的 BIRT 报表文档,然后输入档名"Micro defect report.rptdesign",由于我们要开发 Micro Report 所以档名必须为"Micro 你的档名 .rptdesign",点击完成后即新增一个空白报表文档。
  2. 设定数据源 : 在 Data Explorer 的视图下右键点击 Data Sources->New Data Source,在出现的对话框上选择 Create from a data source type in the following list 然后在下方表单点选"Jazz 数据源"之后点击下一步按钮,在输入存储库栏位选择你的 RTC 服务器,在输入快照栏位选择 LIVE SNAPSHOT,在输入项目区域栏位选择你的项目区域,点击完成按钮之后即完成数据源设定。
  3. 设定数据集 : 在 Data Explorer 的视图下右键点击 Data Sources->New Data Sets,在 Data Source Selection 下选择步骤 2 所建立的 Data Source 后在 Data Set Name 输入你的命名后点击下一步按钮,在输入表名栏位选择 com.ibm.team.workitem.WorkItem,在选择列栏位选择以下栏位 : "id","internalState","summary","internalSeverity", "workItemType","projectArea.itemId" ,"projectArea.name","foundIn.name" 及"creationDate" ,在输入过滤器栏位输入下列语法 :projectArea.name='{Current Project Area}' AND internalState IN (State) ,然后点击完成按钮,以上设定如图 1 所示。此语法为将"projectArea.name"栏位的值设定为当前区域项目,而 internalState 栏位值将会等于在使用者创建新变数 State 的所有值,State 为建立报表参数而创建,步骤 4 将详述。

    图 1. 设定数据集

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
  4. 建立报表参数 : 在步骤 3 所建立的数据集右键点击 Edit,在 Edit Data Set 的视窗中点选 Parameters->New,在弹出的对话框中在 Name 栏位中输入步骤 3 的新变数 State,在 Linked To Report Parameter 栏位点击"{}"图示以新增报表参数。在新增参数的对话框里,在 Name 栏位输入 Defect Status,在 Display type 下拉选单选择 List Box,在 Selection list values 栏位选择 Static 后点击,New …按钮,在 Display Text 及 Value 中输入如图 2 的值,因此使用者在设定报表查询参数时不会看到原始数据例如 :com.ibm.team.workitem.defectWorkflow.state.s1,而是有意义的对应值如 : New,此值则根据每个使用者在项目区域对于 RTC 工作流程的设定而改变并非固定,完成设定后点击确定按钮。

    图 2. 设定报表参数

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
  5. 设定数据集的数据过滤 : 在步骤 3 所建立的数据集右键点击 Edit,在 Edit Data Set 的视窗中点选 Filters->New …,并根据图 3 设定一个数据过滤,此设定为"workItemType"等于 Defect,因此报表展示出来的工作项目(Work Items)将只会有 Defect 这种种类,点击确定完成数据过滤设定。

    图 3. 设定数据过滤

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
  6. 制作报表表格 : 在 Eclipse 的菜单点击 Insert->Table,设定栏位为 6 栏后点击确定按钮,在 Data Explorer 视图下展开在步骤 3 所建立的数据集即可看到该数据集的所有栏位并将所要展示在报表的栏位包括"id", "internalState", "internalSeverity", "summary", "foundIn.name"拉至表格的明细行,并更改标题行为此表格的每个栏位命名,再将标题行底色改为银色,并且删掉最左边第一栏以及调整每个栏位至适当大小,表格将会如图 4 所示。

    图 4. 报表表格

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
  7. 报表栏位对照 : 有些栏位展示的数据为数据库中的原始数据如本范例中的"internalState"及"internalSeverity",若直接在报表中展示将会无法理解,所以我们需要根据在该项目区域对于其值的设定进行栏位对照。点击在报表表格中的想设定栏位对照的栏位,在 Property Editor – Data 里的 Map 标签页点击 Add …按钮来创建新的栏位对照,举例来说当"internalState"的值等于 com.ibm .team.workitem.defectWorkflow.state.s1 时,在报表表格里要展示为 New,将会如图 5 所示。此值则根据每个使用者在项目区域对于 RTC 工作流程的设定而改变并非固定,根据上述方式对于"internalState"及"internalSeverity"进行报表栏位对照设定。

    图 5. 报表栏位对照

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
  8. Micro Report 用户界面调整 : 因为报表为展示在 Project Dashboard 上面的小部件,所以需要进行报表用户界面参数设定,例如对于栏位值过长的栏位"summary"进行换行设定,点击报表表格中的"summary " ,在 Property Editor – Data 里的 Properties 标签页点击 General 分页,在 Whitespace 栏位中选择 Auto,如图 6 所示。除了换行设定之外,对于整个报表版面进行设定使得版个报表的版面能够自动调整布局,点选报表页面空白处,在 Property Editor – Report 里的 Properties 点击 General 分页,在 Layout Preference 栏位点选 Auto Layout,如图 7 所示。

    图 6. 栏位换行设定

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件

    图 7. 报表布局设定

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件

实例演示 : 部署 Micro Report 于 Rational Team Concert 以及展示于 Project Dashboard

透过上述步骤进行 Micro Report 开发,将报表从 Eclipse 汇出后透过下列步骤即可部署于 Project Dashboard。

  1. 部署报表于项目区域 : 首先开启浏览器然后访问你的项目区域,点击 Report->Report Resource,然后点击 Create Resource 按钮, 点击 Browse 按钮后上传本地的 Micro Report,然后在 Project/Team Area 栏位下勾选 Shared,最后点选储存,如图 8 所示。

    图 8. 创建报表资源

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
  2. 部署报表于 Project Dashboard: 点击 Project Dashboards-> 点击当前项目区域,点选加号在当前的 Project Dashboard 新增一个分页,点选"Add Widget"后在 Select Category 下点选默认报表 Reports,例如点选 Blocking Work Items 报表,在所创建出来的小部件上点选菜单 ->Settings,在 Report 栏位选择 Micro defect report,如图 9 所示,在 Query 栏位点选 Select …按钮后选择你想看到的 Defect 状态,例如点选 Reopened, Verified 及 Resolved 点选 OK 完成查询条件设定,点选 OK 完成报表物小部件设定。图 10 及图 11 为 Micro Report 在 Project Dashboard 的展示。

    图 9. 选择所创建的 Micro Report

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件

    图 10. Micro Report 展示于 Project Dashboard( 设定 Defect 状态条件为 Reopened, Verified 及 Resolved)

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件

    图 11. Micro Report 展示于 Project Dashboard( 设定 Defect 状态条件为 Resolved)

    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件
    定制化开发 Rational Team Concert 的 Project Dashboard 报表物件

参考资源 (Resources)

未登录用户
全部评论0
到底啦