ClearCase和ClearQuest集成使用指南.docx

1、ClearCase和ClearQuest集成使用指南ClearCase和ClearQuest集成使用指南北京握奇数据系统有限公司文件状态： 草稿 修改稿 正式发布文档密级：当前版本：部 门： 技术开发cc项目名称： 作 者：李金锁完成日期：审 核：日 期：2010-1-7审 批：日 期：版本历史版本日期作者说明0.12010-1-7李金锁目录1 ClearCase和ClearQuest的集成 42 集成过程 42.1 创建CQ Enabled Project 42.2 设置策略 62.3 关联活动 72.4 在ClearQuest界面执行ClearCase的一些操作 92.5 如何取消Proj

2、ect的CQ Enabled特性 101 ClearCase和ClearQuest的集成所谓ClearCase和ClearQuest的集成，就是指将ClearQuest中的变更请求(Change Request)关联到ClearCase中某元素（element）的某一版本(Version)上。一个变更请求可以被关联到一个或多个版本上，这些 版本被称为变更请求的变更集（Change Set）。一个版本可以被关联到一个或多个变更请求，这些变更请求被称作版本的请求集（Request Set）。 2 集成过程要实现UCM ClearCase与ClearQuest的集成，首先必须在ClearCase U

3、CM的环境里创建一个CQ Enabled Project，即一个激活了ClearQuest相应功能的工程（Project）。2.1 创建CQ Enabled Project 创建Project 的过程中，可以选择所创建的Project 是否与ClearQuest进行集成，这时，connection的下拉列表中会显示出之前在ClearQuest 端已经创建好的Connection的名称，从下拉列表里选中这个Connection，则User Database项会自动显示出与这个Connection 所对应的数据库名称。 如果是初次登陆ClearQuest数据库，会出现一个登陆窗口，要求你输入登录使

4、用的用户名和密码。 图1 创建CQ Enabled 工程 Project创建完成之后，修改Project的属性，指定其CQ Enabled。 在Project Explorer中，选中刚刚创建的Project，右键，选择属性（properties），在打开的属性页中选择ClearQuest页。此 时Project is CQ enabled复选框应该是出于未被选中状态。选中复选框，从下来列表中选择已经在ClearQuest建好的Connection 和User Database。确定，完成操作。图2 在工程属性中指定工程为CQ Enabled2.2 设置策略CC和CQ集成后，可对集成的一些参数

5、进行设置。在Project Explorer中，选中刚刚创建的Project，右键，选择”Policies”，可对参数进行设置，完成后点击“确定”.图3 设置集成参数第一个红色框选项为是否允许在ClearCase客户端提交ClearQuest记录。第二个红色框选项为是否在deliver完成后，自动完成ClearQuest记录的转换。例如Defect由Opened的状态变更为Resolved状态，Task由TaskDisposed状态变更为TaskFinished状态。2.3 关联活动 当开发人员加入项目后，创建好开发视图，在开发视图的环境下，创建新的文件，或者对文件进行检出检入操作时，需要选择

6、一个与这个文件的版本相关联的活动（activity）。图4指定活动（activity） 在设定相关联的activity的时候，有二种方式：在下拉列表中选择一个已有的defect或Task与之关联；或者使用browse查询一个满足一定 条件的记录。 选择已有的Defect或Task如果事先在ClearQuest客户端中已经创建了一些记录，那在activity的下拉列表中就会自动列出来这些记录。不过，哪些纪录会列在列表里也是有一定的限制条件的：1) 这些Defect或Task的所有人（owner）必须和ClearCase中作集成时登陆ClearQuest所使用的用户帐户是一致的，也就是说只有那些分

7、配给这个用户处理的Defect才能在备选的活动列表里出现。2) 只有处于Assigned、 Opened状态的defect或处于SolutionSubmitted、TaskDisposed状态的才会被列到activity的备用下拉列表中。 “Browse”方式选择Browse按钮，弹出Activity Entity Browser窗口。可以在这个窗口中选择新建查询建立一个新的Query，设定查询条件，选择满足需要的记录。设定好查询结果要显示的字段以及查询条件后，可以将这个查询保存（保存后的查询 也可以直接在ClearQuest客户端中被使用）。新创建的查询会列在Activity Entity

8、Browser的窗口中，选中这个查询，或者选择其他已经在ClearQuest中创建的查询，点击运行按钮，在查询结果中选择正确的记 录，作为与ClearCase中的文件版本相关联的活动（activity）。注意：我们使用此方式时，关联时也只可以选择Defect或Task的所有人（owner）与集成帐户一致的，且处于Submitted、Assigned、 Opened状态的defect记录或处于SolutionSubmitted、TaskDisposed状态的Task记录图 5 查询相关记录2.4 在ClearQuest界面执行ClearCase的一些操作实现了UCM ClearCase与Clea

9、rQuest的集成之后，不仅可以在ClearCase执行ClearQuest的一些操作，同时，也可以在ClearQuest端执行例如检入、查看历史信息等ClearCase的操作。在ClearCase Explorer中，当对一个文件进行加入源控制、检入、检出操作时，会使活动（activity）指向ClearQuest的某一个记录。其实，这种关 联建立之后，也把这个文件加入到了ClearQuest所对应的记录的变化集（change set）当中。在ClearQuest中通过查询得到和ClearCase中某个文件版本相关联的记录（defect或者其它类型的记录），打开他的变化集 （change s

10、et），会看到与之相关联的文件及其版本。右键点击这个文件，在弹出的菜单中可以进行ClearCase的一些相关操作。如图所示：图6 可以在ClearQuest中进行的ClearCase的操作2.5 如何取消Project的CQ Enabled特性如果一个Project 此时是CQ Enabled的，在Project Explorer中，选中这个工程（Project），右键，选择属性（properties），在打开的属性页中选择ClearQuest页。此 时Project is CQ enabled复选框应该是被选中的状态。想要取消这个工程（Project）的CQ Enabled 特性，只要去掉复选框的选中状态即可。确定之后，系统会提示取消的操作会涉及到多少个ClearQuest的记录。