教程:探究 Rational Team Concert JUnit 示例项目

本简要指南是 Rational® Team Concert JUnit 示例项目的配套资料。它提供了高度概述,以使您能够独立开始进行探究。
JUnit 项目基于实际的软件开发项目,其目标是交付 JUnit V4.4。团队正在使用 Rational Team Concert 进行计划、跟踪、协作以及交付发行版。当在 Jazz™ Team Server 上创建了样本 JUnit 项目时,您将看到现有工件,就像团队已经开始执行工作一样。

学习目标

通过阅读本指南,您将了解足够多的知识,以便可以开始体验本产品和学习更多知识,但是它不会逐步指导您完成此项目。

    1. 创建 JUnit 示例项目
    2. JUnit 项目区域用户和客户访问许可证
    3. JUnit 项目迭代和已计划的工作
    4. JUnit 项目源代码
    5. JUnit 项目构建
    6. JUnit 项目报告(仅限于标准版)
    7. 在 Web 界面中探究 JUnit 项目

所需时间

20 分钟

1. 创建 JUnit 示例项目

要在 Jazz Team Server 上创建 JUnit 示例项目,您必须具有 JazzAdmin 许可权并且已为您分配了开发者客户访问许可证。
打开“Team Concert 示例项目设置”向导:单击文件 > 新建 > 示例并按照提示信息来安装 Team Concert 示例项目

2. JUnit 项目区域用户和客户访问许可证

JUnit 示例项目包括八个用户。您可以作为其中的任何一个团队成员登录至此 JUnit 项目,以获取角色和分配情况的不同透视图。但是,要作为其中一个用户来充分探究此 JUnit 项目,需要为此用户分配开发者客户访问许可证。可以为此示例分配的许可证数目受到服务器上剩余的许可证数目的限制。
关于此任务
提示: 每个用户的初始密码就是他们的用户标识。例如,Bill 的初始密码就是“bill”。如果您打算在测试服务器上进行大量探究工作,那么您可能需要更改这些初始密码。
表 1. JUnit 项目区域中的用户
用户 用户标识/密码 角色/描述
Bill Cassavelli bill / bill JUnit 团队负责人。Bill 是 JUnit 团队的组件负责人。他设置了迭代计划,并且是此发行版的多个高级工作项的所有者。
Build build / build 将运行构建的特殊用户
Freddy Freund freddy / freddy  
Jason Mitchell jason / jason JUnit 团队成员。为 Jason 分配了许多工作项。
Jennifer Ginness jennifer / jennifer  
Markus Kent markus / markus JUnit 团队成员。为 Markus 分配了许多工作项。
Marlene Stamp marlene / marlene  
Rick Yuen rick / rick  
客户访问许可证用于控制为哪些用户授予对于 Jazz Team Server 上的某些功能部件的访问权。可用的客户访问许可证数目取决于您正在使用的 Rational Team Concert 版本。通常,具有开发者客户访问许可证的用户有权创建工件,而具有添加者客户访问许可证的用户可以创建工作项,但是只能查看其他的大多数工件。

有关更多信息,请参阅 Rational Team Concert 1.0.1 版本和许可证管理客户访问许可证

要为用户分配许可证:

  1. 作为一个具有管理员特权的用户(在新的服务器安装中为 ADMIN/ADMIN)登录至 JUnit 项目区域。
  2. 在“团队组织”视图中(窗口 > 显示视图 > 团队组织),右键单击 Markus Kent 并单击打开
  3. 客户访问许可证下面的“用户”编辑器中,选择 Rational Team Concert - 开发者并单击保存

    此图显示“用户”编辑器和正在定义的客户访问许可证

结果

团队组织视图仅显示属于 JUnit 团队的用户。要为其他用户分配客户访问许可证,请使用 Jazz Team Server Web 界面(单击 Admin > 用户管理)。此界面将列示服务器上的所有用户:

Jazz Team Server Web 界面的“用户管理”部分

提示:

要作为另一个用户进行登录,请修改存储库连接属性并指定另一个用户标识:

更改连接属性以作为另一个用户进行登录

3. JUnit 项目迭代和已计划的工作

JUnit 项目要使用一种敏捷的迭代方法来完成 JUnit 的 4.4 发行版。团队正在遵循 Eclipse Way 流程并且已经定义了多个迭代。对于每个迭代,团队已经创建了一个计划文档并且已经为此迭代定义了工作项。
  1. 可以通过在“项目区域”编辑器中打开 JUnit 项目来查看流程迭代:

    JUnit 流程迭代

  2. 要检查迭代计划,从“团队工件”视图中打开一个计划:

    “团队工件”视图用于显示 JUnit 计划的“计划”节点

  3. 查看 JUnit 4.4M2 迭代计划。在已计划的项选项卡中,可以查看已为此迭代计划的所有工作项。

    提示: 在计划编辑器中,可以通过使用下拉菜单来快速更改工作项的某些属性:

    从计划编辑器中更改工作项的属性

  4. 要查看工作项的详细信息,在已计划的项页面中双击此项。此项将在工作项编辑器中打开。在此编辑器中,可以根据您的角色和流程配置来进行更改。

    例如,如果您已作为 JUnit 团队成员 Markus Kent 进行登录,那么请尝试使用探讨部分对此工作项添加注释:

    显示了探讨内容的工作项编辑器

4. JUnit 项目源代码

JUnit 代码位于 Jazz Team Server 存储库中的源代码控制下。Markus 和其他团队成员(即,您为其分配了开发者客户访问许可证的团队成员)能够将更改传递给流。
关于此任务

团队工件视图中,您可以看到 JUnit 项目中包含称为 JUnit 的单个源代码控制流,此流归 JUnit 团队所有。此流中包含也称为 JUnit 的单个组件。在以下屏幕快照中,JUnit 组件位于初始基线中。

显示在“团队工件”视图中的 JUnit 流、组件和已装入的存储库工作空间

在上述屏幕快照中,您还可以注意到当前用户已经装入了一个称为 JUnit 的存储库工作空间。您可以搜索和装入其他用户的存储库工作空间,也可以创建您自己的存储库工作空间。

装入了存储库工作空间之后,已装入的组件中包含的项目将可供您在开发环境中使用。JUnit 组件中有三个项目:

已装入包资源管理器中并且在其中可视的 JUnit 源代码项目
在进行了初步探究之后,您可能想了解有关某些 Jazz Source Control 概念和任务的更多信息。

请阅读 Jazz Source Control概述一节,以了解有关流、组件、存储库工作空间和其他概念的更多信息。

尝试更改 Java™ 文件,并在“暂挂的更改”视图中传递此更改。最佳办法是使您所作的更改与相关工作项关联。
在“暂挂的更改”视图中传递变更集

5. JUnit 项目构建

JUnit 项目包含一个构建定义和一个构建引擎。要探究和尝试使用 JUnit 构建,您将需要使用单独安装的构建工具箱来设置和启动构建引擎。
开始之前
  • 要运行构建引擎,必须已经安装了 Rational Team Concert Build System Toolkit。可以在安装启动板中安装此工具箱,也可以从 jazz.net 站点下载此工具箱。如果安装了此工具箱,那么您将具有 installdir/buildsystem 文件夹。
  • 在此 JUnit 示例中,必须为用户标识“build”分配一个构建系统客户访问许可证。
关于此任务
要为 JUnit 项目启动构建引擎:
  1. 在命令行中,导航至 installdir/buildsystem/buildengine/eclipse,其中 installdir 是安装目录。
  2. 请输入以下命令:
    jbe -repository https://localhost:9443/jazz -userId build -pass build -engineId junit -sleeptime 5
    使用构建工具箱成功启动此引擎之后,它将等待传入请求。仅支持已被定义为在此特定构建引擎上运行的构建定义。

    显示了一个正在运行并且正在等待请求的构建引擎的命令窗口

  3. 请求 junit 构建:

    请求构建

  4. 完成构建之后,在构建视图中打开构建结果。查看构建结果的摘要编译JUnit 选项卡,以了解您在构建结果中可以看到的信息类型。
下一步做什么
提示: 尝试安排每隔 30 分钟就自动运行一次 junit 构建。为此,编辑构建定义的时间表选项卡(右键单击“团队工件”视图中的 junit 构建并单击打开构建定义)。

请阅读“帮助”中的使用 Jazz 进行构建一节,以了解有关团队构建以及如何管理构建的更多信息。您还可以开始了解构建 Ant 任务,编写您自己的构建脚本时就可以使用这些 Ant 任务。

6. JUnit 项目报告(仅限于标准版)

如果您打算对 JUnit 项目进行深入探究,那么您将能够使用报告来跟踪进度,还可以监视 JUnit 项目区域和团队。但是,因为报告需要历史聚集数据,所以 JUnit 项目没有任何初始数据点来开始构建报告。
关于此任务
报告将使用数据仓库,数据仓库通常每天生成存储库数据的快照。这些快照提供了报告所需要的历史数据点。如果您想查看 JUnit 的报告,那么将需要在一定时间内启动一个或多个快照。例如,您可以现在生成一个快照,然后传递一些代码更改、运行一些构建或者打开一些工作项,接着再生成另一个快照。

要手动启动数据的快照:

  1. 确保 Markus Kent 具有 JazzDWAdmin 许可权,然后作为 Markus 登录至 Rational Team Concert Web 界面。
    注: 如果您为 Markus Kent 授予了 JazzAdmin 许可权,那么他可以为他自己分配 JazzDWAdmin 许可权。否则,您必须使用您自己的用户标识进行登录才能为 Markus 授予 JazzDWAdmin 许可权。
  2. 转至报告页面并单击管理数据仓库
  3. 单击更新所有快照数据
结果
在具有表示多个时间点的多个快照之后,您将开始看到 JUnit 项目的报告中有多个值。
下一步做什么
可以从以下两个位置来运行报告:
  • Web 界面的报告页面:

    Web 界面的“报告”页面

  • 团队工件视图中的 JUnit 项目下的报告节点:

    从“团队工件”视图打开的报告

请阅读“帮助”中的使用报告来跟踪数据一节以了解有关报告功能的更多信息。

7. 在 Web 界面中探究 JUnit 项目

本指南的大部分已经使您对富客户机有了大致的了解。Rational Team Concert Web 界面还提供了一个丰富的环境。在此环境中,您可以实现许多与团队协作才能实现的目标。
关于此任务

Web 界面中的 JUnit 项目

要在 Web 界面中探究 JUnit 项目区域:
  1. 打开浏览器并浏览至 Web 界面。如果您正在本地运行,那么缺省 URL 为:

    https://localhost:9443/jazz/web/projects/JUnit%20Project

  2. 查看 Web 界面。例如:
    • 工作项页面上查找和创建工作项
    • 源代码控制页面上浏览存储库中的源代码
    • 迭代计划页面上复查项目计划
    • 使用仪表板页面上的团队仪表板和个人仪表板(仅适用于标准版)
    • 报告页面上查看项目状态和进度(仅适用于标准版)

总结

在此简易教程中,您了解了 JUnit 示例项目的基础知识。JUnit 项目是您探究和开始了解如何使用 Rational Team Concert 来与团队协作完成软件开发项目的绝佳途径。
切记: 完成使用 JUnit 示例项目之后,请除去示例用户的客户访问许可证。这将释放许可证以便分配给实际的用户。
要获取更有用的指示性信息,请参阅下列入门主题:

反馈