ClearQuest教程▼

大唐盛世

概述
开始本教程之前，请确认已经读过Rational ClearQuest的介绍。
在这个教程中，你将学习如何使用ClearQuest Designer和ClearQuest client开始执行基本的ClearQuest管理任务。完成本教程后，你就可以开始为用户自定义ClearQuest client。
该教程有两部分，每部分都包括三节课程：
•第一部分的第1，2和第3课，介绍ClearQuest Designe，你将学习如何创建一个schema和user database，自定义schema并且对user database应用你的定制。你将创建users和user groups。
•第二部分的第4，5和第6课，介绍ClearQuest Client，你将学习如何创建公共查询和图表，创建从ClearQuest数据中得到的报告，配置ClearQuest e-mail。

[ 本帖最后由 luming 于 2008-12-30 13:23 编辑 ]

大唐盛世

第一部分：运行ClearQuest Designer
ClearQuest Designer是一种为ClearQuest client定制行为和用户界面的工具。这部分提供三节课程来介绍如何使用ClearQuest Designer。
•课程1，将学习如何登录到ClearQuest Designer并且创建一个新的schema和databases。
•课程2，将学习如何定义一个schema。
•课程3，将学习如何管理users 和user groups，创建new users，将他们添加到groups，使用user信息更新database。


创建Schemas 和 Databases
本课中，将学习如何做以下的事情：
•登录到ClearQuest Designer
•创建一个新的schema
•创建一个新的user database并且关联至相应的schema
•创建一个测试database
登录到ClearQuest Designer
在这个练习中，你将登录到ClearQuest Designer。
1.从开始菜单中选择ClearQuest Designer。
2.在ClearQuest登录对话窗口中，User Name输入admin，Password为空。
3.单击OK。
4.出现Open Schema对话窗口，单击Cancel。
一般情况下，你可以通过Open Schema对话窗口打开准备使用的schema，但在接下来的练习中，你将创建一个新的schema。
接下来是什么？
在接下来的练习中，你将创建一个新的schema。
创建一个新的schema
一个ClearQuest schema包含元数据that defines the process for working with records within the ClearQuest client.
利用ClearQuest Designer，可以以一个已经存在的schema为模版创建一个新的schema。所有的schema都被保存在schema储存库中。
在这个练习中，你将创建一个以TestStudio schema为模版的新的schema。如果TestStudio schema不能使用，请选择Common schema来代替。
1.选择File > New Schema打开一个新的Schema对话窗口。
2.从schema列表中选择TestStudio, version 1，单击Next。
3.在Schema Name栏中输入your-username_schema。
4.在Comment文本框中输入Tutorial schema，单击Finish。
5.出现if you want to create a database to associate with your new schema时，单击No。在下一个练习中你将创建database。
6.出现if you want to check out the schema for editing，单击No。

大唐盛世

创建一个新的User Database
The user database is the database ClearQuest client users use to work with change request records.
user database是ClearQuest client用户使用的变更请求记录数据库。
在这个练习中，你将创建一个新的user database并且将其关联至上一个练习中创建的your-username_schema schema。
1.选择Database > New Database打开一个新的Database对话窗口。
2.按照下列要求完成新的Database对话窗口：
a.在Logical Database Name中输入my_db。
逻辑数据库的名字字符长度在1-5之间。
b.在Comment字符框中，输入This database uses the tutorial schema, your-username_schema。
c.单击Next。
3.从Vendor choice列表中选择MS_ACCESS。
在Physical Database Name 中输入c:\my_db 作为数据库的完整路径名称。路径中指定的目录必须存在。例如，如果你指定了c:\temp\my_db，那么temp目录必须存在。
如果数据库不存在，则ClearQuest会在指定的目录中创建。
4.选择Test Database选项，单击Next。
5.在Timeout (240 minutes) 和Poll Interval (1 minute)中接受默认值，单击Next。
6.在schema列表中选择your-username_schema, version 1，单击Finish。
7.出现数据库创建成功提示消息窗口时，单击OK。
ClearQuest Designer创建my_db数据库并且使用your-username_schema schema进行初始化。

大唐盛世

创建一个测试数据库
在接下来的练习中，你将创建一个测试用户数据库，该数据库将在后面的定制your-username_schema schema教程中用到。通过使用测试数据库，你可以了解how your schema customizations perform in the ClearQuest client without affecting your user database.
1.选择Database > New Database 打开一个新的Database对话窗口。
2.在Logical Database Name 中输入test。 (逻辑数据库的名字字符长度在1-5之间。)在Comment文本框中输入This is the test database for the tutorial schema, your-username_schema。单击Next。
3.从Vendor 列表中选择MS_ACCESS。
在Physical Database Name 中为数据库输入完整路径名称。例如c:\test。路径中指定的目录必须存在。例如，如果你指定了c:\temp\my_db，那么temp目录必须存在。
如果数据库不存在，则ClearQuest会在指定的目录中创建。
选择Test Database选项单击Next。
4.在Timeout和Poll Interval中接受默认值，单击Next。
5.在schema列表中选择your-username_schema, version 1，单击Finish。
6.出现数据库创建成功提示消息窗口时，单击OK。
ClearQuest Designer创建了test database并且用your-username_schema schema进行初始化。
注释：你应该只是用test databases作为临时数据库来验证你的schema的变更。不能将重要的数据放至test database。

大唐盛世

定制一个Schema

在该课程中，你将学习如何做以下的事情：
•添加一个新的field
•定义状态转换
•测试并保存schema的变更
•对用户数据库应用schema的变更

添加一个新的field
注释：如果使用的是TeamTest版本的ClearQuest，你不能在schema中增加一个field。你只能自定义已经存在的fields。
在接下来的练习中，你将完成以下操作：
1.检出一个schema。
ClearQuest在schema储存库中存储着已有schemas的所有版本，你必须从schema储存库中检出schema的最新的版本。
2.创建field。
在ClearQuest中，你可以对一个已有的或新的schema增加、删除或者修改fields。
3.为field增加一个hook（分支代码）。
Hooks are entry points for pieces of code that execute automatically at specified times (triggers), that extend ClearQuest functionality.
分支代码是在指定时间（触发器）自动执行的代码部分的进入点，它扩展了ClearQuest的功能。
4.在记录窗体中增加field。
ClearQuest通过使用窗体来联系一个记录类型并显示相关信息。ClearQuest也允许用户使用窗体来提交新的相应的记录。


检出一个schema
ClearQuest在schema储存库中存储着已有schemas的所有版本，为了更改一个schema，你必须从schema储存库中检出schema的最后的版本。
在这个练习中，你将检出your-username_schema。该课程的所有练习都将使用这个被检出的schema。
1.在ClearQuest Designer中，选择File > Open Schema 打开Open Schema窗体。
2.选择Checkout a schema to edit。
注释：在Open Schema窗体中如果选择了View a version of an existing schema ，你将不能修改这个schema。
3.选择your-username_schema, version 1 ，单击Next。
4.在备注中输入Adding defect record field to the record form and a new state and action。
5.单击Finish。
ClearQuest Designer窗口左侧显示your-username_schema的工作区间。请注意你所工作的your-username_schema的版本号为版本2。当你打开一个schema进行编辑时，ClearQuest Designer为这个schema自动创建一个新版本。

增加一个新的Field
注释：如果使用的是TeamTest版本的ClearQuest并且没有一个完整的ClearQuest许可证，你就不能在schema中增加一个field。你只能自定义已经存在的fields就像增加一个field分支代码。
在这个练习中，你将编辑your-username_schema schema，通过创建一个新的field，允许用户在缺陷记录中输入用户编号。
1.在工作区，展开Record Types > Defect 并且双击Fields 显示Fields网格。
Fields网格显示了记录中的所有fields。每个field列显示其属性，包括field名称，类型，缺省值，权限，有效性等等。
2.选择Edit > Add Field，打开Field Properties对话窗口，选择General标签，在Field Name中输入User_number。在Type中选择INT，因为该字段包含整数。
缺省的数据类型是SHORT_STRING。
DB Column Name的默认值与field名称相同。
作为默认选项，选择项Visible in query 已被选择。
3.In the Help Text tab, as Enter your user number type a number between 1 and 100. 在Help Text标签项，as Enter your user number type a number between 1 and 100。
该字段必须为1-100之间的整数。当用户在ClearQuest客户端通过快捷菜单使用帮助时将看到该帮助信息。
4.关闭Field Properties对话窗口。
请注意，这时类型为I NT 的User_number field显示在Fields网格中的底部。

创建一个Field分支代码
注释：如果使用的是TeamTest版本的ClearQuest并且没有一个完整的ClearQuest许可证，你就不能在schema中增加一个field。你只能自定义已经存在的fields。
你可以编辑functionality of fields，操作和为记录指定的分支代码。当ClearQuest客户端用户执行了一个操作或一个field中输入了一个值，ClearQuest运行指定的分支程序代码。
在这个练习中，你将为上一练习中生成的User_number field添加一个validation hook，这个分支代码用来验证User_number field的值。
1.展开Record Types > Defect项，双击Fields。
2.在Fields网格中，点击User_number field 中的Validation单元格，然后点击下拉箭头。
选择SCRIPTS > BASIC 打开脚本编辑器。脚本编辑器以灰色输出行的形式提供一个Visual Basic脚本框架。
脚本编辑器的顶部，Fields选项显示User_number，并且Hook Types选项显示FIELD_VALIDATION。如果显示的不是这些，通过滚动选中这些选项。
3.Copy下面的示例代码并粘贴到脚本编辑器中注释行的下面：


REM End If
Dim value_info
Set value_info=GetFieldValue(fieldname)
If Not IsNumeric(value_info.GetValue) Then
User_number_Validation=”Must be an integer between 1 and 100”
ElseIf (value_info.Getvalue<1) or (value_info.Getvalue>100) Then
User_number_Validation=”Must be between 1 and 100”
End If
这个例子中，当用户在field中输入一个数字，ClearQuest客户端运行相应的验证分支代码。
如果验证分支代码返回一个非空字符串，用户将被提示该field中包含无效值。
4.选择Hooks > Compile。编译脚本并检测确定没有语法错误。如果没有错误，在Script Errors 框中将会显示No error(s) found 。
5.关闭脚本编辑器。
注释：分支代码能够影响field的状态，因此在发布它们之前，你必须慎重的计划并测试这些代码。例如，ClearQuest设置未初始化的整数为0。练习中添加的分支代码检测这个field的值，如果发现小于1或大于100，则返回错误信息。这就使得User_number field成为强制性的field，因为0不能通过有效性检测。
然而，如果你看User_number field的属性（展开 Record Types > Defect > States and Actions 并双击Behaviors），该field被定义为可选field。因此，这个验证分支代码实际上改变了这个field的属性。

大唐盛世

在记录窗体中添加field
注释：如果使用的是TeamTest版本的ClearQuest并且没有一个完整的ClearQuest许可证，你就不能在schema中增加一个field。你只能自定义已经存在的fields。
现在，你刚才创建的User_number field对用户而言是不可见的，因为它没有出现在任何窗体中。在这个练习中，你将在提交窗体中添加User_number field，从而使用户可以在提交缺陷报告时确定他们的用户编号。
1.工作区内，展开Record Types > Defect > Forms 并双击Defect_Base_Submit。
打开Defect_Base_Submit窗体的同时，Field List和Controls Pallet同时也被打开。
2.如果需要的话，最大化ClearQuest Designer窗口，拉伸Defect_Base_Submit窗口以便在窗口的底部可以添加一个新的field。
3.在Field List内，滚动并找到User_number field。单击User_number (单击名称而不是图标)并拖动至Defect_Base_Submit窗体的底部。
Field名称和一个文本框出现在窗体中。ClearQuest为field自动选择一个Text Box控件。
4.双击text box显示属性表。浏览控件提供的标签和控制功能，然后单击OK 关闭属性表。
5.工作区内，右键点击Defect_Base_Submit。确定Submit Form项在快捷菜单中已被选中。如果该项目没有被选中，单击并添加该选项。
6.关闭Defect_Base_Submit窗口。
注释：
•ClearQuest使用窗体与记录类型进行联系，并使用该窗体显示相应记录类型的详细信息。
•每一个记录类型可以包含一个或多个窗体：记录窗体和提交窗体。提交窗体不是必须的，但是每一个schema必须包含一个记录窗体。

大唐盛世

添加状态和操作以及定义状态转变
ClearQuest中，记录要经过操作来从一个状态转变为另一个状态。状态转换矩阵跟踪了一个记录的生命周期。
接下来的练习中，你将创建一个新的状态，新的操作并且定义一个状态转换。
ClearQuest Designer状态转移矩阵确保用户按照ClearQuest管理员定义的矩阵来传递记录。

大唐盛世

添加一个新的状态
ClearQuest中，记录从一个状态转换为另一个是由于ClearQuest客户端用户执行了操作。例如，使用your-username_schema schema ，ClearQuest客户端用户点击New Defect 向数据库中提交一个记录。这时该记录为提交状态，从这个状态，用户可以选择Actions > Assign 来为一名工程师分配变更需求。
一个记录的可用状态和状态转换操作在ClearQuest Designer状态转换矩阵中显示。
在这个练习中，你将为your-username_schema schema增加一个叫做Reassigned 的新的状态。该状态允许用户将缺陷重新指派给其他人。
1.在工作区内，展开Record Types > Defect > States and Actions并双击State Transition Matrix。
状态转换矩阵内，列值为源状态，行值为目的状态。交叉单元格内是将记录从源状态转换到目的状态的操作。
2.选择Edit > Add State 显示Add State对话窗口。
3.在Name field输入Reassigned ，单击OK。
Reassigned状态在状态转换矩阵中的行和列同时出现。

大唐盛世

添加一个新操作
ClearQuest使用操作来编辑及转换记录状态。这个练习中，将添加名为Reassign的操作，该操作允许用户将上一练习中生成的记录转换为Reassigned状态。
1.工作区内，展开Record Types > Defect > States and Actions ，双击Actions打开Actions网格。
2.选择Edit > Add Action显示Defect Action对话窗口。
3.选择General标签，在Action Name内输入Reassign 。ClearQuest将操作类型缺省设置为CHANGE_STATE。
4.关闭Defect Action对话窗口。
Reassign操作在操作网格的底部出现。

大唐盛世

定义一个状态转换
前面的练习中，所创建的Reassign操作类型是CHANGE_STATE。只有类型为SUBMIT， CHANGE_STATE，或者 DUPLICATE 的操作才可以开始状态转换。其他类型的操作不能影响记录状态。
在这个练习中，你将为Reassign操作通过指定源状态及目的状态来定义一个状态转换。其结果将是，ClearQuest客户端用户能够通过选择Actions > Reassign ，将所有记录为Opened和Resolved的状态转换为Reassigned状态。
1.展开Record Types > Defect > States and Actions 双击Actions。
2.右键点击行标签Reassign，选择Action Properties ，出现Action Properties对话窗口。
3.在State标签内，选择Opened 和 Resolved 作为源状态。选择Reassigned作为目的状态。
4.关闭Action Properties对话窗口，应用该状态转换。
5.双击工作区内的State Transition Matrix ，检查ClearQuest是否应用了Reassigned状态的转换。
状态转换矩阵显示无论是从Opened还是Resolved状态，Reassign操作将转换记录为Reassigned状态。
6.一旦记录处于Reassigned状态，用户应当能够打开记录。为了达到该目的，双击工作区内的Actions打开Actions网格。右键单击Open操作并选择Action Properties。
在状态标签内，选择Reassigned作为源状态，Opened作为目的状态。
7.关闭对话窗口。
重新观察状态转换矩阵，可以看到Open操作可以将记录从Reassigned状态转换为Opened状态。

大唐盛世

接下来的练习中，你将从ClearQuest客户端测试先前的工作，看your-username_schema是否象定制好的那样工作。
检查你的设置
在检入schema并使得这些变化对于用户可以使用之前，你需要测试并确认schema的变化。在这个练习中，你将使用在Lesson 1中创建的测试数据库来检查基于your-username_schema schema所作的工作。这是在前进中检测你的工作的捷径；你可以在ClearQuest客户端很安全的测试schema中最近的大部分的变化，这样做并不会影响到你的my_db用户数据库。
首先，设定你的测试数据库
1.在ClearQuest Designer中，选择 Database > Set Test Database。
2.在Test Database对话窗口内，选择先前创建的测试数据库test。
3.用户名输入admin，口令为空。单击OK.。
当你使用ClearQuest客户端测试你的schema时，ClearQuest使用这些信息进行登录。

大唐盛世

现在，测试你的schema
1.在ClearQuest Designer中，选择File > Test Work。
ClearQuest Designer保存schema并对其确认，在ClearQuest Designer窗口底部的确认面板显示发现的错误信息。如果有错误发生，你可以通过右键点击该错误信息并选择What's This? 来得到关于该错误的详细描述。
ClearQuest客户端被自动打开，因此你可以测试在your-username_schema中已经作的工作。
1.在ClearQuest客户端，单击New Defect来提交一个缺陷记录。在记录窗体的底部可以看到名为User_number的新的field.
2.在User_number field内，输入101来测试你的验证分支代码。单击OK。弹出消息框These fields have invalid values: User_number.
3.右键单击User_number field并选择Error Message 来显示引起错误的原因。此时，系统显示Must be between 1 and 100。
记录提交后，你还不能测试新的Reassigned状态，因为还没有任何查询允许你检索记录。接下来，你将学习如何在ClearQuest客户端创建公共查询。
4.退出ClearQuest客户端。
注释：
•当你检入schema之前的任何时候，都可以通过选择File > Save Work来保存工作。（这个选项只有当你还没有执行File > Test Work时是可用的。）在常规基础上保存工作是一个好的方法，从ClearQuest Designer注销后，当重新登录时可以继续执行你的工作。
•可以通过选择File > Validate在任何时候来验证你的schema。
•状态和错误信息显示在位于窗口底部的验证面板内。

jajavava

我还不知道ClearQuest是干什么用的， 等俺先去查查

songfun

no pdf??

fucc

谢谢了，我正在学，所以非常需要

sally313

好，我正需要呢。谢谢了。

sally313

Originally posted by sally313 at 2005-7-29 11:11:
好，我正需要呢。谢谢了。

我是一个初学者，希望大家多多指点。

hxf

好东西呀！我以前用过，但是，也没有仔细的总结一下，现在，有了这么好的帖子，要好好保留下来呀！谢谢了。

johnjinwei

辛苦了。不容易啊！

yfrain1978

郁闷，我完成按帮助提示配置了，但没有成功...