- 下载这个软件并设置它的环境
- 下载 Rational Team Concert (Jazz Team Server, Jazz 客户端,等等)的插件
- 下载 Mozilla Firefox 的插件和附加软件
- 设置 Project Area
- 理解各种视图
- Team Artifact 视图
- Work Item视图
- Pending Changes视图
- 添加用户到这个 Project Area
- 修改用户参数
- 创建一个 Team Area 和增添用户
- 在流程中创建组件
- 定义一个整合流程
- 管理这个 Project Area
- 创建工作条目并将它们分配给用户
- 创建一个储存库工作空间
- 创建空白的项目并交付它们
- 链接工作条目
目标
在这篇文章中,您要学习如何
- 在运行着 Microsoft®Windows®的机器上下载和安装 Jazz 服务和客户端
- 下载和安装 JUnit, 编译所需的额外插件,以及 Aptana 和 Mozilla Firefox 插件
- 理解 Rational Team Concert 中的 Jazz 专业术语以及视图。
- 创建一个 Project Area 以及这个项目的基本构架
前提条件
这篇文章假定您对 Eclipse™IDE 的概念已经非常熟悉,包括视图,编辑程序,面板等等。我们还假设您已经理解企业层次开发的各种概念,比如资源文件管理,项目管理,以及缺陷管理。
系统需求
- 访问 Jazz.net 或者任何其它您可以下载 Rational Team Concert 的位置
- Microsoft Windows 操作系统带有一个一分钟 1Gb of RAM
- Mozilla Firefox Version 2.0.0 对这个应用软件使用带有基于 Web 的界面
设置这个环境
在编写这篇文章时,我们使用了 Rational Team Concert Beta 3 RC5 资源和二进制文件。这些都可以从 Jazz.net 网站免费下载 (请参见 参考资源)。
在这篇文章的发布的时候,Rational Team Concert Version 1.0 可以从下面的链接中获得。额外组件的版本将会变化,在需求组件版本的基础上。
要设置一个开发环境,您需要下载表格 1中所显示的包。
表格 1. 所需的组件
Package | Comment | URL |
---|---|---|
Jazz 二进制和源文件 | 客户端和服务器二进制以及源文件(需要登陆) | Getthe 文件 |
提取这些文件到您机器的某个位置,比如 C:\Jazz
。我们在这篇文章的后面部分将这个位置看作 <install loc>。如果您在提取文件时候有任何问题,您可以寻找详细的指令来提取这些插件,而设置 Rational Team Concert 的指令可以在 组件开发页面中百科全书中找到。
下载额外的组件
默认情况下,只有所需的插件被打包。因为您将在这个 Jazz 平台上构建,您需要添加表格 2中所显示的插件。
表格 2. 额外的组件
Component | Comment | URL |
---|---|---|
JUnit 插件 | JUnit 插件二进制文件 | JUnit 插件文件 |
EMF 完整插件 | 用于建模的完整 EMF 插件(v 2.3.2) | EMF 插件文件 |
编译插件 | 在 EMF 代码发生器上打包 | Getthe 代码插件 |
Aptana 插件 | JavaScript 编辑器 | 将 Aptana 插入一个现存的 Eclipse 配置中 |
在 <install loc>
中提取这些插件,并且在这里您已经拥有了 Jazz 和 Rational Team Concert 的客户端和服务器二进制文件。
为了调试而添加 Mozilla Firefox 插件
在这个系列随后的部分中,您将为您的应用软件创建一个 Web 客户端。列在表格 3中的插件对于调试 JavaScript 和 HTML 页面十分有用。
表格 3. Mozilla Firefox 附加软件
Add-on | Comment | URL |
---|---|---|
Venkman | 纯粹 JavaScript 调试器 | 获取 JavaScript 调试器 |
Firebug | JavaScript, CSS, HTML 调试器都有运行时间编辑性能 | 获取 Firebug |
提示:
- 在 Mozilla Firefox 的错误关机,或者有一个错误脚本的情况下,这些附加软件就会不起作用。在极端条件下,您可能不能激活 Firefox 实例中的插件。
- 要解决这个问题,通过选择 File > Exit 来关闭所有的 Mozilla Firefox 实例。如果您的修改没有反映在这些 Web 页面中,尝试清除 Firefox 缓冲。记住要清除 Authenticated Sessions 从而在调试模式中打开 Web 页面。
设置 Project Area
既然您已经下载了所有的插件并且进行了提取,那么说明您已经准备号启动这个服务器了。您将会链接它,并创建一个 Project Area,然后进一步修改。
- 打开这个安装位置(例如, C:\Jazz) 并导航到<install loc>/jazz/server。
- 双击这个server.startup.bat文件,也正式您启动服务器的位置。这将弹出服务器控制窗口,您就能够看到这些消息。
提示:
无论什么时候您想要关闭这个服务器,通常只需要使用相同位置中的 server.shutdown.bat文件即可。服务器的不正常关闭将会导致不一致的状态。
创建一个 Project Area
一个Project Area就是您将管理所有 与这个项目相关工作的位置。这将包括 Team Area, 各种流程(比如代码,整合,等等),组件,工作条目等等。一个服务器可以托管多个 Project Areas,但是每个的数据都是分别管理的。
首先,您将创建一个到这个服务器的链接,然后在这个服务器中创建一个 Project Area
- 导航到 <install loc>/jazz/client/eclipse,并选择 TeamConcert.exe 文件,从而打开这个应用软件。
- 选择一个工作空间位置,比如 C:\TestWorkspace,点击OK。
当 Rational Team Concert 启动之后,您将会看到与图 1所显示的类似屏幕。
图 1. Rational Team Concert 视图
- 左边的视图是 Team Artifact 视图,它提供了您 Project Area 中简易的导航。
- 点击 Team Artifact 视图中Create Repository Connection链接。
图 2. 创建 Repository Connection
- 键入 URL 地址
https://localhost:9443/jazz
以及用户名称和密码作为ADMIN
。 - 更改链接超时为
4800
。
注意:
我们使用 localhost
,因为我们将运行在同样机器上的服务器作为客户端。如果这个服务器运行在一个远程机器上,那么我们将拥有这个 IP 地址和这台机器的网络名称。因为我们拥有一个新的服务器在运行,我们使用 ADMIN
作为这个用户名称和密码。当我们设置这个 Project Area 之后,我们可以添加用户。因此,用户可以通过使用自定义用户名和密码来访问这个 Project Area。
提示:
- 这个服务器 运行时,要能够通过使用 Rational Team Concert 客户端来链接到服务器。如果您看到一个“登陆失败”的消息,很可能是服务器还没启动。核查这个服务器控制台上的“INFO: Server startup inxxxxms”消息。如果您没有看到这条消息,那就等待,然后尝试再次登陆。
- 使用 Beta 3, Jazz 已经在鉴定的基础上增加了限制。我们将明确地运用特定额外的优先权,从而允许 ADMIN 用户来创建一个 Project Area。
- 右键点击这个存储库链接,并选择 Administer > Open users。
- 在这个对话框中,键入
ADMIN
,点击 Select 来选择用户,然后点击 Finish。 - 在这个 ADMIN 用户页面上,在 Client Access License 部分,通过选择所有的三个复核框就可以允许 ADMIN 访问所有区域。
- 保存这个用户参数,并关闭这个编辑器。
图 3. 激活 ADMIN 许可
这个 Team Artifact 视图显示了链接和其它的信息(请参见图 4)。现在您将创建一个 Project Area。
- 右键点击这个存储库链接,并选择 New > Project Area(请参见图 3)。
图 4. New Project Area
- 键入
PetStore
作为这个名称,点击 Next。 - 选择 Deploy Template。 (这样部署了由 Rational Team Concert 提供的默认过程定义。)
- 选择 Process 的The Eclipse Way(图 5),保留剩余区域的默认设置,并点击 Finish。
图 5. Eclipse Way
这将创建一个名为 PetStore 的 Project Area,并用您所选择的过程来对它进初始化。
Explore Rational Team Concert 视图
当创建这个 Project Area 时候, are various views in Rational Team Concert 中的各种视图都与图 6中所显示的十分相似。如果不看这个屏幕,选择Windows > Show View可以获得这个 Views 菜单。
图 6. Views
Team Artifacts 视图
有一个可视的 PetStore Project Area,并且现在拥有各种次节点:
- 构建:当您为您的项目定义了一个构建脚本后,您将能够启动一个构建,而且还可以从这个部分看到过程中的构建状态和构建报告。您还可以配置您的构建来自动运行。
- 计划:因为我们使用 The Eclipse Way 作为这个过程,因此您将跟随这个敏捷过程来开发。在这个部分,您可以定义您的整合计划和里程碑。
- 报告:有各种报告都是为您的 Project Area 预先创建的。您还可以为了分析的目的而创建自定义报告。
- 流程:这个开发过程可以被定义,从而因各种理由而使用多种流程。例如,可能会有一个 Milestone 6的开发流程,一个 Milestone 5的稳定流程,还有 Milestone 4维持系的另一个流程。
- 工作条目:与报告类似,您可以定义一个疑问或者使用一个共享的疑问来取回工作条目。工作条目可以是各种类型,比如缺陷,任务,或者加强需求。构建 Jazz 工作条目,这样您就可以定义您自己的工作条目类型。
- 收藏夹:您可以选择一个工作条目,并将它添加到您的收藏夹列表中。这样,更改设置或者您已经更改以及即将交付的文件就会自动链接到您的 Favorites 中的工作条目。
- 信息源:通常的信息源机制是构建在 Jazz 中的。更新将会通过信息源反映。
- 工作空间:在 My Repository Workspace 下面,有一个 PetStore Team Stream Workspace,它是自动创建的。这就是工作区域,将会存储您所有的文件(对于 IBM®Rational®ClearCase®用户,这与view十分相似)。除非被明确地交付,否则这些文件在流程中将不会被交付。
- Team Areas:这个部分显示了您将成为其中一部分的各种 Team Areas。在相同的项目中可能会有多个 Team Areas,但是单一的贡献者可以是多个 Team Areas 的一部分。
- Work Item History:这显示了您曾经访问过或者修改过的最新工作条目。
Work Item 视图
一个工作条目就是在这个项目区域的领域完成的事件。比如它可能是一个任务,一个缺陷,或者一次增强。这个 Work Item 视图(图 7)显示了工作条目的列表。您可以在运行时间,通过选择您想要看到此工作条目的专栏来自定义这个视图。您还可以通过拖拽边框来修改这个专栏的宽幅。双击这个视图,在这个编辑器中打开工作条目。这个多页面工作条目编辑器十分有用。您马上就会看到如何使用它。
图 7. Work Item 视图
添加用户到这个 Project Area
您将为 PetStore 项目创建两个用户,Joe 和 Larry。(您可以使用相同的过程来创建更多的用户。)
- 右键点击 Team Artifact 视图 (图 8)中的Project Area,打开这个项目区域。
- 展开这个 Members 部分并选择 Create。
- 选择 Create User并点击 Next
图 8. Create User
- 键入 Joe 的详细资料:
- Name:Joe
- User ID:joe
- E-mail 地址:joe@petstore.com
- 点击Next.
- 在下一个屏幕中,提供这个用户的 Repository Group 许可。对于 Joe 来说,使用 JazzUser 许可级别,然后点击 Next。
- 要提供 Client Access License,通过点击每个复核框来选择Contributor和Developer路径。
- 点击 Finish 从而关闭这个对话框。
注意:
因为对于这篇文章,我们使用的是这个软件的试用版,所有只有十个用户能够扮演 Contributor 和 Developer 的角色。Rational Team Concert 和 Jazz 的完全版本可以许可更多的用户。
- 使用另一种类似的方法,创建另一个叫做
Larry
的用户,具体资料如下:- Name:Larry
- User ID:larry
- E-mail 地址:larry@petstore.com
- 点击 Next。
- 分配这个 Repository Group 为 JazzUser。
- 分配这个用户的 Client Access License 为 Contributor 和 Developer。
- 您希望两个用户都能够贡献于这个项目,因此将他们分配为 Contributor叫色。
- 从 Project Area 中的 Member 部分选择新近创建的用户 Joe,然后点击 Process Roles。
- 从可使用的角色中选择 Contributor,然后点击 Add(请参见图 9)。
图 9. 为用户分配角色
- 为 Larry 重复此过程。
- 使用 CTRL+S 保存这个过程。
- 您可能会问,如果您想要给新近添加的用户发送电子邮件通告该如何操作。点击 OK就会发送电子邮件到您所键入的所有电子邮件地址的用户。
修改用户参数
Jazz 允许用户通过使用 User Preferences 来修改他们的背景文件。用户可以修改他们的背景资料,自定义他们的电子邮件参数,长传他们背景资料中的图片,以及通过使用 Rational Team Concert 来安排他们的时间消耗信息。接下来,您将修改用户 Joe ,为他长传一个 图片并定义他的电子邮件警告。
- 通过选择从而打开这个 Windows > Show View > Others > Team > Team Organization 从而打开这个 Team Organization 视图。
- 右键点击 Joe,并选择 Open,打开这个多页面编辑器。
- 在这个 Overview 页面上,打开 Photos部分,浏览并上传任何您想要为这个用户添加的图片信息。您将看到您上传图片的预览图。
- 在这个编辑器中选择 Mail Configuration 页面。
- 不选择 Tags Added of Removed 选项的复选框。当标签为一个特定的工作条目而修改后,就会使电子邮件的通告功能失效。
- 您还可以通过复核 Format 板块下的复选框激活电子邮件消息的 HTML 格式化。
- 保存这个用户参数并关闭编辑器。
图 10. 修改 User Preferences
提示:
如果您想支持任何由一个特定用户产生的事件通告(例如,Creation of Work Item 或者 Modification),可以右键点击这个用户名称并选择Subscribe to Events Generated by User。那么无论这个用户什么时候发生制造事件,您都会收到一个通告。
创建一个 Team Area
- 要创建一个新 Team Area,打开编辑器中的这个 Project Area,如果它还没有被打开的话。点击 Project Area 标题旁边的箭头,并导航到Team Area 选项(图 11)。
图 11. Team Area 视图
- 选择现存的存储库链接,并点击 Next。
- 键入名称为
Core
(请参见图 12)。 - 键入小结为
这个 Team Area 将由开发团队构成
。 - 点击 Project Area 旁边的 Browse 按钮,并选择 PetStore。
- 如果 Main Development 没有被选作开发线,那么就点击 Browse 并选择 Main Development Line。
- 保留其它选项的默认设置,并点击 Finish。
图 12. 创建新的 Team Area
添加用户到 Team Area
当您创建 Team Area 完成之后,它将在这个编辑器空间被打开,这时您可以添加用户。
- 点击 Members部分,如果它被缩起来,就打开它。
- 点击 添加用户(到现存的用户)(图 13),选择 Joe 和 Larry,并点击 Next。
图 13. 添加用户到 Team Area
- 选择 Contributor 作为角色,然后点击 Finish,从而关闭这个对话框。这样将会添加用户到 Team Area。
提示:
您还可以从这个页面中创建新用户,然后将它们添加到 Project Area。
- 创建一个新用户,
John
,它将成为这个团队的领头角色:- 名称:John
- User ID:john
- E-mail 地址:john@petstore.com
- 点击 Next。
- 选择这个存储团队的 JazzUser,并点击 Next。
- 选择 Contributor和 Developer 作为 Client Access 许可,然后点击 Finish(请参见图 14)。
图 14. Client Access License 视图
- 从 Member 板块中选择 John,并点击 Process Roles。
- 选 Team Leader 为 Role,点击 OK。从而关闭此对话框。
- 保存这个 Core Team Area。
- 在 Save 板块,选择您想要发送电子邮件的用户,然后点击 OK。
默认情况下,因为您在 Team Area 中创建了 John 这个用户,John 不会访问 Project Area。因此,您需要将 John 添加到 Project Area 成员中。请参见这篇文章中详细叙述的添加用户到项目区域部分。
在工作流程中创建组件
一个项目可以包括多个组件。对于这个练习,您将创建一个名为 PetStore 的组件,在这里您将添加新的插件项目。您可以在您的存储库工作空间创建组件 ,然后将它们交付给这个流程。假定您没有操纵您的存储库区域,您将从流程定义开始做起。在这个系列后面的文章中,我们将解释如何从工作空间修改这个流程,并将它交付给 Project Area。
- 在 Team Artifacts 视图中,导航到 PetStore Project Area > Streams > PetStore Team Stream。
- 如果您打开 PetStore 团队流程,您将看到 Jazz 已经创建了一个默认的组件。双击这个流程,然后双击工作空间右上方的 PetStore Team Stream 键,从而展开这个流程定义视图。
- 在 Components 板块之下,选择这个默认组件,然后将它清除。
- 点击 New(图 15),然后点击 OK,就可以得到任何您获得的警告。
- 将
PetStore
作为这个组件的名称,然后点击 OK。 - 保存这个流程定义。
图 15. 添加一个新组件
定义一个流程
一个项目在整个开发周期中可以拥有多个流程。例如,在敏捷开发中,当前重大事件应该是 M5,但是对于 M4维护的安装齿片您可能有另一个隔离流程。另一个情景可能是,一个产品包含各种小型项目,所有项目都有一个单独的流程。对于这个项目的构建,所有的内部项目流程都应该归于叫做整合流程的流程。从这开始,整个项目都被构建。您将定义一个整合流程,从这开始您将构建您自己的应用软件。主要流程(PetStore Team Stream)和它的各种组件都将归于这个整合流程。
- 在 Team Artifact 视图中,右键点击 Stream节点并选择 New Stream。
- 命名为
PetStore Integration Stream
(请参见图 16)。 - 浏览并选择这个流程的 Owner 为 Core [Main Development]。
- 在 Flow Targets 可折叠板块之下,点击 Add。
- 选择 PetStore Team Stream。这将激活这个流程,从而归于整合流程。
- 选择 PetStore stream 并点击右边的 Edit按钮。
- 您需要将这个流程中所有的组件都归于 PetStore 整合流程;因此,选择 Flow all components 单选按钮,并点击 OK。
- 在继续之前保存这个流程。
图 16. 创建一个新流程
管理这个 Project Area
接下来,您将为 John ,这个团队领导创建一个工作任务,给他创建一个空白项目,然后将它们放在 Project Area 中共享。John 没有关于为他创建的工作条目的消息。当他被添加到 Team Area,并且当这个工作条目分配给他时,他将收到电子邮件的通知。
创建一个工作条目并将它分配给一个用户
- 从这个 File 菜单中,选择 New > Others。
- 从这个向导中, Work Items 节点之下,选择 Workitem 并点击 Next。
- 选择 PetStore Project Area 并点击 Next(请参见图 17)。
- 下一个屏幕将要求您具体说明这个工作条目的类型。默认情况下,为 Rational Team Concert provides Defect, Task,以及其它工作条目类型,这些都列于此屏幕之上。选择 Task 并点击 Finish。
- 在这个工作条目编辑器中,键入这个消息:
- 小结:创建项目构架,并使它们在 PetStore 项目区域共享
- 描述:创建三个插件项目:
- com.ibm.petstore.example.common
- com.ibm.petstore.example.service
- com.ibm.petstore.example.web
- 将这些项目添加到 Core 组件中。
- 更改 Filed Against 为
PetStore
。 - 您需要将这个工作条目分配给团队领导,John,这样就可以将 Owned By 区域更改为
John
。 - 更改 Priority 为 High,并更改“Planned for”为
M1
。
注意:
因为您正将 Eclipse 方法作为过程和敏捷计划使用,Rational Team Concert 已经创建了 Milestone 1 (M1),您要把这个工作条目分配给那个里程碑。
图 17. 创建工作条目
这个分配给 John 的工作条目在 流程,组件,构建系统,等等方面需要修改,但是只有那些拥有一定优先权的用户才可以进行。使用 Jazz Beta 3,每次安装仅仅只有一个用户拥有 Administrator 权。在这种情况下,目前就是 ADMIN 用户。因此,ADMIN 将重新分配管理员权力给 John,这个团队的领导。
- 在 Team Artifacts 视图中,右键点击这个存储库链接,选择 Administer 和 Open Users。
- 键入
ADMIN
作为 这个用户的名称,点击 OK。 - 在这个 ADMIN 用户页面,在 Client Access License 板块,选择Build System复选框,并保存这个用户的定义。
- 按照相同的步骤,为这个用户 John 打开入口,并选择 Client Access License 板块中的 Build System 复选框。
- 在 Repository Group 部分,选择 Jazz Admins,这样 John 也就拥有了 Administrator 权限。
- 保存这个用户的定义。
您已经完成了 ADMIN 用户必须完成的一些最初的任务。您现在将作为 John 登陆并完成剩下的任务。您可以有两种方式来完成,要么通过更改这个存储库链接的用户名称密码从相同的 Rational Team Concert 例子开始,要么从不同的机器或者 Rational Team Concert 实例登陆。
以 John 的名义登陆 (使用 john
作为用户名和密码),参考这篇文章最初部分,您创建存储库和作为 ADMIN 用户登陆的地方。
注意:
默认情况下,所有的用户都拥有相同的用户和密码作为他们的用户名。
作为 John 登陆到这个 Project Area,他将看到他的 Team Artifacts 视图,这与图 18中所显示的十分相似。
图 18. Team Artifacts 视图
在 Team Artifacts 视图中,John 可以看到 ADMIN 所做的所有的变更。他可以看到这个 Project Area,流程组件,他的 Team Area,以及 Team Area 中的其他用户。同样,其他用户 ,Joe 和 Larry,也能看到这些变更。
接下来,您将打开My Work视图,查看分配给 John 的工作条目,并且您将修改这个工作条目的估算时间。
- 导航到 Window > Show View > Others > Workitems > My Work。
- 您将看到新进分配的工作(PetStore),这里有 ADMIN 昨天创建并分配给 John 的工作条目。
- 双击 Summary ,将打开这个工作条目的描述。这是一个工作条目的快速预览图。
- 点击这个工作条目右角上的时钟图标,将估算时间更改为4 小时(图 19)。
图 19. 为这个工作条目提供一个估算时间
- 点击内框中的 Accept all Work链接,这样您就可以保存您对这个工作条目的估算。
- 使用 My Work 视图内侧的 Save 图标保存带有您的估算的工作条目。
- 这个视图底端的测试盒可以允许您搜索,筛选,以及用颜色标码工作条目。这个视图还允许您将工作条目从一个板块拖拽到另一个。
- 您还可以打开这个 Work Item 视图,看到被分配给您的工作条目。双击这个工作条目,他将会被打开,您可以修改这个编辑器中区域(图 20)。
图 20. 工作条目编辑器
注意:
这个工作条目中的估算时间显示为4小时,这是我们从 My Work 视图中修改过的。
创建存储库工作空间
John 意识到要完成这个工作条目,他需要一个工作空间来创建项目。然后,从这个工作空间,他可以交付变更到流程。
- 在这个 Team Artifacts 视图中,右键点击 My Repository workspaces ,并选择 New Repository workspaces
图 21. 新存储库工作空间
- 选择这个流程:
- 从这个 Repository 下拉菜单中,选择 john@localhost。注意:如果这个服务器在远程机器上运行,localhost 将被这个机器的网络名称所替代。
- 选择 Flow with the stream 的单选按钮。选择这个选项可以使您接受这个流程中最新的变更。当其他人核查他们的代码时,您将看到它像引入您的工作空间一样。
- 选择 PetStore Project Area 和 PetStore Team Stream(请参见图 22)。
图 22. 为这个存储库选择一个流程
- 您可以更改这个工作空间的名称,但是现在,要保留默认设置,并点击 Next。
- 下一个屏幕显示了流程中各种组件,包括 PetStore组件。选择它并点击 Finish。
- 这将为 John 创建一个存储工作空间。
- John 将被提示上载这个存储库。执行这个动作将会取 John 本地工作空间中的存储库中所有可使用区域。因为在这个存储库中还没有任何文件,您目前可以跳过这一步。点击 Cancel 从而关闭此对话框。
注意:
这里有三个代码存储的位置,并按照以下顺序排列:
- 您的本地工作空间在您的开放机器上
- 您的 Jazz 存储库,跟您刚刚创建的十分相似
- 这个项目的主代码流程,这正是在构建过程中它被获取的地方。
当代码从位置 A 移到位置 B 时,您必须调用 Check in
动作。当您想要将变更从位置 B 推到位置 C 时,您可以稍后调用一个 Deliver
动作,您将看到如何执行所有的动作。默认情况下,您编写的或者保存在本地空间(位置 A)的任何事件都会调查您的 Jazz 工作空间(位置 B)。您可以通过使用 Rational Team Concert 的 Preference 选项来修改设置。
创建空白插件项目,并将它们添加到这个组件
现在您将更新这个工作条目,从而显示状态为 In Progress。
- 通过使用 Work Item 视图打开这个工作条目,从而更改此状态为 Start Working。这将更改起始状态为 In Progress。
您现在要创建空白插件项目(常用的,服务和 Web),然后将它们添加到 PetStore 组件。
- 选择 File >New >Project >Plug-in Development >Plug-in Project。
- 键入 Name 为
com.ibm.petstore.example.common
并点击Next。 - 取消选择 Activator generation 和 contribution to UI 复选框,并点击 Finish。
- 再创建两个插件项目,
com.ibm.petstore.example.service
和com.ibm.petstore.example.web
,按照相同的步骤进行。 - 在 Package Explorer 视图中,右键点击 com.ibm.petstore.example.common 包,并选择 Team > Share Project(图 23)。
图 23. 共享这个项目
- 选择 Jazz Source Control,并点击 Next。
- 选择 PetStore Team Stream Workspace (图 24)之下的 PetStore 组件,并点击Next。
图 24. 选择一个组件来共享项目
- 选择新近创建的三个项目并点击 Finish。
Pending Changes 视图
这个视图在视觉化这个流程中的文件,文件夹,以及组件之间差异方面起到很大的作用。您已经将三个新项目添加到这个流程,但是您还没有交付它们。现在这些只对 John 是可使用的,当它们被交付到这个流程后,对其他用户也是可使用的。
- 选择 Window > Show View > Others > Pending Changes来打开这个视图。
- 在这个视图中 ,您可以看到一个为这三个项目创建的 Outgoing 节点(图 25)。
图 25. Pending Changes 视图中的 Outgoing 节点
- 这个 Share Project组件默认情况下被添加到这个变更设置。通过点击这个组件并对它进行编辑,您可以变更这个变更设置的组件,从而使它更具描述性。
- 在交付到这个流程之前,您应该将这个变更设置与工作条目连接在一起。这样使变更设置有更好的跟踪性。因此,右键点击这个变更设置,并选择与工作条目连接(图 26)
图 26. 将工作条目与变更设置连接在一起
- 在这个筛选框中,键入这个工作条目的最初文字或者工作条目编码,这个工作条目就会在底部部分显示出来。
- 选择这个工作条目并点击 OK。这将变更设置与工作条目连接在一起。
- 再次点击这个变更设置,并选择 Deliver 从而将变更推进这个流程。
您已经将第一个变更交付到这个流程中。此后,无论何时用户登陆并试图创建工作空间时,他们将都能够看到默认的这些变更。John 已经完成了这个工作条目,因此他现在可以解决这个工作。
- 从 Work Item 视图中打开这个工作条目。
- 变更状态为 Resolve,并保存这个工作条目。
连接工作条目
John 现在决定为自己,Joe,以及 Larry创建更多一些的条目:
- 创建一个模型定义 (John)
- 从这个模型中创建服务来访问数据 (Joe)
- 为显示数据创建一个 Web UI (Larry)
John 已经为自己创建了一个工作条目,从而在工作空间(Run/Debug 配置)内为运行和测试这个项目定义一个过程。这将使得开发人员能够在没有在这个服务器上部署项目的情况下测试他们自己得插件。这个定义从这个工作空间获取最新的代码,并在您启动服务器时使用。
要理解如何创建工作条目以及如何为用户分配任务,查阅这个话题:创建一个工作条目及将它分配给用户。
图 27. 更新的 Work Item 视图
假定 Joe 和 Larry 的工作条目是相互关联的,您将会在那些工作条目之间创建一个连接。
- 打开 Joe 的工作条目,从而可以创建一些服务。
- 这个工作条目编辑器是一个多页面编辑器,这样您只需要点击 Links 页面即可
- 在 Links 部分,点击 Add 来打开菜单
- 选择这个 Add Related 选项 (图 28)。
图 28. 连接工作条目
- 在 Work Item Selection 对话框中,选择 Larry 的工作条目 ,并点击 OK。
- 保存这个工作条目。
- 现在这两个工作条目已经相互连接,如果您打开 Larry 的工作条目,在 Links 板块下面,您将看到 Joe 的工作条目,可以创建服务标签作为一个相关的工作条目。
Joe 和 Larry 已经收到他们工作条目的邮件通知,他们已经登陆,并创建存储库工作空间 (请参见创建存储库工作空间话题): “Joe's PetStore Team Stream Workspace”和“Larry's PetStore Workspace。”当出现提示时,上载所有的插件到到这个工作空间。
因为您现在已经拥有多个工作空间,其中一个工作空间中的任何变更和交付都将看作其他用户的工作空间的引入之物。这些引入的变更都将在 Pending Changes 视图中显示。
注意:
为了防止引入变更之间的冲突 (例如,当您对其他用户修改过的文件做出变更时) ,您将看到 Pending Changes 视图中名为Unresolved的另一个节点。绝大多数时候,这个内置文件对比特征以及 Auto Merge 都将解决这些变更。如果 Auto Merge不能这样做,您将需要手工解决这些差异。您可以使用 Compare 编辑器来解决这些冲突。
接下来的内容
您已经拥有了开发项目的最初环境。您已经创建了一个 Project Area 并定义了这个团队。您还在源代码所在之处创建了一个流程和一个组件,并且您已经学习了关于存储库工作空间,工作条目视图,以及如何使用它们等等相关知识。
John 已经为定义模型创建了一些工作条目,提供了服务,并创建了一个 Web 用户界面。
这个系列中其它文章的概述
在这个系列剩余部分中,我们将带您浏览一些下面这些话题:
- 第二部分:为项目定义数据模型
- 第三部分:为数据访问定义服务
- 第四部分:为查看数据开发一个 Web 用户界面
- 第五部分:创建构建配置和报告从而进行分析