使用 Report Launcher for ClearQuest

使用 Report Launcher for ClearQuest® 来管理和运行报告,这些报告是使用 BIRT 或 Crystal Reports 报告工具设计的,并存储在共享文件服务器上。授权的用户可以从 Report Launcher 导航窗口中选择报告,并在 Report Launcher 视图窗口中查看生成的数据。

部署 Report Launcher for ClearQuest 之后,将其用于通过 Report Launcher for ClearQuest Web 界面运行和查看报告。该界面的运作方式类似下载站点。左侧窗格提供导航以运行和查看报告。右侧窗格包含呈现所选报告的报告查看器。

表 1. Report Launcher for ClearQuest 用户任务和指示信息
任务 指示信息
启动 Report Launcher
在浏览器的地址栏中,用以下格式之一输入 Report Launcher URL:
https://server_host:<port>/cqreportlauncher/reports
http://server_host:<port>/cqreportlauncher/reports
其中
  • server_host 是安装了 Report Launcher for ClearQuest 服务器的机器的主机名和域。与您的管理员联系,获取关于 server_host 位置的信息。
  • port 是概要文件中定义的用于部署该应用程序的端口。缺省 ClearQuest 概要文件使用端口 12443。缺省 Websphere Application Server 概要文件使用端口 9443。

缺省情况下,显示 Report Launcher for ClearQuest Web 界面。 仅在启用客户机安全性且安全性规则要求认证时,才显示登录屏幕。

查找报告 在 Report Launcher 的左侧窗格中,单击文件夹名称,将目录向下钻取到报告列表。

对于包含深度嵌套的子目录的 Report Launcher 安装,您还可以直接浏览到特定路径,而不必向下钻取到目标子目录。例如,您可以输入类似如下的路径,以直接转至 Defect_Reports 文件夹中的报告:

http://server_host:<port>/cqreportlauncher/reports/Department1/Defect_Reports
运行报告 单击报告名称时,Report Launcher for ClearQuest 会在报告服务器上启动报告,并在右侧窗口中打开报告查看器。
保存、打印和导出报告 在 Report Launcher Web 界面中,使用用于创建报告的报告工具的报告查看器来显示报告。例如,使用 Business Intelligence and Reporting Tools (BIRT) 创建的报告会显示在 BIRT 报告查看器中。在报告查看器工具栏或菜单中,提供了可用于报告操作(例如保存、打印和导出)的功能。使用报告查看器运行时环境提供的参数来配置这些功能。要获取如何定制可用功能的示例,请参阅定制 BIRT 报告查看器
提供报告凭证 单击 Report Launcher for ClearQuest Web 界面中的设置凭证链接,以指定所存储并在启动报告时传递的凭证。保存用户凭证时,在页面的左上方显示用户的名称。使用清除凭证链接来除去所保存的凭证。
注: 要获取关于报告安全性的更多信息,请参阅关于 ClearQuest 报告安全性
查看静态内容 用户可以通过 Report Launcher Web 界面查看报告文件服务器上的静态内容。缺省情况下,支持 PDF 和 HTML 格式。您可以通过向 Report Launcher 配置文件 reportlauncher.properties 中的 reports.launcher.filereader.suffix 规范添加文件类型扩展名,提供查看其他文件格式的能力。 要获取关于更新此文件的信息,请参阅配置 Report Launcher for ClearQuest
使用 PDF 来创建报告快照 通过从 Report Launcher for ClearQuest Web 界面中的报告查看器导出报告并将其另存为 PDF 文件,可以创建报告快照。
  1. 使用 Report Launcher for ClearQuest 运行报告和查看报告。
  2. 在 Report Launcher for ClearQuest Web 界面的报告查看器窗口中,单击报告查看器工具栏中的“导出”选项。
  3. 单击报告查看器工具栏中的导出选项,将报告导出到 PDF。
  4. 单击保存,并将报告保存到可从 Report Launcher 界面查看的文件路径。
使用样本报告 ClearQuest 提供样本报告的集合,这些报告可以用于测试。
Windows
\Program Files\IBM\RationalSDLC\clearquest\reports\driver\plugins\com.ibm.rational.clearquest.report.samples_version.timestamp.jar
Linux 和 UNIX:
/opt/rational/clearquest/reports/driver/plugins/com.ibm.rational.clearquest.report.samples_version.timestamp.jar
  1. 创建 ReportSamples 目录。然后,将文件从报告样本归档抽取到此目录中。
  2. 要将报告样本发布到 Report Launcher,请将 ReportSamples 目录复制到 Report Launcher baseDirectory,或者更新 reportlauncher.properties 文件以包含样本目录。
  3. 要获取关于报告样本的信息,请参阅报告目录 .\Crystal\CrystalSamples.html.\BIRT\BIRTSamples.html 中的自述文件。
  4. 要运行样本报告,请配置存储库和数据库 7.0.0/SAMPL。 某些报告需要查询,并且这些查询必须已导入。所需查询与 /Queries 子目录中的样本绑定。 将查询导入到 ClearQuest 文件夹(名为 Public Queries/Report Queries)中。
注: 从 Report Launcher 启动 BIRT 和 Crystal Reports 时,只有一种报告类型可以访问“JNI”数据源。 要在同一服务器上运行 BIRT 和 Crystal Reports,请更新 BIRT 数据源以使用 ClearQuest Web 服务器连接。您可以使用 WordPad 来更新 BIRT 报告库 CQSamples.rptlibrary 中的数据源定义。将 :jdbc:cq:7.0.0/SAMPL 更改为:jdbc:cq:7.0.0/SAMPL@http://mycqserver:12080/TeamWeb/services/Team

反馈