基于RationalClearQuestAPI的脚本开发技巧精讲.docVIP

基于 Rational ClearQuest API 的脚本开发技巧 本文主要介绍如何利用 Rational ClearQuest API 从代码层次上实现 Rational ClearQuest 的相关功能，并通过相关的例子帮助读者掌握基于 Rational ClearQuest API 的脚本开发方式和技巧。 Rational ClearQuest 简介 Rational ClearQuest 是重要的变更管理工具，Rational ClearQuest 更能让客户根据自己的具体需求，灵活的设计变更管理流程。除此之外，Rational ClearQuest 还提供了一套编程接口，即 Rational ClearQuest API，让用户和开发人员可以根据需要通过编程来实现 Rational ClearQuest 的相关功能，同时还可以通过编程来实现模式中 Hook 脚本的开发和定制，从而使整个 Rational ClearQuest 产品的功能更加灵活和强大。本文就全面介绍了基于 Rational ClearQuest API 的脚本开发技巧，以便读者了解如何通过编程来实现 Rational ClearQuest 相关功能，以及如何实现模式中 Hook 脚本的开发和定制的过程和注意事项。 Rational ClearQuest API 简介 在 Rational ClearQuest 中有两个非常重要的概念，一个是模式库，一个是用户数据库，其中用户数据库需要与某个模式的某个版本相关联，如图１所示。模式存放在模式库中，用户的数据存放在用户数据库中。用户可以通过 Rational ClearQuest 客户端访问模式库和用户数据库。Rational ClearQuest API 为用户和开发人员提供了一套可编程接口，从代码层面上实现 Rational ClearQuest 的相关功能，访问和操作模式库及用户数据库中的相应数据。 图１　模式库与用户数据库的关系示意图 一般来说，用户使用 Rational ClearQuest 访问和操作数据库的过程，如图２所示，用户可以通过 ClearQuest 客户端，调用 ClearQuest Core 中的代码，而后 ClearQuest Core 通过 ODBC 建立与数据库之间的连接。而 Rational ClearQuest API 可以在用户和 ClearQuest Core 之间建立起桥梁，用户通过 API 调用 ClearQuest Core 中的相应模块，进而通过 ODBC 访问数据库。 图２ 用 ClearQuest 访问数据库示意图 Rational ClearQuest API 提供了基于 VBScript 和 Perl 脚本的两种接口，Rational ClearQuest API 的文档中也分别提供了关于两种接口的说明。对于 Linux 和 Unix 平台，我们可以调用基于 Perl 的 API，对于 Windows 平台，我们可以调用基于 VBScript 或 Perl 的 API。 Rational ClearQuest API 有两种调用方式，分别是： 在 ClearQuest hook 或脚本中调用 在外部应用程序中调用 通过对 Rational ClearQuest API 的调用，用户和开发人员将可以从代码层面上实现以下功能： 登陆用户数据库或者模式库 浏览，编辑或创建新的数据记录 创建查询，运行已有的查询并且得到查询的结果 生成图和报表 浏览和更新用户、组、数据库信息 Rational ClearQuest API 中对象及常量的命名规范 在 Rational ClearQuest API 中定义了很多对象和常量，为了便于区分，针对不同的编程语言，它们的定义遵循一定的命名规范。 基于 VBScript 的 Rational ClearQuest API 中对象及常量的命名规范如表 1 所示： 表 1 基于 VBScript 的 Rational ClearQuest API 中对象及常量的命名规范前缀 描述 举例 OAd 对象的前缀 OAdEntityOAdSession AD常量的前缀 AD_BUTTON_CLICKAD_ORACLE  基于 Perl 的 Rational ClearQuest API 中对象及常量的命名规范如表 2 所示： 表 2 基于 Perl 的 Rational ClearQuest API 中对象及常量的命名规范前缀 描述 举例 CQ 对象的前缀 CQEntityCQSession $CQPerlExt::CQ 常量的前缀 $CQPerl