Rational ClearQuest手册1

概述
开始本教程之前，请确认已经读过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。
第一部分：运行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并且将其关联至新的your-username_schema schema。
创建一个新的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。
•状态和错误信息显示在位于窗口底部的验证面板内。
现在你已经测试过自定义的your-username_schema。接下来的练习你将应用schema变化。
应用schema变化
定制一个schema并测试后，你可以将schema检入到schema储存库中。然后，利用Upgrade Database向导，你可以使用新版本的schema来升级相关联的数据库。
检入一个Schema
上一练习中，选择File > Test Work时自动保存了schema并对其验证，执行该操作测试了你的工作。现在你该准备重新将your-username_schema检入schema储存库。
1.选择File > Check In。
ClearQuest Designer验证schema，在ClearQuest Designer窗口底部的确认面板显示发现的错误信息。如果有错误发生，你可以通过右键点击该错误信息并选择What‘s This? 来得到关于该错误的详细描述。
2.当验证脚本结束后，ClearQuest Designer显示注释文本框。默认情况下，ClearQuest显示检出时你输入的注释。单击OK。一个新版本的schema被创建并检入。
注释：在重新检入一个schema回schema储存库前，你应该始终通过选择File > Test Work来测试你的工作。这样做可以使你的测试数据库与最新的schema版本保持一致。检入一个schema前如果没有测试你的工作，那么你必须创建一个新的测试数据库。
接下来的练习，你将使用新版本的your-username_schema schema来升级用户数据库。
升级用户数据库
课程1中，你创建了一个名为my_db的用户数据库并将其关联至your-username_schema schema。从那以后，你检出了这个schema，对其进行了重新定制，然后将其重新检入回schema储存库。
在这一课中，你将使用最新版本的your-username_schema来升级用户数据库，my_db，以便你的ClearQuest客户端用户应用这些变化。
1.选择Database > Upgrade Database。ClearQuest显示一个消息框，提示你在升级前备份schema储存库和关联的数据库。在这些课程中，你所使用的是一个示例数据库，可以不必备份数据库而继续。单击Yes。
2.从Database列表中选择my_db 并单击Next。
3.从Versions列表中选择2并单击Finish。系统提示数据库已被成功升级。
注释：升级用户数据库时因该注意，所有的ClearQuest客户端用户必须退出用户数据库。
4.单击OK关闭升级成功消息框。
课程3中，你将学习如何管理用户及用户组。
第3课：管理用户及用户组
课程中，你将创建用户和组账号，分配访问权限并升级用户数据库信息。
添加一个新用户
作为ClearQuest管理员，负责确定哪些用户可以访问数据库。当创建一个新的用户帐号时，应该为该用户分配权限并决定该用户可以访问哪些数据库。从ClearQuest Designer中创建新的用户帐号。
用户管理与和你的schemas是相互独立的，因此你不用检出一个schema来添加新用户。
在这个练习中，你将为系统增加新用户 Jane Smith并定义这个用户可以访问的数据库。
1.在ClearQuest Designer中，选择Tools > User Administration ，打开User Administrator对话窗口。
2.单击User Action并单击Add user，打开Add User对话窗口。
3.在Login， Password， 和Confirm Password 字段输入jsmith。
4.在Name 字段输入Jane Smith。
5.在Email 字段输入电子邮件地址。
6.在Subscribe中，选择SAMPL 和 my_db。
订阅一个用户到一个数据库可以告诉ClearQuest该用户可以访问哪个数据库。接下来，你需要使用新的用户信息来升级那些数据库。
7.在User Administrator对话窗口，单击DB Action并单击Upgrade。确定只选中了SAMPL 和 my_db；单击OK。
8.单击OK关闭报告两个数据库被成功升级的消息框。
9.单击OK关闭User Administration对话窗口。
为了试验新的账户，打开ClearQuest以jsmith为用户名及口令登入 SAMPL数据库。
注释：当详细说明用户信息时，你可以输入用户描述及电话号码。如果系统支持电子邮件通知，ClearQuest使用用户描述信息为设定的注册ID号确定正确的邮件地址。
接下来的练习中，你将编辑用户帐号jsmith的属性。
编辑用户属性
你可以在任何时候编辑用户属性。可以变更用户名称，登录名，口令，电话，电子邮件，描述和访问权限。也可以改变用户订阅的数据库。
在这个练习中，将取消用户Jane Smith访问my_db 数据库的权限。
1.在ClearQuest Designer中，选择Tools > User Administration，打开User Administrator对话窗口。
2.单击DB Action 并单击Unsubscribe ，打开Unsubscribe对话窗口。
3.从 Select users and groups框中选择用户Jane Smith。
4.从 Select databases框中选择Select databases选项。
5.确认SAMPL数据库被选中。
清除my_db数据库选项，单击OK，关闭Unsubscribe对话窗口
6.单击DB Action 并单击Upgrade，选择my_db 数据库升级，然后单击OK。
7.在User Administrator对话窗口单击OK。
为了验证Jane Smith没有访问my_db 数据库的权限，打开ClearQuest，使用jsmith登录。ClearQuest将只允许你选择SAMPL数据库登录。
接下来的练习中，你将学习如何在数据库中增加用户组，如何使用用户组来控制访问schema中的操作。
添加用户组
用户组提供了另外一种控制访问数据库的途径。在这个练习中，你将学习如何创建用户组并向组中添加用户：
1.在ClearQuest Designer中，选择Tools > User Administration ，打开User Administrator对话窗口。
2.单击Group Action ，单击Add Group ，打开Group Property对话窗口。
在Membership框左侧的Users选项内，可以看到包括jsmith在内的系统用户列表。此时，Users列表上的Groups列表内多半还没有组。
3.在Name字段内输入组名Managers。
4.选择用户jsmith，单击Add（或将用户拖放至组）将用户jsmith添加到Managers组。
5.再添加1到2个用户到Managers组。选中组中的用户名称，单击Remove可将用户从组中移出。双击用户组可以列出该组的成员。
6.在Subscribe（订阅）框内，选择All existing or future databases。
如果选择的是Select databases，你应该选中所有的数据库来允许Managers组用户进行访问。
单击OK关闭Group Property对话窗口。
在User Administration对话窗口，Groups网格内出现Managers组。双击用户组可以列出该组的成员。
7.单击DB Action，单击Upgrade，使用新的组信息来升级数据库，然后单击OK。
8.单击OK关闭报告数据库升级成功的消息框。
9.单击OK再次关闭User Administrator对话窗口。
注释：在schema中，你可以限定只允许特定的用户组来访问一个操作。例如，你可能只想让质量保证组（quality assurance group）使用确认操作（Validate action）。在操作网格内，单击确认操作的Access Control栏并选择User Groups。
你已经完成了ClearQuest Designer指南的所有课程。