Rational ClearQuest使用说明书(附录)

Rational ClearQuest使用说明书(附录)

六、附录

1．脚本片段

这里应该是大家很期待的部分了。CQ功能的强大，就体现在这里。这里我也只明白了一小部分，更多的功能，等待大家的挖掘。

代码并不是万能的，一些代码，只对使用客户端的用户有效，对用Web端提交错误的用户就不好使了。

 

首先来看一个标准的脚本片段：

 

1 Sub tjsj_DefaultValue(fieldname)

2  ' fieldname As String

3  ' record type name is Defect

4  ' field name is 提交时间

5    REM Set the initial value of the field here.  Example:

6    REM   SetFieldValue fieldname, 12345

 

7   SetFieldValue "提交时间", time

   

8 End Sub

上面是一个标准的CQ中使用的子函数。

灰颜色：表示系统自动生成的代码，不可修改。

暗绿色：表示注释。在CQ中，以“REM＋空格”或“’＋空格”开头的都表示是注释，注释内容不运行

黑色：表示手工填写的代码。

紫色：为了方便说明加上的序号。在代码中紫色序号是不存在的。

分析：第1行说明此为一个basic子过程，tjsj_DefaultValue是过程名。过程名前面的tjsj是“提交时间”字段的数据库列名，代表此函数是提交时间字段的脚本；后面的Defultvalue是字段列表中列的名称，也可以说是字段的属性。

第2－4行是自动给出的关于此过程的定义说明。

第5－6行是CQ中关于此字段属性的说明。有的说明中会有代码示例，可以参照代码示例进行脚本的编写。

第7行就是自己所编写的脚本。具体编程代码，可以参照VB的一些相关文档，或者是Rational关于编程方面的资料。

第8行表示过程结束。

 

除了在Field和Actions可以编写脚本外，在Record Scripts中也可以编写自己的函数，这部分我没有使用过，不知道应该如何使用。

如果有时间，可以看看Global Script中的脚本，对理解CQ中自动给出的一些功能会有更深的体会。

在Actions中编写代码后，千万不要忘记了在Behaviors中相应的地方设置为USE_HOOK，否则编写是不会有效果的。

 

下面的是一些常用的指令：

1．SetFieldValue fildname, value

这个恐怕是最常用的了。就是赋值函数。Filename就是字段名（中文使用””号括起来就可以了），value就是赋予此字段的值。

代码示例：取当前系统时间，赋予提交时间字段。

SetFieldValue "提交时间", time

2．GetFieldValue(fildname).GetValue() 

取fildname字段的值

GetFieldValue("模块").GetValue()代表把模块的值取出来。

代码示例：判断选择的模块名，给予不同的程序员修改（此代码只对使用CQ客户端的用户有效，对用Web提交缺陷的用户无效）

 

  Dim module

  Module = GetFieldValue("模块").GetValue()   ' 取模块内容

 

  Select case Module   ' 下面的内容按照实际情况修改

 

  case "模块1"

  SetFieldValue "负责人", "programmer1"

 

  case "模块2"

  SetFieldValue "负责人", " programmer2"

 

  case "模块3"

  SetFieldValue "负责人", " programmer3"

 

  End Select

 

3．Getsession，GetUserLoginName

获得登陆用户名

代码示例：把提交人设置为登陆的用户

DIM session

    DIM username

   

    set session = GetSession

    username = session.GetUserLoginName

    SetFieldValue "submmitter",username

4．GetActionType

获得状态名。

这里可能会有一些问题，因为状态命名方式为AD_Action。但是我在配置的时候，Action定义为中文，好像无法在代码中使用，所以这个部分只好放弃了。

我之所以用中文，是因为很多的时候，此程序都是不了解CQ的人在使用，如果使用过多的英文名，会让人看着发晕。所以只要可能，我都进行了相关的汉化。

1．  Call 过程

调用过程

可以在Record Scripts中编写自己的函数，之后在其他的地方调用此函数

2．补充说明

1．如果安装的是SQL正版软件，安装过程中，会有一个规则选项，在InstallationGuideClearQuest.pdf第30页中说明了规则的选择。其实，我记得这个按照缺省的选择就可以了，不用修改。

1．  Access数据库，应该是可以使用远端连接的，只要放在共享目录中就可以。

3．一定要选择正确的维护库，才可以进入相应的数据库。

4．创建维护库中，可以选择“Create sample database”，这个例子十分的好，里面有方方面面的设置，对于CQ设置来说，很有启发意义。

5．这里为了方便，举例的时候，使用的是TEST计划。实际使用中，应该配置一个缺省的计划，其他计划都从此计划中集成，这样每个使用的计划只要根据需要进行部分的修改就可以了。

6．用户和组，只能添加修改，不能删除，所以添加的时候，一定要小心谨慎。

7．计划修改完毕后，一定不要忘记了Upgrade Database。

8．计划和数据库可以不相关，也就是说，设计计划的时候可以不连接数据库。但是在使用计划的时候，就必须要连接数据库了。

9．最好修改admin的密码，或者干脆删除。设置其他用户为超级管理员。缺省的太简单了，很容易被别人使用破坏。

10．使用中，应该尽量用英文，因为一些地方对中文的支持不是很好。

11．CQ可以和其他Rational产品一起使用，而且其他产品使用的用户都是在CQ Designer中创建的。

12．CQ的帮助系统做的十分好，到处都有帮助按钮，如果遇到不清楚的地方，可以点击“帮助”按钮进行相关的查找。

13．在CQ安装目录中，有一个books目录，英文好的，里面的六个文档都可以看一下，可以更深刻的理解CQ的功能。

14．在每建立一个缺陷库的时候，测试人员不要忘记了在CQ客户端中使用admin建立各种查询和图表，很少有开发人员会去查看帮助文档自己建立查询。

15.使用SQL Server数据库，缺陷记录在800兆以上的时候，可能会出现问题。

16.我曾经碰到过使用的用户组损坏的情况，组内用户在客户端无法进行Action操作。这个时候，新建一个用户组，把原组人员挪到新的用户组就能用了。

17．建议：测试组人员由于是固定的，可以使用一个用户组，赋予所有的计划和数据库权限；每个项目组都单独建立一个用户组，组内用户只有本测试计划的权限，这样权限能清晰些。

18．其他的以后再补充。