当前页面: 开发资料首页 → Eclipse 专题 → 了解IBM Rational ClearQuest Client for Eclipse

了解IBM Rational ClearQuest Client for Eclipse

摘要: IBM Rational ClearQuest是一个缺陷和变更追踪系统，组织和自动化处理与提交、分配、追踪、测试和发布变更请求相关的过程。Eclipse是一个可扩展的平台，其为工具集成提供了一个媒介。ClearQuest的Eclipse插件使你能够在Eclipse环境中执行ClearQuest活动。虽然你可能已经非常熟悉Rational ClearQuest和/或Eclipse了，但本文主要是帮助你更好地了解ClearQuest Client for Eclipse，以连接这两种工具。

前言

Rational ClearQuest是一个缺陷和变更追踪系统，可以让你提交一个变更请求，跟踪与变更请求相对应的文件变化，并管理变更请求。有几种不同的Rational ClearQuest客户端：Windows客户端，Web客户端，等等。Rational ClearQuest Client for Eclipse可以让你在Eclipse环境中执行ClearQuest任务（活动）。本文重点突出Rational ClearQuest Client for Eclipse的一些重要特性，以及在Rational ClearQuest Client for Eclipse中执行ClearQuest任务的方式。提示和工具条可以提供有关一些Eclipse特性的信息，并比较Eclipse客户端和本地客户端之间的差异。你可以下载Rational ClearQuest Client for Eclipse的eGA版本，
http://www-1.ibm.com/support/docview.wss?rs=0&q1=rational+2003.06.13&uid=swg24007802&loc=en_US&cs=utf-8&cc=us&lang=en。

Rational ClearQuest 透视图

一旦你下载并安装了Rational ClearQuest Client for Eclipse，你在Eclipse环境中要做的第一件事情就是打开ClearQuest透视图。ClearQuest透视图包含一组Eclipse视图，执行不同的Rational ClearQuest操作（如图1）。要打开Rational ClearQuest透视图，请从主菜单栏中选择Window > Open Perspective > Other > ClearQuest。

ClearQuest透视图包括以下视图（Views）：

ClearQuest Navigator 视图
ClearQuest Query Results 视图
ClearQuest Record Details 视图
Console 视图
Tasks and Problems 视图

透视图和视图

Eclipse视图用于呈现领域对象。视图支持编辑器，并提供可选择的表现方式及方法，在你的Eclipse环境中浏览信息。举例来说，Eclipse Navigator视图显示你正在工作的项目和其它资源。视图有其自己的菜单和工具栏组。由菜单项和工具栏按钮表示的操作（Actions）只会影响视图中的条目。

透视图定义了Eclipse工作空间中的视图的初始集和布局。你可以通过打开和关闭视图，将他们放在Eclipse窗口中的不同位置，来改变一个透视图的布局。要打开一个没有包括在当前透视图中的视图，从主菜单条中选择Window > Show View你可以使用Window > Customize Perspective菜单项定制透视图。要保存定制完成的透视图，使用Window > Save Perspective As...菜单项。

</td></tr></table> </td></tr></table>

ClearQuest Navigator 视图

ClearQuest Navigator视图显示查询、图表、报表和报表格式（图2）。Navigator视图类似于Windows客户端中的Workspace视图。你可以创建、修改、重命名、删除和执行查询、报表和图表。

ClearQuest Navigator视图与Rational ClearQuest本地客户端中的Workspace视图对比

查看workspace对象而不编辑它。你可以简单地展开查询节点来查看过滤器（Filters）和显示一个查询的字段。
编辑一个workspace对象的组件可以直接在Navigator视图中执行。删除显示字段可以通过删除Navigator视图中相应的显示字段节点来完成。
自动产生workspace对象名可以使你在相同的位置创建workspace对象的多个复制。你可以复制一个文件夹下的一个查询，并将它粘贴在相同的文件夹下。复制的查询将会被指派一个自动产生的名字"Copy of {query name}"。

</td></tr></table> </td></tr></table>

ClearQuest Query Results 视图

查询的结果显示在ClearQuest Query Results视图中（图3）。结果用树表格式来显示。你可以从父记录浏览到一个关联的子记录。例如，你可以展开一个缺陷（Defect）节点来查看附件（Attachments）、历史（History）信息和复制（Duplicates）（）。你可以直接在查询结果中显示的记录上执行操作（）。选择多个记录可以让你对这些记录执行批操作。

ClearQuest Record Details 视图

你可以使用ClearQuest Record Details视图（图4）查看一个记录的详细情况。窗口是完全按照ClearQuest schema定义中的显示。你可以在视图中显示的记录上执行操作。

Console 视图

Console视图是Eclipse视图的一部分，Rational ClearQuest使用Console视图来显示成功和故障消息（图5）。你可以通过使用Rational ClearQuest的preference设置来过滤在console视图中显示的消息。

Tasks 和 Problems 视图

Tasks视图是Eclipse视图的一部分，用来显示任务（图6）。如果你正在Eclipse环境中进行Java开发，展现在你的代码中的TODO和FIXME任务会被自动地增加到tasks视图。增加的任务由Window > Preferences > Java > Task Tags选项来管理。你也可以使用Add Task工具栏按钮创建一个新任务，并将一个任务与一个资源关联起来。

Problems视图是Eclipse视图的一部分，用来显示在Eclipse环境中所开发代码的编译错误（图6）。 integration section提供了有关Rational ClearQuest Client for Eclipse如何与不同的Eclipse视图集成的更多信息。

Rational ClearQuest 任务

既然我们已经介绍了不同的Rational ClearQuest Eclipse视图和它们各自的功能，我们将看一下如何使用Eclipse客户端来执行不同的Rational ClearQuest活动。Rational ClearQuest任务部分被分成两小部分：基本Rational ClearQuest任务和高级Rational ClearQuest任务。Basic部分集中于执行Rational ClearQuest任务的核心集。Advanced部分讨论不同的Eclipse增强，目标是改进你的工作流。如果你想进行基于场景的任务，你可以从典型用户场景部分开始。

基本 Rational ClearQuest 任务

在基本活动部分，我们将着眼于使用Rational ClearQuest Client for Eclipse执行你的一些日常活动的方法。这将会帮助你在执行熟悉的ClearQuest活动时习惯于Eclipse环境。这部分从登录到一个Rational ClearQuest数据库连接开始，进行到不同的查询操作（创建一个新查询，编辑一个查询，等等），延伸到不同记录（缺陷，UCM活动，等等），并包括退出数据库连接。

连接到一个Rational ClearQuest数据库

连接（登录）到一个数据库，要使用Login Wizard（图7）。Login Wizard安排了登录到一个数据库连接的过程。激活Login Wizard可以从ClearQuest Navigator视图（），Eclipse主工具栏（）或ClearQuest菜单（）中进行。

点击登录工具栏项上的下拉菜单，查看登录菜单。选择Login来打开Login Wizard（图8）。从Schema Repository页中选择schema repository（）。Schema Repository组合框显示了所有可用的schema repositories。

在Additional Login Information页（图9）中输入userID（）。点击Finish来完成向导。

在Authentication对话框（图10）中输入密码（）。Remember the password (）选项可以让你为以后的登录保存密码。如果你选择Remember the password复选框来记住密码，密码就会被加密并保存下来。保存的密码可在后续的登录中用于登录到数据库（）。

一旦你成功登录，你将会注意到ClearQuest Navigator视图和ClearQuest Query Results视图的变化。如图11所示，一个新的CearQuest页签（被增加到ClearQuest Navigator视图中。连接信息（显示在ClearQuest Navigator视图中。你也可以展开连接信息节点，来查看public和personal查询。ClearQuest Query Results视图的标题（）也被改变以反映最新成功登录的连接信息。使用Login Wizard创建的连接可为以后一直使用。后续连接部分提供了有关你如何使用永久性连接信息来登录到数据库中的更多信息。

ClearQuest Navigator视图可以显示来自多个数据库连接的工作空间信息。多连接部分提供了有关多个登录以及多个连接的工作空间信息如何显示给用户的更多详细内容。

Rational ClearQuest Client for Eclipse中的Login Wizard与Windows客户端中的Login对话框对比

密码可以被存储起来用于后续的登录。你可以使用authentication对话框中的Remember the password复选框来存储一个特定数据库连接的密码。这使得你可以不用输入任何信息就可以登录到一个数据库（参见后续连接）。
连接信息是由用户名和schema信息（例如，user1, ratlc@raleigh）组成的。最后五对连接信息在本地存储。

</td></tr></table> </td></tr></table>

查询（Queries）

如图11所示，最新成功登录位置的连接信息显示在Rational ClearQuest Navigator视图中的最高层节点上，personal和public查询文件夹被表示为子节点。你可能已经注意到ClearQuest Navigator视图除了查询信息外，还显示查询的结构。你可以通过点击与查询名相连的加号来展开查询，来查看查询的过滤器和显示字段信息。你可以重新命名、删除，并拖拽过滤器和显示字段。在本节中，我们将会看到不同的查询操作：

创建一个新查询
编辑一个已有查询
保存一个查询
删除或重命名一个查询
查看一个查询的SQL版本
在启动时执行一个查询
执行一个查询

创建一个新查询

要创建一个新的查询，请打开Query Wizard（图12）。在ClearQuest Navigator视图中选择一个你想要创建查询的文件夹。使用上下文菜单（右键点击一个文件夹可以查看上下文菜单）。选择New Query（）来激活Query Wizard。你也可以从New Query（）工具栏项中激活Query Wizard。

在Query Name and Record Type页中选择记录类型和查询名。Query Name字段（）会预先使用一个唯一的查询名。Next按钮是不能点击的，如果你不选择一个Record Type（）或者如果你提供了一个无效的查询名的话。

向导的下一页取决于你是否选择Create Query from an existing query（）复选框。如果你希望从一个已有查询创建查询，选中Create Query from an existing query复选框，并点击Next按钮。你也可以使用Start with an existing query向导页（图14）来选择你的新查询想要基于的一个已有查询。

在下一页，你要选择查询过滤器（图15）。一个记录类型的有效过滤器字段显示在 Select fields to use as query filters页（）的左边。你可以通过双击出现的过滤器来增加一个过滤器。你可以使用Group上下文菜单操作（）来将增加到右边的过滤器分组。上下文菜单也允许你删除（过滤器和组，并修改"And" 和 "Or"之间的分组（）。你可以通过选中Set as Default Filters复选框，来将当前配置设置为缺省过滤器。通过设置这个，每个为此记录类型创建的新查询都会有这些过滤器的初始设置。

如果你没有在前一个页面选中一个过滤器的话，Define Query Filters向导页面就不会显示出来。你可以使用Define Query Filters向导页来定义过滤器值（图16，）。过滤器值一直会持续到你在Define Query Filter向导页面中更改选择。

在Define Display Fields向导页面中选择显示字段。通过拖拽字段（或双击字段可以增加显示字段。你可以更改标题（），排序类型（），排序次序（，并通过点击合适的表单元来展示一个显示字段的信息（）。运行新创建的查询，要在Define Display Fields向导页面中选择run复选框（）。你可以通过选中Set as Default Display Fields复选框，来将当前配置设置为缺省显示字段。通过设置这个，每个为此记录类型创建的新查询都会有这些显示字段的初始设置。

创建的新查询将被选中，并显示在ClearQuest Navigator视图中（图18）。查询用一个*（星号）来标示（），来指出该查询需要被创建或保存在数据库中。被包含在一个查询中的过滤器（和显示字段（也会显示在ClearQuest Navigator视图中。

你也可以从ClearQuest主工具栏或ClearQuest菜单创建查询。选择New -> -> New Query..。此查询向导的第一个页面只有很少区别（图）。为了使用此向导创建一个查询，你需要指定此查询将要被创建的位置（）。

Rational ClearQuest Client for Eclipse中的New Query Wizard与Windows客户端中的New Query Wizard对比

Record Type显示在向导的第一个页面。在本地Rational ClearQuest客户端中，用户选择记录类型，并继续在向导中选择过滤器和显示字段。这种方法不允许用户在选择完查询以后更改查询的记录类型。记录类型显示在Eclipse客户端中查询向导的第一个页面。通过允许用户选择记录类型作为向导的一部分，Rational ClearQuest Client for Eclipse可以让你更改记录类型，即使已经选择了相对于一个不同记录类型的过滤器和显示字段。
查询名预先使用一个唯一的名字。
基于另一个查询创建一个查询。Start with an existing Query向导页面只有当用户在第一个页面中选择Create query from an existing query 复选框时才会显示出来。
过滤器页面在显示字段页面之前显示。当创建一个新查询时，用户通常要在选择记录如何显示之前决定哪些记录要显示。因此，显示字段向导页面是在过滤器选择页面之后显示。这也与一个SQL语句联合起来，在SQL语句中，“Select”子句（显示字段）显示在“Where”子句（过滤器）之后。
Define Filter页面只有在使用过滤器向导页面选择过滤器时才会出现。这将会加快返回一个特定记录类型所有记录查询的创建过程。
查询不会自动存储到服务器上。与本地客户端不同，新创建的查询不会自动在服务器上创建。查询上会增加一个星号（*）符号，以指示查询还没有保存在数据库中。此特性允许用户创建临时查询，而不保存到服务器上。

</td></tr></table> </td></tr></table>

编辑一个已有查询

既然我们已经创建了一个新查询，我们将编辑一个已有查询。你可以使用Edit Query向导来编辑一个查询（图19）。为了激活Edit Query向导，高亮显示查询，并从上下文菜单中选择Edit（）。

Edit Query向导允许用户来编辑查询的结构。Edit Query向导显示Select fields to use as query filters 页面，Define query filters 页面，以及Define Display Fields向导页面。一个查询上的 * 符号标示查询的修改需要保存到Rational ClearQuest数据库中。ClearQuest Navigator 视图显示了查询结构，例如包含在查询下的过滤器和显示字段显示在ClearQuest Navigator视图中。如果你只想编辑过滤器，你可以通过选择一个过滤器节点上的上下文菜单操作Edit来激活Edit Filter向导。Select fields to use as query filters 页面和 Define Query Filters 页面是一个Edit Filter向导中包含的两个页面。同样地，要编辑显示字段，你可以通过选择一个显示字段上的Edit菜单操作来激活Edit Display Field向导。Edit Display Field向导只显示Define Display Fields 页面。

保存一个查询

如早先章节所讨论的，未保存的查询使用一个*符号来显示（图20，）。要将一个未保存的查询保存到数据库，高亮显示查询，并选择Save上下文菜单（）操作。在保存操作之后，* 符号被除去了），标示未保存的变化被提交到Rational ClearQuest数据库中了。你可以通过高亮显示连接节点并使用Save All上下文菜单操作，来保存属于一个连接的所有未保存的查询。

你也可以通过Save工具栏项（）来保存一个查询。

删除或重命名一个查询

你可以通过使用Delete（图21，）或Rename（）查询上下文菜单操作（高亮显示查询，右键点击可以查看上下文菜单操作）来删除或重命名一个查询。将显示一个确认对话框来确认删除操作。

显示一个查询的SQL语句

要查看一个查询的SQL版本（图22），高亮显示查询，并选择View SQL菜单操作（）。查询的SQL显示在SQL Query视图（）中。

SQL查询只能在SQL Query视图中编辑。要将一个查询转换成一个SQL查询，高亮显示查询，并选择Utilities > Convert to SQL Query。如果你没有权限创建一个新的SQL 查询，一个查询就不能转换成一个SQL查询。由转换过程创建的SQL查询，不会自动地被保存到服务器上。你可以通过 Save Query 操作来保存查询。要编辑一个SQL查询，通过View SQL菜单操作来查看查询的SQL，并在SQL Query视图中选择Edit工具栏按钮。要保存已更改的SQL语句，使用SQL Query视图中的Save工具栏按钮。

SQL Query视图不是缺省ClearQuest透视图的一部分。你可以通过Window > Show View > Other > ClearQuest > SQL Query View来打开SQL Query视图。

在启动时执行一个查询

如果你想要在连接到一个Rational ClearQuest数据库时执行一个查询，你需要将查询设置为一个启动查询（图23）。要将查询设置为一个启动查询，高亮显示查询，并选择Utilities > Run at Startup。一个启动查询由复选标记符号（）来表示。

要将一个查询取消启动查询的设置，使用Utilities > Run at Startup（）。当你取消查询的启动属性设置时，复选标记就被移除了。Rational ClearQuest Client for Eclipse的Beta版本不允许用户在启动时运行一个图表或一个报告。

执行一个查询

你可以通过右键点击一个查询，并从上下文菜单中选择Run操作来执行一个查询。在执行之后，查询结果显示在ClearQuest Query Results视图中（图24）。记录的列和次序可以按照查询的显示字段设置来安排格式。在执行完查询以后，你将会注意到在ClearQuest Query Results视图中有其它变化。数据库信息被显示在视图的标题中（）。所执行查询的名字（），记录的类型（），返回记录的数量（），以及所选中记录的数量（）都显示在Query Results视图的状态栏中。

你可以展开记录，来查看父记录所引用的记录类型。进一步展开记录类型，将会显示出引用的记录。例如，展开一个缺陷记录，将显示出三个节点：Attachments，Duplicates和History。展开这些节点将显示出缺陷所关联的附件、复制和历史记录。

如果所选中的查询包含动态过滤器，将会显示一个动态查询窗口以设置规则（见图25）。在动态过滤器对话框中的页签是相对应于当前不同的动态过滤器（）。在动态查询对话框中点击OK（），执行基于规则集的查询。你可以通过使用cancel按钮（）来取消查询的执行。

有几种方式可以执行一个查询。你可以通过双击一个选中的查询或者在选中的查询上使用Run菜单来执行一个查询。

Query Results视图显示从执行查询中返回的查询结果。要从Query Results视图中返回到查询中进行操作，使用Show Query in Navigator菜单操作。

如果返回结果的数量超过了在Preferences中最大结果数量，那么将会显示一个消息来确认是否你要执行此查询。采取这种措施是因为执行带有大量结果的查询反而会影响性能。改变最大结果数量，要到Preferences中进行。

动态查询窗口只能显示检视区域（图26）中的一定数量的动态过滤器。如果一个查询包含不能在动态过滤器对话框窗口的检视区域中提供的动态过滤器，超出的过滤器会显示在屏幕外（）。

多查询结果

如我们在执行一个查询一节中所看到的，执行查询的结果被显示在ClearQuest Query Results视图中。每个执行的查询使用一个不同的ClearQuest Query Results视图来显示结果（图27）。这意味着当执行多个查询时，多个ClearQuest Quest Results视图将显示在ClearQuest透视图中。对于每个ClearQuest Query Results视图，位置信息（）和查询路径名（都显示在视图标题和状态栏中。当你执行一个查询时，如果没有与查询相关联的ClearQuest Query Results视图，结果就会显示在一个新的ClearQuest Query Results视图中。不同的ClearQuest Query Results视图堆叠在其它视图的顶端。

如果再次执行一个之前的查询，结果将会显示在已经分配给该查询的ClearQuest Query Results视图中。当你登出一个数据库时，所有分配给该数据库中查询的视图会自动地关闭。

为每个执行的查询分派一个Rational ClearQuest Query Results视图是Rational ClearQuest Client for Eclipse的缺省方式。你可以在Preferences中选择更改此方式。

记录（Records）

在本节中，我们将看一下可以使用Rational ClearQuest Client for Eclipse对记录执行的操作。这些操作包括：

查看一个记录的信息
对一个记录执行操作
刷新ClearQuest Query Results视图中的记录
创建记录
查找记录

查看一个记录的信息

ClearQuest Record Details视图显示一个记录的完整的信息集（图28）。要在ClearQuest Record Details视图中显示一个记录，从记录的上下文菜单中选择Details操作。

在显示出Details视图之后，只要选择一个新的记录，该视图就会自动地显示出所选择记录的信息。记录窗体的显示与在schema中设计得完全一样（参见图28）。选择不同的页签会显示出相称的信息。所选择记录的数据库信息显示在视图标题中（）。

你可以通过更改参数设置来更改何时以及如何显示ClearQuest Record Details视图。

在一个记录上执行操作

你可以从ClearQuest Query Results视图或者ClearQuest Record Details视图中对记录执行操作。

从ClearQuest Query Results视图中直接执行记录操作的能力意味着，将此视图加入到你开发透视图中是非常有用的。这样你不用转换到ClearQuest透视图中，就可以执行大多数的CleaeQuest活动。

在ClearQuest Query Results视图中，对一个记录可能执行的操作显示在记录的上下文菜单中（图29）。上下文菜单操作分成三类：

Change State－变更状态的操作（）让你将一个记录从一个状态转换到另一个状态。
Modify－你可以通过此操作修改（）记录信息。
Utilities－实用操作（），如删除和增加附件。

当你开始从菜单执行一个操作时，将会显示一个执行此操作的窗口（图30）。填写必需的信息，并完成此操作。操作决定了将显示哪一种窗口。例如，当你选择modify操作时显示一个修改窗体，而当你开始一个duplicate操作时会显示一个复制操作窗体。

你也可以从ClearQuest Query Results视图对引用的记录（子节点）（图31，）执行操作。可用的操作取决于所选中的记录。

对一个记录执行的操作可以相同地应用于多个记录。高亮显示你想要执行操作的记录，并开始进行一个公共操作。与通常一样的窗口将会显示出来，除了一个Apply按钮被一个Apply All按钮代替了。点击Apply All按钮将会对所有选中的记录执行操作。

在ClearQuest Record Details视图中执行的操作在视图中进行比从一个上下文菜单进行要好。这些操作位于视图的右上角（），并同样被组织到ClearQuest Query Results视图中。包含在一个控件（例如附件操作）中的操作是从窗体中开始进行的。其它操作，例如Modify，使用ClearQuest Record Details视图中的记录窗体来执行操作。

注视图 32中的Edit（）图标。你将会注意到此按钮与所有的multi-line文本控件连接在一起。点击Edit图标会调出一个文本编辑对话框，为你提供一个大的、可调整大小的区域来编辑文本。

刷新ClearQuest Query Results视图中的记录

当对ClearQuest Query Results视图中的一个记录执行一个操作时，该记录会被刷新。你可以通过右键点击一个记录并从上下文菜单中选择Refresh操作来手动刷新一个记录。多个记录可以通过对多个选中的记录使用Refresh操作来刷新。

整个结果集可以通过重新运行查询来刷新。你可以通过使用Rational ClearQuest Query Results视图工具栏中的Re-run Query操作（图33，）来快速重新运行查询。

你可以通过修改Preferences来更改如何刷新ClearQuest Query Results视图。

创建记录

如果没有查询记录，查询就没有价值。如果你已经在一个或多个ClearQuest数据库中创建了授权，你就可以通过使用Eclipse工具栏中的Submit按钮（）或ClearQuest主菜单下的New菜单项来执行一个submit记录操作（图34）。点击下拉列表，显示一个活动数据库的上下文菜单。你所选择的数据库将会决定在哪里创建记录。展开数据库条目，将会显示出你被允许创建的不同记录。有状态的记录名显示为顶端的菜单操作，无状态的条目可以通过其它子菜单来访问。

选择想要的记录类型，会显示一个创建记录窗口。填写必需的字段，并提交记录。

你也可以从ClearQuest Query Results视图中创建记录（图35）。Submit记录操作（）处于ClearQuest Query Results视图的工具栏中。

创建操作让你可以向连接到特定ClearQuest Query Results视图的数据库中提交记录。因为你只能在已连接的数据库中创建记录，上下文菜单只会显示该数据库的记录类型。此外，点击主提交记录操作将会激活当前schema的缺省记录类型的提交。

查找记录

查找记录操作可以让你取得一个特定记录，并在其上查看或执行操作。此操作是为了防止你只是为了在一个记录上查看或执行操作而去执行一个查询。此操作或者是从Eclipse工具栏中的Find Record，或者是从ClearQuest主菜单（图36）下的Find Record菜单项开始进行。

查找对话框（图37）包括一个记录类型（），一个搜索所有记录类型的选项（），id搜索文本框（）和一个复选按钮（）。

你可以在ID文本框中输入部分识别字符串。点击find将会告诉你，基于你的id搜索字符串会显示什么记录。查找到的记录显示在ClearQuest Record Details视图中。

记录附件（Record Attachments）

你可以使用Rational ClearQuest Client for Eclipse来打开、增加、删除和编辑一个附件。你可以从ClearQuest Query Results视图或ClearQuest Record Details视图中对一个附件执行操作。如果特定的记录类型支持附件，ClearQuest Query Results视图将附件显示为一个子节点。在本节中，我们将看一下不同的附件操作：

创建一个附件
删除一个附件
打开一个附件

创建一个附件

要创建一个附件（图38），高亮显示记录并选择Utilities > Add Attachment（）上下文菜单操作。将会出现一个Add Attachment窗口，让你来选择需要作为一个附件上载的文件。

删除一个附件

要删除一个附件（图39），高亮显示附件，并选择Delete（）菜单操作。

打开一个附件

要打开一个附件，高亮显示附件，并从上下文菜单中选择Open。附加文件会被临时存储在“ClearQuestAttachment”项目下。文件或者在一个Eclipse编辑器中被打开，或者在一个Eclipse外部的编辑器中被打开。Window > Preferences > Workbench > File Associations选项决定了文件是在Eclipse内部还是外部打开。你可以修改在一个Eclipse或一个外部编辑器中打开的文件。当你保存文件时，附件被自动地保存到Rational ClearQuest数据库中。当你关闭相应的编辑器时，临时的附加文件会被自动地删除掉。

如果你更喜欢从ClearQuest Record Details视图中执行附件操作，你只需要从窗体的附件控件中启动操作。

图表（Charts），报表（Reports）和报表格式（Report Formats）

图表，报表和报表格式显示在ClearQuest Navigator视图中（图40，）。这些对象与查询对象是以相同的方式进行操作的。我们将会讨论以下操作：

执行一个图表
创建一个图表，报表和报表格式的一个副本
删除或重命名一个图表，报表和报表格式

执行一个图表

图表的执行与查询执行是相似的。在图表完成执行之后，将会显示在ClearQuest Chart视图中（图41）。如果执行了多个图表，都将会在ClearQuest Chart视图中显示图表。与多个查询执行的情况相似，你可以更改是否每个执行的图表都分派其自己的视图。你可以在Preferences中修改此方式。

如果执行多个图表，将会为每个图表显示一个ClearQuest Chart视图。与多个查询执行的情况相似，你可以更改是否每个执行的图表都分派其自己的视图。你可以在Preferences中修改此方式。

创建一个图表，报表和报表格式的副本

图表，报表和报表格式可以被复制和粘贴在一个文件夹中。被复制的对象必须被保存才能固化在数据库中。

删除或重命名一个图表，报表和报表格式

进行删除和重命名操作与一个查询的操作完全是相同的。

中止一个数据库连接

中止ClearQuest数据库连接（断开连接）与登录是相似的，除了ClearQuest Navigator视图（）和工具栏（）按钮操作不同。ClearQuest Navigator视图的登出操作是上下文相关的：Logout操作是在所选择的连接上执行，而Logout工具栏菜单操作或ClearQuest登出菜单（）操作可以在任何登录的位置上执行。

ClearQuest Navigator视图的注销按钮只有在选中一个连接节点时才是激活的。点击ClearQuest Navigator视图的注销按钮，断开所选择连接节点的连接。这时将会显示一个注销确认对话框，要求你确认注销操作。注销操作会从ClearQuest Navigator视图中移除连接节点信息，并关闭所有连接的ClearQuest Query Results视图。

Eclipse主工具栏中的注销工具栏按钮（或logout ClearQuest菜单）操作方式类似于（图43）ClearQuest Navigator视图的login 操作。所有已登录的位置都显示在logout工具栏下拉菜单中。你最新近登录的连接用一个复选框（）标记。从下拉菜单中选择一个位置将会使你与该位置断开连接。点击主工具栏按钮将会使你与用复选框标记的连接断开。

后续连接

Rational ClearQuest Client for Eclipse为每个成功登录保存了连接信息（图44）。保存的连接信息使你不用经过登录向导就可以登录到一个数据库连接。保存的连接信息可以从任何Login按钮来访问。当你点击Login按钮上的下拉箭头时，会出现一个登录菜单。登录向导是进入登录菜单的第一项。登录下拉菜单中其余项（）代表了所有其它存储的连接信息。一次最多可以存储五个连接。当一个新的连接被保存到列表中时，最旧的连接就会被删除掉。

点击连接信息，登录到一个数据库连接中。如果密码没有保存，你将会被提示输入授权信息。你可能已经注意到在登录菜单下一项的一个复选标记（）。此复选标记表示最近访问的连接。选中的连接是缺省连接。点击Login工具栏按钮，会自动地连接到缺省连接。这使你能够一次点击就连接到一个以前的连接。

高级Rational ClearQuest任务

在基本 Rational ClearQuest 任务一节中，我们看了如何使用Rational ClearQuest Client for Eclipse来执行日常的ClearQuest活动。在本节中，我们将看一下Rational ClearQuest Client for Eclipse中的一些高级特性，以及这些特性如何改进你全部的工作流。本节也详细说明了Rational ClearQuest Client for Eclipse如何与Eclipse进行无缝集成，以帮助我们执行不同的ClearQuest任务。高级的Rational ClearQuest活动包括：

多连接
后台，并行操作
与Eclipse视图和编辑器集成
管理用户档案
参数设置

多连接

使用Rational ClearQuest Client for Eclipse，你可以登录到多个Rational ClearQuest数据库中（图45）。相称工作空间对象的不同数据库的连接信息（）显示在ClearQuest Navigator视图中。

你可以用与单个数据库连接完全相同的方式，对相应于不同数据库连接的工作空间对象执行操作。ClearQuest Query Results视图显示连接信息，以区分是哪个连接产生的结果（图 24，）。

后台，并行操作

一些Rational ClearQuest任务，例如登录和执行查询，可能花费时间比较长。ClearQuest Client for Eclipse可以确定所有的耗时任务，并在后台执行这些任务。这样可以使你在耗时的ClearQuest任务在后台执行时，去执行其它Eclipse或ClearQuest任务。有些耗时操作甚至可以并行执行，以提供最大的时间效率。在本节中，我们将看一下在后台执行的不同的ClearQuest任务。我们将执行的不同后台操作包括：

后台登录操作
后台执行查询
后台提交记录

后台登录操作

登录过程包括验证用户，取得schema信息，然后执行启动查询、图表和报表。为了概述工作效率，登录在后台执行。如果验证信息是有效的，一个新的连接节点将增加到ClearQuest Navigator视图中。如果验证信息是无效的，将会显示给用户一个错误消息的对话框。

Eclipse状态栏显示了有关执行的后台操作和完成百分比的信息。你可以使用Eclipse Progress视图来查看所有调度后台操作的信息。你可以通过使用主菜单栏的Window > Show View > Others > Basic > Progress来打开进度视图（图46）。

在后台执行查询

正如你可能想到的，查询操作是最耗时的ClearQuest任务。Rational ClearQuest Client for Eclipse在后台执行查询。这使你在后台执行大量查询时，还可以进行其它的Eclipse任务。只要执行查询，结果就会显示在ClearQuest Query Results视图中。当你同时执行多个查询时，执行查询操作是并行执行的。

在后台提交记录

创建记录操作也是在后台执行的。只要记录提交完成了，就会在Console视图中显示一条消息报告此结果。

与Eclipse视图和编辑器集成

Tasks和Problems视图显示你的开发代码中的任务和编译错误。Rational ClearQuest Client for Eclipse通过让你创建一个与任务或问题相对应的Rational ClearQuest记录，来提供与Eclipse Tasks和Problem视图的集成。要创建基于一个任务的一个Rational ClearQuest记录，高亮显示tasks视图中的任务，并从上下文菜单中选择ClearQuest > New ClearQuest record（）。

记录选择对话框左边显示了登录CleaarQuest连接的列表，右边显示了所选择连接的记录类型（图48）。你可以选择使用列表中的一个登录（），或者使用New Connection（）按钮创建一个新的位置。点击new connection按钮，打开Login Wizard。选择记录类型（），并点击OK激活new record对话框。这种集成方式会自动用Task信息填充记录的Headline和Description字段，假如记录类型有这些字段的话。

问题或任务用标记显示在一个Java编辑器中。Rational ClearQuest Client for Eclipse可以让你从一个Java编辑器中基于一个问题或一个任务标记来创建一个ClearQuest记录（图49）。要创建一个ClearQuest记录，右键点击标记，并选择ClearQuest > New ClearQuest Record..（，）。

在记录选择对话框中创建的连接和记录类型选择是永久跨对话的（图50）。这些永久性的记录类型和连接信息可以用于从Tasks视图或Problems视图中通过简单点击一下就创建一个新的ClearQuest记录。)

管理Email选项

设置Email选项可以在执行操作时进行通知。Email Options向导可以从主菜单启动（图51），选择ClearQuest -> Admin -> EmailOptions...（）。

第一页要求Email Provider信息，第二页让你配置Email Provider。点击finish应用这些修改。

管理用户档案

你可以使用Rational ClearQuest Client for Eclipse来编辑用户信息。要访问用户档案并进行修改（图52），从ClearQuest Query Results视图的主菜单（）中选择ClearQuest -> Admin -> Change User Profile...。

用户档案对话框可以让你修改登录用户的密码，用户全名，电子邮件，以及电话号码（图53）。

对用户档案进行的修改会马上应用到用户数据库中。

多站点支持

ClearQuest Client for Eclipse支持ClearQuest Multisite。基本操作的执行方式与非多站点环境是相同的，除了受限于mastership的操作。ClearQuest Navigator视图（图54）中的工作空间对象用增加的一个锁图标（）显示mastership信息。出现一个锁表示此工作空间对象是远程控制的。

ClearQuest Query Results视图（图55）在一个增加的显示列中显示了mastership信息（）。再次会出现一个锁表示此记录是远程控制的。

显示在ClearQuest Record Details视图（图56）中的记录的mastership初始时并不明显。只有执行一个记录操作显示Mastership required（）时，才会指示此记录是远程控制的。

参数设置

你可以通过修改参数（图57）将Rational ClearQuest Client for Eclipse的方式定制为你喜欢的样子。要设置参数，从Eclipse菜单栏选择Window > Preferences。浏览到Team > ClearQuest（）节点并展开它。将会显示出一个Rational ClearQuest选项页（）。

ClearQuest 参数

<table border="1" cellpadding="2" cellspacing="2"><tr><td width="386">选项</td><td width="509">描述</td><td width="82">缺省值</td></tr><tr><td width="386">Bring console to the front automatically when there is message coming through</td><td width="509">激活此选项将会在显示一条新消息时显示控制台。不激活此选项将会在Console视图中安静地显示一条新消息。</td><td>未激活</td></tr><tr><td>Show successful messages in an informational dialog</td><td>激活此选项将会在一个对话框中显示成功消息。不激活此选项将不会在一个对话框中显示成功消息。</td><td>未激活</td></tr><tr><td>Show successful messages in the Console </td><td>激活此选项会将成功消息显示为Console视图中的一项。不激活此选项将不会在Console视图中显示成功消息。</td><td>激活</td></tr><tr><td>Enable verbose messages</td><td>激活此选项会在每个操作后产生消息。不激活此选项只会为某些操作产生消息。</td><td>未激活</td></tr><tr><td>Enable Multiple Query Results Views </td><td>激活此选项会为每个执行的查询分派一个ClearQuest Query Results视图。不激活此选项只会为所有执行的查询分派一个ClearQuest Query Results视图。</td><td>Enabled////激活</td></tr><tr><td>Automatic refresh (user initiated actions)</td><td width="509">

No automatic refresh - 记录不会被自动刷新
Refresh highlighted view item(s) after each action - 在执行完记录操作后刷新记录
Rerun the last successful query after each action - 在每个操作后重新运行查询

</td><td>Refresh highlighted view items(s) after each action</td></tr></table>

高级参数

<table border="1" cellpadding="2" cellspacing="2"><tr><td width="375">选项</td><td width="493">描述</td><td width="78">缺省值</td></tr><tr><td>Open ClearQuest Details view automatically whenever there is item(s) selected in the ClearQuest Query Results view </td><td>激活此选项将会在ClearQuest Query Results视图中选择一个记录时自动打开ClearQuest Record Details视图。不激活此选项则不会在ClearQuest Query Results视图中选择一个记录时自动打开ClearQuest Record Details视图。</td><td>未激活</td></tr><tr><td>Maximum number of records in the ClearQuest Query Results view</td><td>此值决定了ClearQuest Query Results视图中允许的最大查询结果大小。</td><td>1000</td></tr><tr><td>Chart Height</td><td>此值决定了在ClearQuest Chart视图中显示的图表高度。</td><td>500</td></tr><tr><td>Chart Width</td><td>此值决定了在ClearQuest Chart视图中显示的图表宽度。</td><td>800</td></tr><tr><td>Allow multiple chart views</td><td>激活此选项将为每个执行的查询分派一个ClearQuest Chart视图。不激活此选项将会为所有执行的查询只分派一个ClearQuest Chart视图。</td><td>未激活</td></tr><tr><td>Set chart JPEG compression strength</td><td>此值决定了用于ClearQuest Chart视图中显示图表的压缩率。增大此值会产生较低质量的图像，但是会需要较少的时间来执行和显示图表。</td><td>0%</td></tr><tr><td>ClearQuest attachments project name</td><td>此值决定了用于存储附件的Java项目名字。</td><td>ClearQuest Attachments</td></tr></table>
<table border="0" cellspacing="0" cellpadding="0" width="100%"><tr><td>
</td></tr></table><table class="no-print" cellspacing="0" cellpadding="0" align="right"><tr align="right"><td>
<table border="0" cellpadding="0" cellspacing="0"><tr><td valign="middle">
</td><td valign="top" align="right"></td></tr></table></td></tr></table>

典型用户场景

在本节中，我们将会查看由不同角色的用户来执行的典型场景。目的是显示不同的用户是如何来利用Rational ClearQuest Client for Eclipse的。包括的角色是：经理，项目负责人，开发人员和质量工程师。

经理

Sue，是经理，想检查一个特定迭代的状态。Sue点击login按钮登录到缺省链接。她决定运行一个缺陷趋势图来按周显示打开缺陷的数量。在注意到一个不合意的趋势时，她运行一个缺陷趋势图来显示每周的属于不同开发人员的缺陷。她看到，开发人员John有大量的缺陷。为了要看John在哪方面陷入了大量缺陷，她运行一个查询，返回属于John的缺陷，并按组件排序。然后，Sue确定了需要额外帮助的组件，并与项目负责人Glen讨论这个问题。

项目负责人

Glen，是项目负责人，刚才与他的经理讨论了有关John的大量缺陷的问题。Glen运行一个查询来检验John的缺陷。他看到，John的缺陷分成两个不同的组件。Glen决定通过让另外一个开发人员Barney来处理其中一个组件，以减轻John的负担。在与John和Barney谈话后，Glen准备分配缺陷。Glen选中所有他想分配的缺陷，并对它们执行分配操作。完成批量记录操作后，Glen决定与质量工程师Nathan谈话，她负责John正在工作的组件。

开发人员

Barney，是一个开发人员，运行一个查询得到他的所有活动缺陷。他看到刚从John转移过来的10个缺陷。他定位到一个高严重度的区县，开始解决它。他检出两个文件，将缺陷修复掉。他注意到在其中一个文件中有一个TODO任务标记。看到这个TODO可能没注意到，他从Task视图提交了一个缺陷。在解决此缺陷之后，他检入了这两个文件，并更改缺陷到resolved状态。由于这是一个高严重度的缺陷，他与Nathan通了电话，他是提交此缺陷的质量工程师，一起讨论了需要用来验证此缺陷的测试情况。

质量工程师

Nathan，是一个质量工程师，与Glen完成了有关John的组件的讨论。Nathan决定重新确认这几周来的所有活动缺陷。他运行一个所有活动缺陷的查询，并首先确认了最高严重度的缺陷。不久，他接到了来自Barney的一个有关他的高严重度缺陷的电话。他同意Barney的意见，这个缺陷没有按照预期被解决掉，但是会防止范围中的更多问题。Nathan开始确认此缺陷，增加了一个注释，说明此缺陷如何更改组件。在确认此缺陷的过程中，他注意到，Barney拼写错了一些文字。他抓了文字的一个屏幕快照，并提交了一个低严重度缺陷，附带屏幕快照为一个附件。

结束语

现在，希望你能了解Rational ClearQuest Client for Eclipse提供了什么。Rational ClearQuest Client for Eclipse提供了Eclipse环境中的大多数ClearQuest功能。它也提供了与许多Eclipse视图和编辑器的一个无缝集成。现在你可以将变更管理作为你的Eclipse工作流的一部分来执行，而不是将它作为其自己的一个“任务”。

感谢

作者将感谢Nacia Owens，Stefan Schurman，Brian Gillan，Steve Speicher 和 Jeanette Deupree （所有都是IBM人员），为本文提供了许多建设性意见。

作者简介<table border="0" cellspacing="0" cellpadding="0" width="100%"><tr><td colspan="3"></td></tr><tr align="left" valign="top"><td>

</td><td></td><td width="100%">

Balaji Krish has co-authored this article

</td></tr></table>
<table border="0" cellspacing="0" cellpadding="0" width="100%"><tr><td colspan="3"></td></tr><tr align="left" valign="top"><td>

</td><td></td><td width="100%">

Nam Le has co-authored this article

</td></tr></table>

<table border="0" cellspacing="0" cellpadding="0" width="100%"><tr><td>
</td></tr></table><table class="no-print" cellspacing="0" cellpadding="0" align="right"><tr align="right"><td>
<table border="0" cellpadding="0" cellspacing="0"><tr><td valign="middle">
</td><td valign="top" align="right"></td></tr></table></td></tr></table>

↑返回目录
前一篇: 在团队环境中使用 WebSphere Studio 进行插件开发
后一篇: 安装和使用基于 Eclipse 的 IBM Rational产品