基于 Rational ClearQuest API 的脚本开发技巧.doc

《基于 Rational ClearQuest API 的脚本开发技巧.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、基于RationalClearQuestAPI的脚本开发技巧本文主要介绍如何利用RationalClearQuestAPI从代码层次上实现RationalClearQuest的相关功能，并通过相关的例子帮助读者掌握基于RationalClearQuestAPI的脚本开发方式和技巧。RationalClearQuest简介RationalClearQuest是重要的变更管理工具，RationalClearQuest更能让客户根据自己的具体需求，灵活的设计变更管理流程。除此之外，RationalCle

2、arQuest还提供了一套编程接口，即RationalClearQuestAPI，让用户和开发人员可以根据需要通过编程来实现RationalClearQuest的相关功能，同时还可以通过编程来实现模式中Hook脚本的开发和定制，从而使整个RationalClearQuest产品的功能更加灵活和强大。本文就全面介绍了基于RationalClearQuestAPI的脚本开发技巧，以便读者了解如何通过编程来实现RationalClearQuest相关功能，以及如何实现模式中Hook脚本的开发和定制的过程

3、和注意事项。RationalClearQuestAPI简介在RationalClearQuest中有两个非常重要的概念，一个是模式库，一个是用户数据库，其中用户数据库需要与某个模式的某个版本相关联，如图１所示。模式存放在模式库中，用户的数据存放在用户数据库中。用户可以通过RationalClearQuest客户端访问模式库和用户数据库。RationalClearQuestAPI为用户和开发人员提供了一套可编程接口，从代码层面上实现RationalClearQuest的相关功能，访问和操作模式库及用

4、户数据库中的相应数据。图１　模式库与用户数据库的关系示意图一般来说，用户使用RationalClearQuest访问和操作数据库的过程，如图２所示，用户可以通过ClearQuest客户端，调用ClearQuestCore中的代码，而后ClearQuestCore通过ODBC建立与数据库之间的连接。而RationalClearQuestAPI可以在用户和ClearQuestCore之间建立起桥梁，用户通过API调用ClearQuestCore中的相应模块，进而通过ODBC访问数据库。图２用Clear

5、Quest访问数据库示意图RationalClearQuestAPI提供了基于VBScript和Perl脚本的两种接口，RationalClearQuestAPI的文档中也分别提供了关于两种接口的说明。对于Linux和Unix平台，我们可以调用基于Perl的API，对于Windows平台，我们可以调用基于VBScript或Perl的API。RationalClearQuestAPI有两种调用方式，分别是：1.在ClearQuesthook或脚本中调用2.在外部应用程序中调用通过对RationalC

6、learQuestAPI的调用，用户和开发人员将可以从代码层面上实现以下功能：1.登陆用户数据库或者模式库2.浏览，编辑或创建新的数据记录3.创建查询，运行已有的查询并且得到查询的结果4.生成图和报表5.浏览和更新用户、组、数据库信息RationalClearQuestAPI中对象及常量的命名规范在RationalClearQuestAPI中定义了很多对象和常量，为了便于区分，针对不同的编程语言，它们的定义遵循一定的命名规范。基于VBScript的RationalClearQuestAPI中对象及

7、常量的命名规范如表1所示：表1基于VBScript的RationalClearQuestAPI中对象及常量的命名规范前缀描述举例OAd对象的前缀OAdEntityOAdSessionAD常量的前缀AD_BUTTON_CLICKAD_ORACLE基于Perl的RationalClearQuestAPI中对象及常量的命名规范如表2所示：表2基于Perl的RationalClearQuestAPI中对象及常量的命名规范前缀描述举例CQ对象的前缀CQEntityCQSession$CQPerlExt::C

8、Q常量的前缀$CQPerlExt::CQ_BUTTON_CLICK$CQPerlExt::CQ_ORACLE另外，在RationalClearQuestAPI的命名规范中，英文复数的对象名通常指一组以单数对象名命名的对象，比如Schemas就是一个包含多个Schema对象的集合。还有，名称后包含Def三个字母的对象一般用于定义以其前缀命名的对象，比如EntityDef就定义和描述了Entity对象的结构。了解了这些，会帮助我们更好地阅读，理解和使用RationalClearQues