内容


通过配置管理掌控您的需求项目

IBM Rational DOORS Next Generation

Comments

概述

学习如何使用 Requirements Management (RM) 应用程序中的配置管理功能来管理流、基准和更改集,对比配置,执行其他配置管理任务。

在以下实验中,您将执行以下任务:

  1. 在需求管理流中创建一个基准,代表和保留项目的初始状态。
  2. 在需求流中执行更改,表明正在进行的开发工作
  3. 对比当前的开发流与基准,以便评估自设置基准以来执行了哪些更改。
  4. 从基准创建一个新开发流(变体)。
  5. 在变体流中,在一个更改集中执行相关更改,并将更改集传送到流。
  6. 将来自变体流的更改集共享到原始流中。

要成功完成本教程,您至少应该知道以下术语

  • 配置:工件版本的一个独特集合。配置通常标识集合中每个工件的一个版本。工件可能(与基准相比)未更改或等待更改(在开发环境中)。在一些系统中,配置可能是分层的,所以它们包含其他配置。
  • :一种配置。
  • 基准:一种不变(无法改变)的配置。
  • 更改集:一组对工作区或流中的工件的相关更改。

如果需要更多的信息,请参阅以下资源:

现在让我们看看 Rational DOORS Next Generation 界面。

有两个菜单与配置相关:

  • 使用配置管理菜单搜索和切换到特定的配置,打开和编辑当前配置,并对比配置。
图 1. 配置管理菜单
配置管理菜单使用一个图标表示,该图标表示您所在的配置类型(比如全局配置或局部配置,流、基准还是更改集),以及配置的名称。
配置管理菜单使用一个图标表示,该图标表示您所在的配置类型(比如全局配置或局部配置,流、基准还是更改集),以及配置的名称。
  • Administration 菜单,选择 Manage configurations 来了解这些配置。该选项将打开一个页面,您可以在其中导航或创建项目区域中的配置(流和基准)。
图 2. 使用 Administration 菜单中的 Manage Configuration 选项为配置进行导航。
Manage Configurations 选项导航到一个配置视图,其中描绘了流的分层结构
Manage Configurations 选项导航到一个配置视图,其中描绘了流的分层结构

练习环境

本教程使用具有配置管理功能的 Jazz.net 沙箱 6.0.1 M2,它为本教程的实践部分提供了必要的环境。根据您使用的版本,沙箱中的一些内容可能稍有不同。请参阅沙箱使用条款(图 3),其中列出了适用于 Jazz 沙箱和本文的法律协议。

图 3. 本教程使用了具有配置管理功能的 Jazz.net 沙箱 6.0.1 M2。
Jazz.net 允许使用多个沙箱选项
Jazz.net 允许使用多个沙箱选项

创建沙箱(观看视频)时,您需要为您的项目提供一个名称。在本教程中,项目名称为 JPK's AMR Project。您的项目名称可能有所不同。例如,<您的 jazz.net id> AMR Project。

请注意,沙箱中创建了几个项目区域(图 4

  • JPK's AMR Project (Requirements Management)
  • JPK's AMR Project (Change and Configuration Management)
  • JPK's AMR Project (Quality Management)
  • JPK's AMR Project (Global Configuration)
图 4. 沙箱中创建的项目。您的项目名称可能有所不同。
沙箱中包含一组项目
沙箱中包含一组项目

单击此列表中的一个项目(例如 JPK's AMR Project (Requirements Management))。此操作会自动使用您的 Jazz.net 登录信息登录到 Jazz.net 沙箱,并将打开选定的项目。登录到您的 Jazz.net 沙箱后,使用主菜单导航到各个项目。

您将收到一封电子邮件(在与您的 jazz.net id 关联的帐户中),其中包含您的沙箱项目区域的链接。保存此电子邮件,或者将您的沙箱 URL 加入收藏夹。

图 5. 一些项目会连接到沙箱的 Jazz 团队服务器。
主菜单位于屏幕的右上角,列出了可供使用的所有项目
主菜单位于屏幕的右上角,列出了可供使用的所有项目

具有配置管理功能的 Jazz.net 沙箱只是 AMR 系统的一个子集,它提供了足够的信息来演示解决方案的关键方面。

在这些练习中,我们的重点将是需求管理项目。完成这些练习后,您已经创建了基准、并行流、更改集,并将更改集传送到不同的流上。

需求管理项目 JPK's AMR Project (Requirements Management) (您的项目名称可能有所不同)有一个开发流的名称也是 JPK's AMR Project (Requirements Management)。在这个流中有一个模块:AMR System Requirements Specification,其中包含需求。

备注:
您可以随时重置您的环境,并重新开始学习本教程。本教程假设您是从一个全新的环境开始的。

图 6. Jazz.net 沙箱可以删除。
删除选项包含在(jazz.net 上的)项目名称旁边的下拉菜单中
删除选项包含在(jazz.net 上的)项目名称旁边的下拉菜单中

实验 1 使用流和基准

基准捕获工件的一个有意义的状态,比如一个已批准的状态,或者一个版本,或者可能是一个特定的时间点。(在 YouTubedeveloperWorks 上)观看这个使用 Rational DOORS Next Generation 创建基准的视频。

1.1 创建基准来捕获需求管理项目的状态

您将创建一个基准来捕获并保存开发工作的起点。

图 7. 为开发流创建基准。
描绘一个流上的基准的概念视图
  1. 主菜单(参见 图 5)中切换到 JPK's AMR Project (Requirements Management) 项目;请记住,您的项目名称可能有所不同。
  2. CurrentConfiguration 菜单中选择 Create Baseline操作说明概览
    操作说明概览
  3. Create Baseline 窗口中,提供以下信息:
    • Title:AMR(RM) Starting Point
    • Description:This is the starting state of the requirements management project in the Jazz.net sandbox 操作说明概览
      操作说明概览
  4. 单击 Create
  5. 当窗口通知您已经成功创建基准时,单击 OK操作说明概览
    操作说明概览
  6. 请注意,您仍在一个流配置中;没有切换到基准。在流配置中,您仍然可以编辑。如果切换到基准,则无法再编辑基准。 操作说明概览
    操作说明概览

1.2:在流中执行更改

您已经创建了需求项目的基准。现在将在需求流中执行一些更改,并表明正在进行的需求管理工作,比如更新现有需求或收集其他客户需求。

图 8. 基准表示项目的一种不可变状态,但您可以在流上继续您的开发工作。
创建基准后,团队无法 ‘直接在该流上更改’。
创建基准后,团队无法 ‘直接在该流上更改’。
  1. 请注意,您在一个流中。 操作说明概览
    操作说明概览
  2. Modules 菜单中,单击 Browse Modules操作说明概览
    操作说明概览
  3. 单击 AMR System Requirements 的名称打开该模块。 操作说明概览
    操作说明概览
  4. 使用您的 DOORS Next Generation 经验,对项目执行一些更改:
    1. 编辑需求。它目前显示为:
      The handheld device shall have the ability to search for accounts by Last Name, Service Address, Meter Number, and Unread Meters.操作说明概览
      操作说明概览

      您需要添加按电话号码搜索的能力:The handheld device shall have the ability to search for accounts by Last Name, Service Address, Meter Number, phone number, and Unread Meters.操作说明概览
      操作说明概览
    2. 仍然选中该工件,使用右边边栏将它的 Status 属性设置为 Approved。这是完成此操作的更多细节:
      1. 选中该工件,从右边边栏中单击 Selected Artifact 选项卡,然后单击 Edit操作说明概览
        操作说明概览
      2. 找到 Status 属性,从下拉菜单中选择 Approved操作说明概览
        操作说明概览
      3. 滚动到边栏顶部,单击 DONE操作说明概览
        操作说明概览
    3. 找到此需求:
      Display information shall include: total number of accounts in collection route, number of read accounts, number of unread accounts, the address of each account.For completed (read) accounts, the display information shall include: the date and time of the last reading, summary of usage data, and the id of handheld reading device.
    4. 编辑该需求,以便显示电话号码:
      Display information shall include: total number of accounts in collection route, number of read accounts, number of unread accounts, the address and phone number of each account.For completed (read) accounts, the display information shall include: the date and time of the last reading, summary of usage data, and the id of handheld reading device.
  5. 更改一个流的首选方式是使用更改集(可选)。直接在流中编辑时,在执行每次更改时,Rational DOORS Next Generation 都会实际创建和传送更改集。一种更好的解决方案(我们稍后将介绍)是将相关的更改分组到一个更改集内。要查看创建并传送到流中的更改集,可以执行以下步骤:
    1. Administration 菜单中选择 Manage Configurations操作说明概览
      操作说明概览
    2. 单击流名称(示例:JPK's AMR Project (Requirement Management). 操作说明概览
      操作说明概览
    3. 单击 Change Sets 选项卡。单击 Select to include delivered change sets 图标。您创建的更改将位于列表的顶部,使用您的用户名标识。 操作说明概览
      操作说明概览
    4. 选择 Modules > Browse Modules 来返回到模块视图。

1.3 对比一个流和基准

配置(包括流和基准)可彼此对比。对比在尝试评估执行了哪些更改时非常有用。

  1. 在需求管理项目的 Current Configuration 菜单中,选择 Compare Configuration操作说明概览
    操作说明概览
  2. Select the Configuration Context 窗口中, 操作说明概览
    操作说明概览
    1. 选择 Baseline(以便只过滤基准配置)
    2. 键入 * (列出所有基准配置)
    3. 选择 AMR (RM) Starting Point
    4. 单击 OK
  3. 在向导中,您可以检查该流与基准之间的区别。
    1. 确认您对比的内容(流与基准),然后单击 Next >操作说明概览
      操作说明概览
    2. 下一页显示了项目属性中的更改的摘要。您尚未执行任何这类更改,所以请单击 Next
    3. 现在向导显示项目的文件夹结构没有发生更改,所以请单击 Next
    4. 可以看到对工件的更改。单击左边已更改的工件,在右边查看对该工件的更改的详细信息。 操作说明概览
      操作说明概览
    5. 在完成检查后,单击 Finish

小结

流可以随时设置为基准来捕获项目的状态。基准是工件的不可变(无法改变的)版本,从创建基准开始就无法改变。用户可切换到基准,将它与其他流或基准对比,甚至根据某个基准开始新的开发流。因为基准代表项目的一个无法更改的已知状态,所以在管理多个产品变体(甚至同一个项目或产品的多个版本)时,基准非常有用。在下一个练习中将会看到,多个产品变体可从一个共同点(使用基准表示)创建新的开发流,共享(但不会克隆和拥有)截至此点之前的所有需求。开发流中的更改位于流本地。一个流中的更改不会影响其他流,除非更改已传送到其他流。

实验 2 根据一个基准来创建流

AMR 团队正在使用多个流来管理整个产品线的变化性。不同的流将用于移动和网格产品。图 9 显示了配置依赖项的一个概念视图。

图 9. 流用于管理整个产品线的变化性
从某个基准分出的一个新流的概念视图
从某个基准分出的一个新流的概念视图

在此实验中,您将创建新开发流来管理移动和网格产品变体之间的变化。您将从一个需求基准创建一个变体流。两个流将使用相同的需求,但每个流都将有自己的这些需求的版本。因为我们将从一个基准来创建变体流,所以 该基准创建以来执行的所有更改都不会在新创建的流中。(您可以使用 JPK's AMR Project (Requirements Management) 流创建一个新流,这会自动在该时间点创建该流的一个基准。)

  1. 切换到基准配置 AMR (RM) Starting Point,如下所示:
    1. 从 Configuration 菜单中选择 Switch操作说明概览
      操作说明概览
    2. Select the Configuration Context 窗口中: 操作说明概览
      操作说明概览
      • 选择类型:Requirements Management Configuration。
      • 主要关注 Baseline
      • 输入 start 来过滤基准列表。
    3. 找到并选择 AMR (RM) Starting Point 配置。这将成为网格工作的起点。
    4. 单击 OK 切换到该基准配置。
    备注:
    选择一个配置会在应用程序中记载选定配置中的工件版本。选定的配置的名称显示在横幅上。 操作说明概览 一个图标表明了配置的类型。从该图标可以看出,AMR (RM) Starting Point 是基准。
    备注:
    基准无法编辑。它们是无法更改的参考点。
  2. 从 Configuration Management 菜单中选择 Create Stream
  3. Create a Stream 窗口中,
    1. 输入流名称:AMR(RM) Grid。 操作说明概览
      操作说明概览
    2. 选择 Switch to the new stream 复选框并单击 Create

AMR (RM) Grid 产品的新需求流已创建并在编辑器中打开。新流名称显示在横幅中。

操作说明概览
操作说明概览

备注:
该流不是需求的物理副本;它不是一个克隆后自己拥有的副本。每个流都会引用这些需求的特定版本。因此,团队可以根据需要在自己的流中工作,更改可与其他流共享(如果需要的话)。它们可对比彼此的配置来查看它们之间有何不同。

小结

通过使用流,团队可以管理不同的产品,甚至管理同一个产品的不同版本之间的变化。一定要注意的是,不同的流共享相同的需求;这不是一个克隆后自己拥有的解决方案,而是真正的重用。更改记录在不同的流中,而且在任何时候,流都可以彼此对比或与基准对比,甚至可以在它们之间同步更改。

实验 3 使用更改集来控制更改

有时,您需要收集 共享工件的相关修改,并将它们作为一个集合进行传送。以下是一些可能的原因:

  • 该更改很重要,需要多次更改。在准备好之前,您不希望干扰当前的开发。
  • 更改需要批准才能正式提供。
  • 更改将影响其他流;您可能需要将此信息与其他流共享。
  • 在协作开发环境中,您接受来自另一个流或基准的更改,以便可以在您使用的流中使用它们。

更改集是对共享工件的相关修改的集合,它可传送到一个流,也可在以后传送到其他流。

完成更改后,您可以将您的更改传送到目标流或丢弃它。只有传送的更改集可供其他流使用。

多个人可操作同一个更改集。

之前已经看到过,每次直接在 Rational DOORS Next Generation 流上执行更改时,应用程序都会自动创建并传送一个更改集,您的更改也可以立即供其他共享该流的团队成员使用。

在这个练习中,您将在 AMR (RM) Grid 流中创建一个更改集,它将对需求的一些更改分组到一起。在后面的一个练习中,会将更改集传送到 JPK's AMR Project (Requirements Management),证明该需求是在流中共享的。

图 10. 更改集是对共享工件的相关修改的集合,可以将它传送到一个流,也可以在以后将它传送到其他流。
1. 创建一个更改集,2. 编辑一个更改集,3. 将更改集传送到一个流。
1. 创建一个更改集,2. 编辑一个更改集,3. 将更改集传送到一个流。

3.1 为需求创建一个更改集

  1. AMR (RM) Grid 流的 current configuration 菜单中,选择 Create Change Set
  2. 命名更改集:Meter Interface requirements,单击 Create操作说明概览
    操作说明概览
  3. 确认更改集已选择为当前的配置。 操作说明概览

3.2 在一个更改集内执行更改

您在一个更改集中,因此您从现在到传送或丢弃该更改集之前所做的所有更改,都会自动收集到此更改集中。

  1. 打开 Current Configuration 菜单,查看可以对您的更改集执行的操作。在这个 “晴天” 练习中,您将执行一些更改,然后使用 Deliver Change Set。在菜单中可以看到,您还可以丢弃该更改集,或者将该更改集内容与它所基于的流进行对比。 操作说明概览
    操作说明概览
    备注:
    您可以切换到不同的配置并在那里执行更改,而不影响此更改集的状态,也可以在以后返回到此更改集来继续执行更改。
    为了最充分地利用更改集,可以让一个更改集中累积的更改密切相关 – 使它们都相互关联或用于同一用途。
  2. 使用您的 DOORS Next Generation 经验:
    1. 打开 AMR System Requirements 模块。
    2. 找到此工件:The handheld device shall provide for the means for the meter reader to manually enter a meter reading.
      双击该文本来编辑它,将 six-digit 添加到 meter reading 之前。然后按下 Control + S 或单击其他地方来保存更改。 操作说明概览
      操作说明概览
    3. 将一个新的小节添加到小节 1.1.1 Handheld device 后,将它的类型设置为 Heading 并命名为 Meter interface Unit
    4. Meter Interface Unit 小节中,添加一个新需求作为子需求,并添加以下文本:A meter will support two-way communication between the meter and server via a wireless network. 操作说明概览
      操作说明概览
      操作说明概览
      操作说明概览

执行这些更改后,只有在处理此更改集的其他人能够看到它们。

完成更改后,您可以使用一个工作项来通知团队,该更改集已准备好批准了。更改集获得批准后,就准备好传送它了。

3.3 传送更改集

更改集已准备好传送到流中。它包含三个单独的更改,它们被分组到单个更改集中。传送更改集给团队影响极小,在所有更改已批准并准备好传送之后才能看到它们。

  1. 确认更改集已选择为当前的配置。 操作说明概览
  2. 打开 Current Configuration 菜单并单击 Deliver Change Set操作说明概览
    操作说明概览
  3. 单击 Deliver the Change Set,确认您希望传送该更改集。
  4. 在向导中,检查更改集中的更改,并解决任何潜在的冲突。
    1. 确认您正在传送的内容(更改集,作为 Source Configuration 列出),传送到何处(列出为 Target Configuration)。单击 Next >操作说明概览
      操作说明概览
    2. 向导的下一步总结了更改集中的更改。可以单击左边已更改的工件,在右边查看对每个工件的更改的详细信息。检查所有更改后,单击 Next >操作说明概览
      操作说明概览
  5. 向导的最后一步是最后一次确认。确认摘要中显示的信息是正确的,然后单击 Finish操作说明概览
    操作说明概览
  6. 请注意当前配置现在是流 操作说明概览。检查对工件的更改,确认您的编辑都包含在其中。这些更改现在可供在 AMR (RM) Grid 流中工作的所有其他人看到。

小结

在此实验中,您使用了更改集,所以团队可以在主要开发流之外修改工件,在他们准备好之后,团队可丢弃更高级或将它传送到流中。更改集传送到流后,它可与其他流共享,您会在下一个练习中看到。

实验 4 将更改从一个流传送到一个不同的流

您创建并传送到 AMR (RM) Grid 的更改集对 JPK's AMR Project (Requirements Management) 流也有效。我们将该更改集应用到该流。

图 11. 更改集可从一个流传送到另一个流。
将更改集传送到另一个流
将更改集传送到另一个流
  1. 切换到 JPK's AMR Project (Requirements Management) 流。 操作说明概览
    操作说明概览
    操作说明概览
    操作说明概览
  2. 打开 Current Configuration 菜单并单击 Accept Changes操作说明概览
    操作说明概览
  3. 您更改集中的更改已传送到 AMR (RM) Grid 流。选择该流并单击 OK。 操作说明概览
    操作说明概览
  4. Deliver Change Sets 向导将启动,显示来源和目标。单击 Next >操作说明概览
    操作说明概览
  5. 使用该向导来传送自创建最新的基准以来对该流执行的所有更改,或者选择性地传送更改。我们使用选择性的方法。单击 Select which change sets to deliver,然后单击 Add操作说明概览
  6. Select Change Sets 窗口中,您会看到在 AMR (RM) Grid 中执行的所有更改。因为您的所有更改都是在一个更改集中执行的,所以在这里可以看到所有更改。 操作说明概览
    操作说明概览
  7. 选择 Meter Interface requirements 更改集,单击 Add and Close
    备注:
    在流之间选择性地传送更改的能力非常有用。
  8. 该更改集现在已显示在正传送到目标 AMR (RM) Mobile US 流的更改列表中。单击 Next >操作说明概览
    操作说明概览
  9. 向导显示了正在应用的更改。单击 Next>操作说明概览
    操作说明概览
  10. 向导显示了来源和目标的摘要,供最后确认。单击 Finish操作说明概览
    操作说明概览
  11. AMR (RM) Mobile US 流现在已使用更改集内容更新。举例而言,检查需求 532 是否显示了更多的天然气和电力服务的文本。

小结

更改可在流之间共享,而更改集大大简化了这项任务,因为它们将相关的更改分组到一起,并提供描述了它们包含的更改的名称。

结束语

需求的配置管理功能非常强大。它可以帮助您计划具有相同需求的产品变体。它方便了在流之间推送需求更改。它提供了一种轻松方式来彼此对比不同的更改,以识别差异。但最重要的是,Rational DOORS Next Generation 所支持的需求配置管理使您的团队能够更高效、更富有成效。


相关主题


评论

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

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational, 物联网, Big data and analytics
ArticleID=1021797
ArticleTitle=通过配置管理掌控您的需求项目
publish-date=11232015