内容


Jazz 系列

开始使用工作物件

Comments

系列内容:

此内容是该系列 # 部分中的第 # 部分: Jazz 系列

敬请期待该系列的后续内容。

此内容是该系列的一部分:Jazz 系列

敬请期待该系列的后续内容。

引言

工作物件是开发任务的通用概念。典型的工作物件类型有缺陷、增强功能和任务。可以通过流程规范容易地添加新工作物件或扩展现有的工作物件类型。

本文档的目的是帮助您开始使用 Jazz 工作物件组件及其用户界面,例如工作物件编辑器、查询对话框和查询结果视图。

本文档根据典型用例进行组织:

  • 为工作物件准备项目区域
  • 错误归档——创建工作物件
  • 管理错误
  • Web UI
  • 工作物件自定义

先决条件

强烈建议您首先阅读以下文档:

本文档还假设 Jazz 服务器已设置就绪,并且您能够访问该服务器。由于工作物件仅存在于项目区域的上下文中,因此在创建任何工作物件之前,您必须打开与某个现有项目区域的连接。可以使用 JUnit 示例项目设置向导来创建示例数据库。为此,可以按照 “创建 Jazz JUnit 示例项目” 中的步骤进行操作。

为工作物件配置项目区域

由于工作物件根据类别(功能区域)和产品版本进行归档,您需要在项目区域中为这两个属性定义值集。

如果已经使用 JUnit 示例项目设置向导创建了示例数据库,则这两个值集都已定义完毕,您可以直接转到错误归档

工作物件类别

可以定义用于在项目区域编辑器的 Work Item Categories 页面上组织工作物件的类别。可以对类别进行创建、存档/取消存档、重命名和移动到另一个父类别。类别的移动使用拖放操作来进行。

每个类别可以与某个团队区域相关联,当不存在显式的关联时,则使用父类别的团队区域。类别的团队区域确定了规定的流程和负责分配到该类别的所有工作物件的团队。根类别确定了未分配到任何类别的工作物件的团队区域。

通过取消选中类别树中的可见性复选框,可以对其他团队的成员和外部参与者隐藏类别子树。这可以实现细粒度的类别层次结构,而不致向不熟悉内部结构的工作物件创建者公开复杂性。

要开始在新的项目区域中使用工作物件,可以在 Team Artifacts 视图中从项目区域的上下文菜单打开项目区域编辑器,转到 Work Item Categories 页面,并确保根类别与某个团队区域相关联。

示例类别配置。

在处理多条开发线时,可以将类别与每条开发线的不同团队区域相关联。在那样的情况下,要确定某个工作物件的团队区域,可以参考该工作物件的类别及其 Planned For 迭代的开发线。这允许对每条开发线使用不同的流程并表示不同的团队。当存在多条开发线时,该编辑器将显示附加的选项。

具有多条开发线的项目中的示例类别配置。

工作物件版本

可以定义一组在项目区域的流程规范中对工作物件的 Found In 属性可用的版本。在 beta2 中,版本是使用自定义枚举进行配置的;在该产品的最终发布中,版本将存在于数据库中,并且图形 UI 将变得可用。

要配置 beta2 中的可用版本,可以在 Team Artifacts 视图中从项目区域的上下文菜单中打开项目区域编辑器,转到 Process Specification 页面,并添加或更改类型 version 的现有 <enumeration>。请注意,Literal 值的 ID 将被忽略,而仅使用名称(从而使得在 beta2 中重命名版本变得不可能)。

示例版本配置。

错误归档——创建工作物件

从头创建新工作物件

要创建新工作物件,可以从 File > New > Work Item 菜单项中选择 New Work Item 向导。该向导还允许选择所需的项目区域和工作物件类型。然后将在工作物件编辑器中打开所创建的工作物件。

New Work Item 工具栏操作允许直接在下拉菜单中选择所需的类型。如果连接到了多个项目区域,则还可以为任何项目区域创建工作物件,而不需要更改缺省项目区域。在创建工作物件查询或工作物件时,如果不显式指定项目区域,则使用缺省项目区域。可以通过在 Work Items 视图的 Create Query 下拉菜单中进行选择或使用 New Work Item 工具栏操作下拉菜单中的 Make Default Project Area 操作来更改缺省项目区域。

New work item 工具栏操作

New work item 工具栏操作

下面是已进行了一段时间的 Defect 类型的工作物件的示例,因此其状态已更改为 Resolved,并且解决状态已更改为 Fixed

工作物件编辑器:初始视图

工作物件编辑器:初始视图

工作物件编辑器具有几个页面:

  • Overview 页面显示主要属性,并提供了存在于 Links 和 Approval 页面中的信息的摘要。
  • Links 页面显示文件附件、订阅用户和指向其他构件的链接。链接具有表示链接语义的类型。示例包括预定义的链接类型“Parent/Child”、“Related”、“Duplicate”和“Blocks/Depends On”。
  • Approvals 页面显示已经为该工作物件定义的任何审批、审核或验证。审批(或者审核或验证)具有解释审批原因的“主题”、审批人员列表和到期日期。每个审批人员可以接受或拒绝该审批。
  • 可选的 Custom 页面显示任何自定义属性。仅当工作物件具有要显示的自定义属性时,此页面才会出现。可以在流程规范中向工作物件类型添加自定义属性。
  • History 页面显示工作物件的更改历史记录。

在进行错误归档(或创建工作物件)时,这些属性非常重要:

  • Summary 字段用作工作物件的(简略)标题。
  • 工作物件 Type 指定该新工作物件的性质。不同的类型可以具有不同的属性和不同的状态转换。预定义的工作物件类型包括 DefectTaskEnhancement
  • Severity 描述工作物件的影响。
  • Found In 属性指定该工作物件应用于项目的哪一个版本。有关如何配置自己的版本的信息,请参阅 版本部分
  • Description 字段详细描述工作物件目标或关于该工作物件的任何相关详细信息。
  • Category 字段指定工作物件的功能区域。每个类别与某个团队区域关联,该团队区域定义了流程和负责分配到该类别的工作物件的团队。有关如何配置自己的类别及其与团队区域的关联的信息,请参阅 分类部分。请注意,在处理多条开发线的时候,Planned For 属性(参见下面)也影响与工作物件关联的团队区域。

通常不在创建时设置的其他属性将在工作物件优先分派或处理错误时进行分配:

  • Owner:负责该工作物件的用户,
  • Priority 属性描述工作物件的重要性和应该解决该工作物件的顺序。
  • Planned For 指定该工作物件的目标迭代(请参阅 “开始使用 Jazz 项目区域和过程”)。在处理多条开发线时,与工作物件关联的团队区域将由其类别和目标确定。有关如何更改这些关联的信息,请参阅 分类部分
  • State/Resolution:工作物件的当前状态,例如 NewIn ProgressResolved,以及特定解决状态,例如 FixedDuplicate 状态的解决。 显示 State 和 Resolution 字段的工作物件编辑器

    对于正在处理某个工作物件的开发人员,重要的状态转换是“New”和“In Progress”之间的转换。为了避免必须在工作物件编辑器中执行此转换,可以对工作物件使用两个上下文菜单操作 Start WorkingStop Working。使用这些操作的善意副作用在于,Jazz 客户端将维护一个当前工作物件,此工作物件在 Eclipse 工作台窗口右下角的状态行可见。

    工作台窗口的当前工作指示器
    工作台窗口的当前工作指示器

使用工作物件编辑器的有用提示:

  • Tags 和 Owner 字段可以提供内容辅助功能。当光标进入该字段时,此功能通过电灯泡图标来指示。输入某些文本并按 Ctrl+Space(假设使用缺省键盘设置)即可激活内容辅助功能。
  • Summary、Description 和 Discussion 字段支持“粗体”和“斜体”文本样式(在选定某些文本时查看 Edit 菜单)。
  • 该编辑器中的所有链接都是活动的,因为不仅可以单击跟随它们,而且它们还具有上下文菜单和所链接到的对象的丰富鼠标悬停提示。当提供了鼠标悬停提示时,可以按 F2 将焦点设置到帮助框中,并在信息中滚动。
  • 在 Summary、Description 和 Discussion 字段中,您可以使用简短的符号自动创建指向其他 Jazz 构件的链接。例如:work item 123、comment 3、item 123、bug 432、attachment 4321。这些引用将显示为链接,并提供上下文菜单和丰富的鼠标悬停提示。
  • 通过选择某些文本并使用上下文菜单中的“Extract Work Item”操作,可以从工作物件中提取相关工作物件。
  • 通过使用用户名称的上下文菜单,您可以在 Discussion 部分中启动聊天会话或向注释创建者——或任何用户——发送电子邮件。
  • 要添加订阅者、附件或指向其他 Jazz 构件的链接,您可以使用“Quick Information”部分的上下文菜单,或者直接将对象拖放到 Links 或 Approvals 页面上的各个部分。
  • 可以通过“Quick Information”部分的上下文菜单创建屏幕快照或添加屏幕快照附件。
  • 可以使用 Find 对话框 (Control-F) 对整个 Summary、Description 和 Discussion 部分进行搜索。
  • 该编辑器的标题可用作拖放源并提供了上下文菜单。
  • 对审批、审核和验证的表决可以在 Approvals 页面上进行设置。
  • 将常用的审批准备为文件夹,并且所有审批人员都在 Team Artifacts 视图的收藏夹中。然后,Approvals 部分允许您通过将收藏夹文件夹放在该部分上,从而创建新的审批。

创建工作物件的其他方法

还存在其他几种在 Jazz 中创建新工作物件的方法:

  • Capture Screenshot 工具栏项(Screen Shot 操作按钮)激活屏幕捕获工具,您可以在该工具中创建屏幕图像,使用简单线条图形对屏幕图像进行装饰,并将最终的图像附加到新工作物件。
  • Error Log 视图上下文菜单提供了 New Work Item 操作,以基于所选的错误日志行创建新工作物件。
  • JUnit 视图上下文菜单提供了 New Work Item 操作,以基于所选的 JUnit 测试创建新工作物件。
  • 在构建编辑器的 Summary 页面上,可以使用 Create a new work item 操作链接,以基于当前构建创建新工作物件。
  • Console 视图上下文菜单提供了 New Work Item 操作,以基于所选的文本创建新工作物件。
  • 在工作物件编辑器中,可以使用 Edit 菜单中的 Extract Work Item 操作,以基于 Summary、Description 或 Discussion 字段中的文本选择创建新工作物件。
  • 在工作物件编辑器的标题区域中,Duplicate 操作创建工作物件的副本,并将它们与相关链接连接起来。

其中有些操作提供了基于选定文本或构件的可选副本搜索。如果搜索成功,您可以丢弃新创建(但是还未保存)的工作物件,并将您自己添加为所找到的工作物件的订阅者。

管理工作物件

Jazz 提供了用于管理工作物件的丰富功能。下面是可用于管理工作物件的主要组件的描述和屏幕图像。

查找工作物件

按 ID 查找工作物件

在工作台窗口左下角的文本输入字段中输入工作物件的 ID 并按 [ENTER] 键。或者,您可以按 Ctrl+Alt+W 并在弹出对话框中输入 ID。弹出对话框中的历史记录允许您快速重新打开最近使用过的工作物件。

按文本内容查找工作物件

窗口修饰中的相同文本输入字段允许搜索存储库中包含某些单词的工作物件。

快速搜索修饰

快速搜索修饰

可能出现该单词的字段并不限于摘要、描述和注释,而是包括附件、标记或与工作物件相关的用户名称。

一些搜索提示:

  • “collaps”将匹配“collapsed”、“Collapsing”等等。
  • CamelCase 单词将做特别处理:“NullPointerException”将返回包含这个确切术语的工作物件,但同时还返回仅包含“NPE”的工作物件。此搜索还将找到包含“null”和“pointer”以及“exception”的工作物件。

输入字段旁边的下拉菜单允许将搜索范围限制到特定项目区域和限制到未解决的工作物件。如果输入字段包含一些文本,单击操作图标将会重新执行查询。

或者,还可以按 Ctrl+Alt+W,在弹出对话框中输入一些单词,并从结果中选择工作物件。

在 Artifacts Search 页面 (Search>Jazz Text Search...) 中可以使用更完整的文本选项。

查找潜在副本

可以使用工作物件编辑器标题中的操作(查找副本操作图标)尝试查找工作物件的副本。在 Work Items 视图中,您可以使用上下文菜单操作 Find Potential Duplicates

查找与某些内容相似的工作物件的其他方法包括:

  • Error Log 视图中的上下文菜单项 Find Similar Work Items
  • 控制台中的上下文菜单项 Find Similar Work Items
  • 操作 Search>Work Items Similar to Clipboard
  • 工作物件编辑器中针对选定文本的操作 Search>Text>Work Items

按筛选器约束查找工作物件

如果需要对查询结果拥有更多控制,或者希望保存查询以便将来使用,您可以在查询编辑器中创建查询。可以通过选择 File>New>Work Item Query 或使用 Work Items 视图 中的 New Query 操作或使用 Team Artifacts 视图 中的上下文菜单创建新查询。或者,可以使用 Duplicate... 上下文菜单操作来复制现有的查询。

Eclipse UI 查询编辑器

Eclipse UI 查询编辑器

从一组预定义的条件开始或“从头开始”:

  • 从头开始:从一组空的条件开始并添加您自己的条件。
  • 简单查询:从一组典型条件开始:所有者、状态、类别和全文。
  • 全文:创建全文查询。

使用 Add Conditions 操作 (操作) 来添加新条件。每个条件遵循相同的规则:

  • 只要没有输入或选择任何内容,则该条件还不是查询的一部分。
  • 如果选择或输入多个值,这些值将通过 OR 运算符进行联结。
  • 变量显示为顶部的复选框。这些变量表示会随时间而变化的值。一个很好的示例是 Current Iteration 变量,此变量始终指向流程规范中标记的当前迭代。变量使您可以用公式来表示在相当长时间内始终保持有效的查询,或者其返回结果取决于执行查询的用户的查询(例如,通过使用 Current User 变量)。
  • “Unassigned”复选框允许您查询工作物件的未初始化或未设置的字段。

可以使用 Add Conditions 操作菜单添加 OR 和 AND 子句。第三个选项是添加特定类型的所有属性的紧凑条件集合。例如,User Group 允许创建查询来查询由某个用户创建、修改、拥有或解决的所有工作物件。这样的组的属性始终使用 OR 进行联结。

可以通过使用 Run 按钮来检查查询的结果。结果显示在 Work Items 视图 中。必须提供名称才能保存查询。

共享查询:如果某个查询对其他人有用,您可以与团队成员或各个用户共享该查询。切换到查询编辑器的 Details 页面,并在 Sharing 部分选择某个团队区域或某些用户。

定义结果列:取决于具体的查询,并非 Work Items 视图 中缺省显示的所有列都有意义。您可以选择将在每次执行该查询时显示(在 Eclipse UI 和 Web UI 中)的自定义列集。切换到 Result Layout 页面,并选择列和最适合您的查询结果的排序顺序。

查询编辑器提示:

  • 可以使用部分标题中的下拉菜单来更改每个属性的运算符。 更改每个属性的运算符
  • 在基于列表和树的控件中,开始输入您希望选择的值的名称:一个经筛选的弹出对话框允许快速导航到所需的值。
  • 用于标签和审批描述符名称的控件提供了内容辅助功能(通常通过 Ctrl+Space 进行调用)。
  • 有些控件在部分标题中提供了附加功能:
    • 值筛选(例如,存档的值): 值筛选
      对 Category、Planned For、Team Area 可用。
    • 选择列表中还未显示的附加用户: 选择列表中还未显示的附加用户
      选定的用户随后将直接在该列表中可用。

查询结果:Work Items 视图

Work Items 视图显示工作物件查询产生的工作物件。可以通过直接在该视图中输入内容来筛选结果列表:将出现一个文本字段,并且仅显示匹配的工作物件(Ctrl+F 也可以打开该输入字段,ESC 将关闭该输入字段)。

可以使用该视图的 Columns 菜单添加和删除列。

可以选择使用该视图的 Relationships... 对话框来显示工作物件之间的联系。

显示筛选字段的 Work Item 视图

显示筛选字段的 Work Item 视图

Work Item 透视图

Work Item 透视图包括 Team Artifacts 视图、Team Central 视图和 Work Items 视图,在执行错误优先分派时,您必须同时管理工作物件和工作物件查询,此时这些视图全都非常有用。此透视图对于仅需访问与其关联的工作物件的个别开发人员不是那么重要。

Team Artifacts 视图

Team Artifacts 视图在每个已连接的项目区域下有一个 Work Item 文件夹,您可以在其中查找存储库中存储的所有工作物件查询。“My Queries”文件夹包含您的私有查询,“Shared Queries”文件夹包含所有的预定义和共享查询。

显示预定义工作物件查询的 Team Artifacts 视图

显示预定义工作物件查询的 Team Artifacts 视图

Team Artifacts 视图的顶级 Favorites 节点可用于为所有“喜爱的”Jazz 构件创建书签。这些构件包括工作物件和工作物件查询。此外,您还可以创建文件夹,从而帮助管理更大的书签集合。因此,如果在 Work Item 节点下有太多的私有和共享查询,可以仅将常用的查询保留在 Favorites 下。

Team Artifacts 视图的顶级 Work Item History 节点会记住已在工作物件编辑器中打开的所有工作物件。

Team Central

Team Central 视图具有多个部分,为您提供与您的工作相关的信息的简要概述,包括构建、更改集交付或工作物件活动。典型的部分显示简明的摘要,并连接到另一个提供更详细信息的视图或编辑器。

Team Central 视图

Team Central 视图

  • 查询部分

可以为查询部分配置一个或多个查询,以获取每个查询的结果计数及其如何随时间而变化的情况摘要。计数可以按特定属性进行细分(例如,按 Severity 或大多数其他内置工作物件属性)。

查询部分的配置方式可以是将查询拖放到该部分上,或者使用部分菜单中的配置对话框。

存在两个预定义的查询部分(可以使用 Team Central 的菜单创建附加的部分):

  • My Open Work Items 按优先级分组显示当前用户拥有的打开工作物件。
  • New Unassigned Work Items 按严重性分组显示还未分配的打开工作物件。

单击某一栏将在工作物件视图中显示对应的工作物件。

  • 事件日志部分

事件日志 部分显示一个或多个新的 Feed 的内容。缺省情况下,Jazz 具有两个预配置的 Feed,用于将事件从存储库服务器传输到客户端:

  • My Work Item Changes:包含当前用户属于其创建者、所有者、修改者或订阅者的工作物件的更改事件,
  • My Teams in Project Area:包含当前用户所属的所有团队区域的所有事件。

除了这些预配置的 Feed 以外,您可以定义附加的 Feed,并在现有的 Event Log 部分中显示它们,或者为它们创建新的事件部分。所谓的查询 Feed 非常有用,其中包含由某个工作物件查询指定的工作物件的所有更改事件。可以通过在某个工作物件上执行 Subscribe to Query Feed 上下文菜单操作来创建这样的 Feed。该 Feed 将出现在 Team Artifacts 视图中的 Feeds 节点下。在 Event Log 部分,您将必须在该部分的 Feeds 子菜单中启用新创建的 Feed。

Web UI

概述

Jazz 服务器可以承载多个项目区域。通过将浏览器指向以下 URL,可以从 Web 访问每个项目区域:

http://<host:port>/jazz/web/projects/<project area name>

因此,如果为 Jazz 配置了 example.com 上的“MyProject”(实际上没有),则 URL 将类似如下:

http://www.example.com:9443/jazz/web/projects/MyProject

通常,网站被配置为自动将您路由到适当的端口,因此您可以在此例中省略端口号。

好消息:如果无法记住项目区域名称,可以链接到 Jazz Web 根目录并从 Project Areas 列表中进行选择:

http://<host:port>/jazz/web

该 Web UI 最适合使用 Firefox 2.0 和 Internet Explorer 7 来浏览,虽然也可以使用 Internet Explorer 6。其他与标准兼容的浏览器也许可以工作,但是当前不受支持。(浏览器支持级别变化频繁,请访问 Jazz.net 主页以查找最新支持信息)。

从 Jazz Web UI 中,单击 Work Items 链接以显示 Work Items 页面。可以将此页添加到书签以直接打开它。

可以将此页添加到书签以直接打开它

可以将此页添加到书签以直接打开它

除了页眉和页脚以外,工作物件 Web UI 划分为两个主要部分:

左侧的导航部分提供快速访问以:

  • 创建新工作物件和查询
  • 执行快速搜索(全文搜索)
  • 选择最近查看过的工作物件和查询结果
  • 运行私有和共享查询

左侧导航区域中的各个部分可以使用部分标题中的箭头进行折叠。

右侧部分较大,并显示编辑器和查询结果。工作物件编辑器显示在上面。工作物件编辑器具有三个选项卡: 

  • Overview(已示出),显示属性详细信息、描述和讨论。
  • Links,显示订阅和工作物件与其他工作物件、构建和其他构件的关系。
  • Attachments,显示工作物件的文件附件,并允许上载新文件。

使用 Web 工作物件编辑器的有用提示:

  • 如果类别名称无法在类别字段中完整显示,可以将鼠标悬停在该字段上以查看完整的类别名称。 可以将鼠标悬停在创建日期上面以查看工作物件创建时间。可以将鼠标悬停在 Refresh 操作上以查看最后加载或保存工作物件的时间。
  • 如果将鼠标“悬停”在 Quick Information 部分上,可以查看有关那些项的更多信息。 在 Attachments 页面上,可以将鼠标悬停在图像附件(PNG、JPG、GIF)上以查看预览。
  • 标签字段将在您输入时自动完成。
  • 如果您开始输入注释并保存,但是由于该工作物件已过时(例如在您创建注释时,其他某人已创建了注释)而无法完成保存操作,您可以单击 Subscribe Me 链接旁边的 Refresh 链接(不是浏览器上的“刷新”按钮或 F5 键),该工作物件将被刷新;您将丢失对描述、详细信息、链接和附件所做的任何更改,但是您的注释将保留下来。如果您认为该工作物件可能会在您处理它的时候被更新,可以在花很长时间编写注释之前保存您的属性更改。
  • 可以单击某人的名称以向他们发送电子邮件。
  • 当您在 Web UI 中四处导航时,浏览器中的 URL 将会更新,因此您可以从地址栏复制链接,并将其发送给某人或添加到书签,以便以后返回到原来的位置。可以在左侧导航部分中的链接上使用鼠标右键,以将链接复制到查询或工作物件。
  • 必填字段用红色星号指示;但是更改类别会更改必填字段,因此您可能需要在更改类别之后进行保存以查看必填字段标记。
  • 更改类型会更改工作物件的布局;但是该布局在您保存工作物件之前不会更改,因此您可能需要在更改类型之后进行保存以查看新的布局(在缺省地兼容的 Task、Enhancement 和 Defect 之间更改时除外)。
  • 可以在 Web UI 中导航到其他工作物件而不会丢失未保存的更改,但是要记住在转到不同的网站或关闭浏览器窗口之前导航回去并保存所做的更改。如果从 Jazz Web UI 导航到其他地方或者使用 Web 浏览器刷新按钮进行刷新,则会丢失未保存的更改。
  • Jazz Web UI 不使用 Cookie 或维护用户信息,因此在每次打开 Jazz Web UI 时,它都打开新视图。Jazz Web UI 不捕获右键单击,因此您看到的上下文菜单仍然是浏览器的上下文菜单。

创建和编辑工作物件

使用左侧栏中的 New Work Item 链接打开新的工作物件编辑器。富客户端部分中描述的许多有关 创建工作物件 的功能也在该 Web UI 可用。

好消息:当工作物件编辑器具有焦点时,您可以按 <Ctrl>+s 来保存工作物件,而不是使用 Save 按钮。请记住,取决于服务器的配置方式,每当您保存时,可能会向所有订阅者、创建者和拥有者发送电子邮件通知。

可以将“New Work Item”链接添加到书签。

Recently Viewed 列表

在左侧的导航部分,存在一个名为“Recently Viewed”的特殊部分。此部分将列出最后的查询和几个最近打开的工作物件。 此部分不仅只是链接列表!与其他 Jazz 构件不同,Recently Viewed 部分的项中的数据存储在 Web 浏览器上,当您导航到这些项时,它们将立即显示出来而不会从服务器获取数据。例如,当您打开某个查询,然后“展开”到某个工作物件,然后从该工作物件中“展开”到某个相关工作物件时,您刚才查看过的查询和两个项将保留在 Web UI 缓存中;当您使用 Web 浏览器上的返回按钮、“折回”或从最近查看列表选择某个项时,您将在这些项的视图之间非常快速地切换。

好消息:尽管 Recently Viewed 列表提供了当前处理的内容之间非常快速的导航,但是您必须手动刷新这些项,才能查看存储在服务器上的最新更改。

使用 Recently Viewed 的有用提示:

  • 您可以查看哪些工作物件还未保存,因为在 Recently Viewed 列表中,那些项的旁边具有“Save”操作。
  • Recently Viewed 部分显示了最后运行的查询和至少五个最近的工作物件。未保存的工作物件决不会从 Recently Viewed 列表中删除,因此在将多个项保持未保存状态的情况下,该列表可能变长。一个诀窍在于,如果您希望将某个工作物件固定在最近查看列表中,可以对其进行无伤大雅的更改,例如向标记列表添加一个空格。这样该工作物件就会保留在列表中,直到进行保存或刷新为止。
  • 如果单击 Recently Viewed 列表中的查询,则通常会显示您先前离开时的确切查询结果,包括是否对结果进行了翻页。如果单击 Recently Viewed 列表上的“Run”操作,或者单击“My Queries”或“Shared Queries”列表中的查询,则会重新运行该查询,并显示结果第一页中的新结果。(在某些情况下,该查询始终会重新运行。)
  • 当您单击 Web 浏览器上的“刷新”按钮时,将会清空 Recently Viewed 列表——所有未保存的更改也会被清除。只有当前 Jazz 会话中访问过的项才会显示在 Recently Viewed 列表中。

缺省情况下,Recently Viewed 列表中列出的工作物件在 Links 选项卡的“link to work item”对话框中列出(例如,在添加“Related”或“Duplicate”工作物件的时候)。有时,在转到 Links 页面以关联两个工作物件之前,使用快速搜索字段或查询来查找然后打开某个工作物件,以将其添加到 Recently Viewed 列表,这样会更加容易。

例如,如果将缺陷 25130 分配给您,并且您认为它是某个最近分配给您的缺陷的副本,您可以:

  • 运行“Open assigned to me”查询(或某个其他查询)。在浏览结果时,您可能希望单击列标题来按“修改日期”排序,从而首先查看最近的缺陷分配。
  • 当您发现缺陷 23523 与缺陷 25130 相同时,打开缺陷 23523 即可将其添加到 Recently Viewed 列表。
  • 然后在 Recently Viewed 列表中单击缺陷 25130,转到 Links 选项卡,单击“Duplicate Of”。由于缺陷 23523 在 Recently Viewed 列表中,因此在“Select Work Items”对话框中查找它将非常容易。

Link 对话框显示了 Recently Viewed 项

Link 对话框显示了 Recently Viewed 项

查找工作物件

按 ID 或文本内容查找工作物件

使用左侧栏中的快速搜索字段,并输入某个工作物件的 ID 以直接在工作物件编辑器中打开它。

或者,输入某些可能出现在工作物件内容中的任何位置的单词,以查看包含那些单词的工作物件列表。

好消息:如果希望搜索其文本中包括特定数字的工作物件,可以将数字放在引号中。

按筛选器约束查找工作物件(查询)

如果需要对查询结果拥有更多控制,或者需要经常运行同一个查询,可以使用 New Query 链接打开查询编辑器。

打开查询编辑器

打开查询编辑器

可以使用 Add Conditions 按钮 (添加新条件) 添加新条件。每个条件遵循相同的规则:

  • 只要没有输入或选择任何内容,则该条件还不是查询的一部分。
  • 如果选择或输入多个值,这些值将通过 OR 运算进行联结。
  • 变量显示为顶部的复选框。这些变量表示会随时间而变化的值。一个很好的示例是 Current Iteration 变量,此变量始终指向流程规范中标记的当前迭代。变量使您可以用公式来表示在相当长时间内始终保持有效的查询,或者其返回结果将取决于执行查询的用户的查询(例如,通过使用 Current User 变量)。

还可以使用 Add Conditions 控件来添加 OR 和 AND 子句。

查询结果

查询结果视图向您概括显示最重要的工作物件属性。

工作物件属性

工作物件属性

  • 可以通过在筛选文本框中输入内容来进一步改进结果。不包含文本的所有工作物件将从结果列表中动态地隐藏。将考虑所有的可见字段,也就是说,还可以按所有者名称进行筛选。定义不带任何文本条件的查询并直接对结果集执行文本筛选,这通常是个非常好的策略。如果存在多个结果页,筛选框将在当前页中进行筛选。
  • 单击列标题可以相应地对结果集排序。第二次单击某个列标题将按相反顺序排序。
  • 单击 ID 或摘要将在编辑器中打开该工作物件。

工作物件自定义

可以通过各种方式对工作物件组件进行自定义。目前,所有自定义都是在项目区域的流程规范中配置的,并且可以在每个团队区域的流程规范中覆盖前提条件。许多自定义附带了对流程编辑器内容辅助功能(缺省为 Ctrl-Space)的附加支持,以简化 XML 的编辑。预计将来会推出更丰富的编辑 UI。

工作物件类型

您可以定义自己的工作物件类型。类型组织为类型类别,可以从其他自定义中引用这些类别(例如,请参见上面的必需属性):

用于配置 Ready for Shipping (RFS) 工作物件类型的示例 XML。

状态转换策略

可以为工作物件类型定义新的工作流。工作流由状态和定义状态转换的操作所定义。还可以指定解析,不过是可选的。一个工作流绑定到一个或多个工作物件类型类别(请参见上面),每个类型类别应该至多绑定到一个自定义工作流:

用于配置具有三个状态的 Ready for Shipping 工作流的示例 XML:Red、Yellow、Green。

用于将 Ready for Shipping 工作流绑定到 RFS 工作物件类型类别的示例 XML。

自定义属性

可以为工作物件定义自定义属性,以扩展内置属性列表。配置范围界定到类型类别,对于预配置的工作物件类型,类型类别为 "com.ibm.team.workitem.workItemType"(有关如何配置自己的工作物件类型的信息,请参见下面)。自定义属性缺省显示在工作物件编辑器的 Custom 页面上:

用于配置 string 类型的自定义属性的示例 XML。

受支持的属性类型为 smallString、mediumString、string、mediumHtml、html、timestamp、integer、long、boolean 和枚举类型。在定义枚举时,枚举类型被引用来将类型设置成声明为 attributeTypeId 的 ID(请参见上面)。

定义枚举

可以定义枚举属性的字面值集。XML 中的字面值顺序对 UI 是保留的,必须将一个字面值声明为 default。优先级和严重性就是枚举的示例。

用于配置优先级的示例 XML。

必需的属性前提条件

可以在 Required Properties Precondition 中指定必须在保存时设置为非缺省值的工作物件属性。此配置的范围界定到某个工作物件类型或类型类别——对于预配置的工作物件类型,类型类别为 "com.ibm.team.workitem.workItemType"(有关如何配置自己的工作物件类型的信息,请参见下面):

用于使 summary 和 category 成为预配置工作物件类型(com.ibm.team.workitem.workItemType 类别)的必需属性的 XML。工作物件类型 defect 另外还需要 foundIn 属性。

隐含属性前提条件

可以配置隐含属性前提条件,以便自动在工作物件的团队区域更改时取消分配工作物件,以及在工作物件保存期间状态转换为“正在进行”或“已解决”时分配工作物件。此功能划分为可以启用/禁用的子功能。受影响的属性集取决于具体功能:

用于启用隐含属性前提条件的所有功能的示例 XML。

工作物件编辑器

可以在选项卡、部分和表示形式(表示工作物件的某个属性或查看工作物件状态的特定观察点)方面指定工作物件编辑器的结构。此结构信息同时用于 Eclipse 和 Web UI,从而使它们可以具有稍微不同但显示相同元素的布局。

用于显示 Ticket 的编辑器结构的示例 XML。此描述重用了缺省编辑器的某些选项卡和部分。

工作物件组件为最常见的属性类型提供了表示形式,但是也可以提供自定义的表示形式,无论是为了以特定方式显示某个属性,还是为了在编辑器中包括任意信息。表示形式列表通过流程编辑器中的内容辅助功能(缺省为 Ctrl-Space)可用。

然后您可以将编辑器结构绑定到某个工作物件类型。

用于将 Ticket 工作物件类型绑定到某个编辑器结构的示例 XML。

更多的信息和示例可在 这里(Jazz.net Wiki,英文页面)找到。

预定义的工作物件查询

可以配置预定义的查询,这些查询将对项目中的所有用户可用(如果您希望与团队或单独的用户共享查询,请参见 共享查询):

RFS 工作物件的预定义查询的示例 XML。

小而全的示例:Todo 项

在下面的示例中,我们将引入一个新的工作物件类型“Todo”,其具有一个枚举类型的自定义属性。该类型具有自己的工作流、自己的编辑器布局和预定义的查询。

请注意,此示例无法在 Web UI 中正确工作。

必须将下面的 XML 代码片段插入流程规范中的各个 configuration-data 部分。

工作物件类型

让我们首先创建一个具有新的工作物件类别的新工作物件类型(该类别用于将工作流绑定到工作物件类型)。另外我们还添加一个名为 Importance 的自定义属性作为枚举。该类型将匹配下面声明的枚举的类型 ID。

枚举

该枚举具有三个可能的值:LowMediumHigh,其中 Medium 是缺省值。

工作流

Todo 项具有相当短的工作流。在创建时,它们进入 open 状态,然后可以关闭它们。

然后必须将该工作流绑定到工作物件类型类别。

编辑器表示形式

编辑器布局相当简单。我们仅使用一个名为 Overview 的页面,其中具有一个很小的 details 部分和一个 description 字段。我们的自定义属性显示在 details 部分的顶部。

必须将 Todo 工作物件类型绑定到我们的表示形式描述。

预定义查询

能够快速查找打开的 Todo 项是非常重要的。下面的预定义查询将确切地完成此任务。


相关主题


评论

添加或订阅评论,请先登录注册

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=368265
ArticleTitle=Jazz 系列: 开始使用工作物件
publish-date=06092008