教程:探查 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 项目报告(仅限于 Standard Edition)

    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 2.0.0.2 版本和许可证管理客户访问许可证

要为用户分配许可证:

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

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

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

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

提示:

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

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

3. JUnit 项目开发段和已计划的工作

JUnit 项目使用 Scrum 作为它的过程。Scrum 是一种流行的项目敏捷管理方法。对于每个迭代(称为开发段),团队已经创建了一个计划文档并且已经为该开发段定义了工作项。
  1. 您可以通过在项目区域编辑器中打开 JUnit 项目来查看过程开发段:

    JUnit 过程迭代

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

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

  3. 查看 JUnit 4.4 s2 开发段储备计划。在计划的项选项卡上,计划编辑器提供了工作项预览方式,此方式为您提供了可显示计划重要属性的直接插入工作项编辑器。

    JUnit 4.4 s2 开发段储备计划

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

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

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

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

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

4. JUnit 项目源代码

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

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

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

在以上屏幕快照中,当前用户已装入一个名为 JUnit 的存储库工作空间。您可以搜索其他用户的存储库工作空间,然后复制这些工作空间并将其装入;您也可以创建自己的存储库工作空间。

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

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

请阅读 Rational Team Concert 源代码控制概述一节,以了解有关流、组件、存储库工作空间和其他概念的更多信息。

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

5. JUnit 项目构建

JUnit 项目包含一个构建定义和一个构建引擎。要探查和尝试使用 JUnit 构建,您必须使用单独安装的构建工具箱来设置和启动构建引擎。
  • 要运行构建引擎,必须已安装 构建系统工具箱。可以在安装启动板中安装此工具箱,也可以从 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 选项卡,以便了解您在构建结果中可以看到的信息类型。
  5. 可选: 要安排每隔 30 分钟就自动运行一次 junit 构建,请执行下列操作:
    1. 团队工件视图中,右键单击 junit 构建,然后单击打开构建定义
    2. 在构建定义编辑器中,单击时间表选项卡。
    3. 选中已启用复选框。
    4. 连续时间间隔(分钟)字段中,输入 30
    5. 单击保存
    构建定义的“时间表”选项卡
请阅读“帮助”中的使用 Jazz 团队构建进行构建一节,以了解有关团队构建以及如何管理构建的更多信息。您还可以开始了解构建 Ant 任务,编写您自己的构建脚本时就可以使用这些 Ant 任务。

6. JUnit 项目报告(仅限于 Standard Edition)

如果您打算对 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 界面。例如:
    • 工作项页面中,查找和创建工作项。
    • 源代码控制页面中,浏览存储库中的源代码。
    • 计划页面中,复审项目计划。
    • 仪表板页面中,处理团队和个人仪表板(仅限于 Standard Edition)。
    • 构建页面中,查看构建定义和结果并请求执行构建。
    • 报告页面中,查看项目状态和进度(仅限于 Standard Edition)。

总结

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

反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误