内容


IBM Rational DOORS Next Generation V4.0.6 入门

Comments

概述

本教程将介绍 IBM® Rational® DOORS® Next Generation,以及如何使用它与团队协作,采集、详细阐述和跟踪整个开发生命周期中的需求。Rational DOORS Next Generation 支持团队在项目的整个生命周期中实现需求管理的基本原则。本教程介绍了该产品的以下区域:

协作、组织、信息粒度、属性、报告、跟踪和安全。

本教程包含需要安装和设置的练习。有关的更多信息,请参阅 IBM Rational DOORS Next Generation V4.0.6 入门 - 练习环境设置

目标读者

本文是为需求工程师而编写的。

Rational DOORS Next Generation 入门

需求管理 (RM) 包括以井然有序的方式记录需求和它们的支持性信息。这样,就可以在上下文内分析、解释和引用需求。

IBM® Rational® DOORS® Next Generation 是一个基于 Web 的 RM 工具,用于跨开发项目而定义、管理和跟踪需求。

本教程中的示例概述

本教程中的示例是一家虚构公司 JK-Meters Corp,该公司希望构建一个自动抄表器 (automated meter reader, AMR)。该公司开发了一个解决方案来读取水表读数,以一种电子自动化、富有成本效益的方式提供服务。该 AMR 用于帮助水厂降低运营成本,更准确地度量水使用情况并快速收集数据。该解决方案使用的是现有的水基础设施,但可能需要增强这些设施,支持以更灵活的方式确定水使用情况,这方面的增强包括使用手持设备、移动/车载抄表器或电网抄表器。

图 1. 该公司提出了多个改善抄表器服务的想法。
自动抄表器产品
自动抄表器产品

要开发此示例的需求,需要创建一个从仪表获取的信息的列表。该列表可能包含以下需求:

  • AMR 应满足可靠性、数据分析、保护和数据准确性等方面的各种性能目标。
  • AMR 应该能够在选定的市场环境中操作
  • AMR 应遵守每个国家独有的任何必要的标准和制度。
  • AMR 应支持使用各种机制收集数据,包括无线传输到中央办公室,以及使用手持设备收集数据。

AMR 项目的信息可以存储在以下需求文档中,如 图 2 中所示:

  • 前景:此文档描述用户或客户对要开发的产品的看法。前景在关键利益相关者的需要和系统特性级别上指定。
  • 系统:这个详细文档明确地描述一个系统,用于帮助开发或验证该系统。此文档为前景提供支持,是要构建的产品的利益相关者与工程师之间的一种协议。
  • 软件:这个详细文档描述了开发的系统的软件,用于帮助开发或验证该软件。
  • 硬件:这个详细文档描述开发的系统的硬件,用于帮助开发或验证该硬件。
  • 危害和风险:此文档描述了在项目开发期间必须减轻的各个方面的问题。

备注:在 Rational DOORS Next Generation 中,需求文档通常也被称为模块,并指明了工件的格式。我们会在稍后更详细地解释模块。

需求数据可以通过以下关系建立关联(图 2):

  • 满足(被满足/满足):此关系捕获不同级别的需求是如何详细阐述的。例如:您期望前景文档中每个批准的前景陈述由一个或多个利益相关者需求来满足。因此,每个利益相关者需求都应表明它可以满足 一个或多个前景陈述。如果情况不是这样的,那么最终得到的解决方案可能没有满足所有用户需求,或者其中的资源被用于客户不想使用的地方或不愿意付费的地方。
  • 减轻(被减轻/减轻):此关系显示了需求和风险之间的关联。某种需求可能是因为它会减轻一种风险而存在的。
  • 跟踪(被跟踪/跟踪):此关系显示了更改请求和需求之间的关联。
  • 验证(被验证/验证):此关系显示了需求是如何测试的。
  • 推导(被推导/推导):此关系显示了需求在设计中是如何传达的。
图 2. 需求文档可能通过多种方式彼此关联,并与其他信息相关联。
需求文档关系
需求文档关系

重要事项:请将这些信息保留在项目中,确保团队知道这些信息。了解为什么收集信息以及它是如何存储和分析的,这对项目的成功至关重要。

有了此知识,您就可以找到您需要的信息,捕获新需求和它们的关系,并回答有关项目的关键问题。

访问 Rational DOORS Next Generation

借助 Rational DOORS Next Generation,团队可以在 Web 浏览器上同时访问一个需求管理 (RM) 应用程序。团队成员需要应用程序的 URL,而且要访问相关的项目和团队区域,他们必须进行登录。

图 3. 在浏览器中,登录到 Jazz Team Server 上的 RM 应用程序。
RM 登录
RM 登录

第一次登录时,All Projects 页面(图 4)列出了您所属的需求管理项目。

图 4. All Projects 页面列出了您所属的项目。
All Projects 页面
All Projects 页面

可以从 All Projects 页面访问各种仪表板、项目属性和项目的内容。

浏览需求项目

如果单击 Show Artifacts,则会打开 Artifacts 页面,其中列出了项目中的所有工件(图 5)。

各个项目组织在左侧边栏中的文件夹中。文件夹和其他过滤器可以限制显示哪些工件。

图 5. JTSAdmin 登录到 Automated Meter Reader (Water) 需求管理项目。您正在查看 Artifacts 页面。
Artifacts 页面
Artifacts 页面

需求和规范

一种好的需求管理实践具有明确的需求,在技术上是准确、完整和可验证的。可以使用原子需求来准确控制依赖关系和是否接受。例如,无需编写以下需求:

  • 手持设备应该能够显示诊断信息,包括可疑的水泄漏,还应将泄漏数据记录到中央办公室数据存储中。

可以考虑编写以下需求:

  • 手持设备应该能够显示诊断信息,包括可疑的水泄漏。
  • 手持设备应将泄漏数据记录在中央办公室数据存储中。

在需求是原子需求时,信息显示信息记录 可以独自接受和测试。

需求必须拥有支持信息,比如需求的状态;该需求被批准了吗?编写原子需求还有助于保持支持信息保持简洁和清晰。

图 6. 原子需求能为良好的需求管理实践提供支持。
原子需求支持
原子需求支持

基本概念和术语

在 Rational DOORS Next Generation 中,需求项目由需求工件组成,这些工件通常被简单地称为工件工件 是组成项目的各部分的一般性术语。工件可能是一个特定的需求,也可能是补充信息,比如标题、图片、用例图,甚至可能是您上传的某种信息。

工件拥有属性,属性记录和跟踪有关工件的数据,比如它的接受状态或验证方法。一些工件可以修改;其他工件则受系统控制。例如,系统管理的属性包括 ID、Created By 和 Modified On。

依赖于工件类型,工件可能具有不同的属性。例如,如果一个工件的类型为 Information,那么为该工件设置一个 “Release date” 属性可能毫无意义。但是,Stakeholder Requirement 类型的工件可能需要在属性中存储此类信息。

另一种需求管理最佳实践规定,需求必须是一致的,而且可以当作一个完整的分组,以避免需求之间的歧义,确保没有需求被忽略。

要将需求工件作为一个分组来分析,可以通过多种方式来组织它们。文件夹、集合、模块、标记和属性值通常被用来组织工件。

规范文档通常归类到一个具有 Module 格式的工件中。模块中的工件是单独管理的,这意味着您可以单独编辑它们,链接到它们,跟踪它们的历史,等等。

模块是一种特殊类型的工件格式,包含一个逻辑和分层结构中的其他工件。模块看起来像是一种富文本文档。在模块中,工件属性可以按列显示;因此,模块看起来也像一个电子表格。

图 7. 一个模块包含一个逻辑和分层结构中组织的其他工件。
模块的内容
模块的内容

模块内容可以按节分层进行组织,也可以搜索、过滤和分类模块内容。图 7 显示了两列:每个属性的内容和 ID。图 8 显示了一组不同的列。

图 8. 可以对一个模块内的工件进行分层组织、编辑、分类和过滤。
对模块中的工件进行分类
对模块中的工件进行分类

阐述需求

Rational DOORS Next Generation 支持许多工件类型,这些类型捕获各种格式的需求:

  • 文本:各种文本需求、标题、信息、嵌入式图像、PDF 文件,或者完整的富文本需求规范。
  • 模块:一种分层组织的需求规范,看起来像富文本文档,操作类似于电子表格。模块的内容是在该模块内单独管理的。
  • 业务流程图:该图描述业务目标、活动和流程。
  • 用例图:该图描述用户与系统的交互。
  • 用户界面框架:对一个图形用户界面的模仿,为一个应用程序的设计提供支持。
  • 屏幕流:一个用户驱动的软件流程序列,显示在一系列图形用户界面中。
  • 用户界面部分:一个可重用的用户界面元素集合,可用于填充框架和故事板。
  • 故事板:对用户场景的逐帧描述,包含一个时间线上按顺序编号的帧。
  • 集合:因为某种特定用途而分组到一起的多个工件。

创建工件时,需要指定工件的格式。

图 9. Rational DOORS Next Generation 支持多种编辑器。
Rational DOORS Next Generation 支持多种编辑器
Rational DOORS Next Generation 支持多种编辑器

练习 1. 可选:复习基础知识

此练习是可选的,因为本教程中提供了相同的信息。观看两个视频:

  1. 视频:Rational DOORS Next Generation v4.0.x 术语和基本概念。这个介绍性演示重点介绍了一些基本概念和术语,在开始使用 Rational DOORS Next Generation 之前,了解这些基本概念和术语会对您有所帮助。
  2. 视频:了解 IBM Rational DOORS Next Generation。此视频概述了产品的用户界面。其中展示了如何访问一个需求项目,查找工件,浏览工件细节,创建视图,以及如何对工件进行基本的编辑。

练习 2. 登录到 RM 项目

要访问需求管理 (RM) 应用程序,需要使用一个特定于您的安装的 URL。在此练习中,要访问 RM 应用程序中的 Automated Meter Reader (Water) 项目的 Artifacts 页面。

  1. 如果在本地安装了该产品,请执行以下步骤;否则跳到第 2 步。
    1. 在浏览器中输入项目的 URL,它可能类似于此示例的 URL:https://localhost:9443/rm/web/。
    2. 使用在设置环境时分配的凭据登录到 RM 应用程序。这将打开 RM 应用程序的 All Projects 页面(图 4)。该页面列出了您所属的所有 RM 项目。在此练习中,将会使用 Automated Meter Reader (Water) 项目。
    3. 单击 Automated Meter Reader (Water) 项目部分中的 Show Artifact。这将打开该项目的 Artifacts 页面(图 5)。
  2. 如果使用沙箱,请执行以下步骤:
    1. 在浏览器中输入 https://jazz.net/sandbox02/setup/web,访问该 RM 项目。系统会提示您进行登录。
    2. 在打开的页面上,单击该需求管理项目(图 10)。
图 10. 从沙箱访问 RM 应用程序。
从沙箱访问 RM 应用程序
从沙箱访问 RM 应用程序

您的 Jazz.net 用户 ID 与该项目有关联,您会被引导至项目的 Artifacts 页面。

备注:您可以随时展开 Home 按钮上的菜单,快速返回到 RM 应用程序的 All Projects 页面(图 11)。

图 11. Home 按钮提供了一种在不同应用程序、仪表板和项目之间切换的便捷方式。
使用 home 按钮进行导航
使用 home 按钮进行导航

练习 3. 使用文件结构找到一个工件

有关需求工件的信息被组织到文件夹中。文件夹是存储在 RM 项目中的信息的一种过滤器类型。

  1. 转到 Automated Meter Reader (Water) 项目的 Artifacts 页面。
  2. 在左侧边栏中的 Filter by folder 部分中,单击 Automated Meter Reader (Water) > 01 Requirements
  3. 确定文件夹中有多少个工件。提示:查看 Artifacts 页面。
    (答案:该文件夹包含 4 个工件。)

您可以看到,01 Requirements 文件夹包含 Artifacts 页面中没有显示的子文件夹。文件夹组织需求信息,但文件夹不会被视为工件。

练习 4. 通过查看一个富悬停弹窗来查看工件的属性

将鼠标悬停在 AMR Stakeholder Requirements Specification 工件上(图 12)。

  1. 问题:规范的工件类型是什么?
    (答案:Stakeholder 规范,或者 Requirement 规范,具体情况取决于您的版本)
  2. 问题:工件的格式是什么?
    (答案:模块)
  3. 问题:工件的描述是什么?
    (答案:该工件没有描述)
  4. 问题:上次修改此工件是何时?
    (答案:该信息未在富悬停弹窗中显示,但您会看到,可以通过打开的工件的属性来访问它)
图 12. 富悬停弹窗显示了工件的信息。
富悬停弹窗
富悬停弹窗

练习 5. 按列显示工件属性

您可以自定义 Artifacts 页面;可以更改各列中显示的工件信息。在此练习中,我们修改了 Artifacts 页面,以便仅显示 ID、Name 和 Description 属性(图 13)。

图 13. Artifacts 页面的显示 “01 Requirements” 文件夹中的工件的 ID、Name 和 Description 属性。
Artifacts 页面
Artifacts 页面
  1. 单击 Change Column Display Settings 图标 Change Column Displan Settings 图标。这将打开 Change Column Display Settings 窗口(图 14)。
    图 14. 您可以决定要在 Change Column Display Settings 窗口中显示哪些列。
    Change Column Display Settings 窗口
    Change Column Display Settings 窗口
  2. Columns to show 列表中,选择 Artifact Type 并单击 Remove
  3. 选择并删除 Modified By 和 Modified On 列,以便 Columns to show 列表中仅包含 ID 和 Name。
  4. Select attributes or link types 列表中,选择 Description。单击 Add。Description 被添加到 Columns to show 列表中(图 13)。
  5. 单击 OK。在 Artifacts 页面上,显示了您指定的工件信息,以便您可以重点关注与您相关的信息。

并发和内联编辑

使用 Rational DOORS Next Generation,您和您团队的成员可以并发地访问需求数据,根据需要审核或修改它。

可以采用多种方式编辑需求信息。在查看一个模块中的工件或者 Artifacts、Collections 或 Modules 页面上的工件时,可以直接编辑工件的各行。编辑工件时,被编辑的工件是锁定的。保存后,该工件就会解锁(图 15)。如果需要预防其他人编辑一个或多个工件,那么可以手动锁定它们。

图 15. 工件在编辑时会自动锁定。
自动锁定工件以便进行编辑
自动锁定工件以便进行编辑

练习 6. 直接编辑需求信息

如果属性可以编辑并显示在列中,那么可以在一个模块中或在 Artifacts、Collections 或 Modules 页面上直接编辑它们。

  1. 在 Artifacts 页面上,找到 AMR Stakeholder Requirements Specification,然后双击它的描述。该工件就会被锁定并进入编辑模式。
  2. 为该工件键入一段描述;例如,This module specifies the requirements the user expects
  3. 单击该工件外部就会保存更改。

可以使用视图来更改数据的透视图

不同人需要看到不同的信息。考虑以下示例:

  • 经理对日程表和成本信息感兴趣。
  • 工程师对技术设计信息感兴趣。

可以在项目级别和在您模块内创建不同的视图。视图通过提供需要的信息的简洁、一致的视图,满足不同利益相关者的需要。

图 16. 使用视图快速切换数据的透视图。
使用视图快速切换数据的透视图
使用视图快速切换数据的透视图

练习 7. 使用视图更改数据的透视图

您可以创建私人或共享视图,可以使用它们快速更改数据的透视图。

只需一次单击即可更改数据的透视图,这是一项很重要的功能。视图提供了一致的数据透视图,提高了效率和改善了沟通。

在本教程前面,您在项目级别上更改了数据的透视图,通过过滤来仅显示特定文件夹中的工件,然后修改了 Artifacts 页面上要显示的工件。如果希望反复使用这个数据透视图,那么可以将它保存为私人或共享视图。

7.1) 创建一个视图
  1. 确保您在 Artifacts 页面上。在左侧边栏中,展开 Views 部分并单击 Save view 图标(图 17)。
    图 17. 单击 Save View 图标保存或更新一个视图。
    Save View 图标
    Save View 图标
  2. 在 New View 窗口中,提供该视图的相关信息(图 18):
    1. 为该视图键入一个名称;例如 01 Req. modules and descriptions
    2. 指定该视图是私人视图,并为它提供一段描述;例如 A list of the modules in the "01 Requirements" folder and their description
    3. 单击 OK 保存该视图。
    图 18. New View 窗口包含一个新的私人视图的信息。
    New View 窗口

保存视图后,它会在左侧边栏中的 Views 部分中列出。

7.2) 清除一个已应用的视图

在 Views 部分中,单击擦除图标清除该视图(图 19)。目前已列出了可用的视图。要清除一个视图,可以单击擦除图标。

图 19. 列出了可用的视图。要清除一个视图,可以单击擦除图标。
擦除图标
擦除图标

可以看到,Artifacts 页面上的列已更改。该页面上的工件之所以更改,是因为您不再仅查看来自 01 Requirements 文件夹的工件。

7.3) 应用一个视图

单击视图的名称可以再次应用它。来自 01 Requirements 文件夹的模块和您指定的列已显示在 Artifacts 页面上。

创建一个规范文档作为模块

在 Rational DOORS Next Generation 中,规范文档通常被创建为 Module 格式的工件。对于规范文档,与其他格式相比,模块提供了许多好处:

  • 信息粒度:您可以单独审核、注释、接受和关联每个需求工件。
  • 相关信息的分层组织:您可以更轻松地审核相关信息的完整性和准确性。
  • 过滤能力:
    • 折叠您文档中此刻不感兴趣的部分
    • 在各列中显示您想要看到的工件属性
    • 按标记、属性和链接过滤数据
  • 能够快速切换数据透视图:您可以满足该文档的目标受众的需要(图 16)。

模块结构

图 20 所示,模块的布局看起来类似于 Artifacts 页面。痕迹导航链接紧挨在项目标题栏下方,可以使用它们返回到您打开的工件所在的页面。可以注意到有一个工件标题栏,它显示了工件的 ID 和 Name 属性,以及一些特定于工件的图标。

右侧的边栏包含特定于工件的信息。您可能还记得,在 Artifacts 页面上,右侧的边栏包含特定于项目的信息。

模块本身显示在页面的中央。在模块中,工件以分层方式组织在各节中,每一节都可以使用标题来表示。可以看到标题(比如 “1 Introduction”)和子标题(比如 “1.2 Purpose of the document”)。第 1.1 和 1.2 节是第 1 节在分层结构中的子节;因此第 1 节是第 1.2 在分层结构中的父节。第 1.1 和 1.2 节处于同一级。

文档的分层组织提供了许多好处,包括但不限于以下好处:

  • 清除信息分组。要隐藏一节中的所有工件,可以折叠它。
  • 简单地重组模块。要移动一节,可以将它的标题拖到另一个位置。它在分层结构中的所有子节也会移动。
图 20. 在此图中,打开了一个模块工件。模块布局类似于 Artifact 页面的布局。
模块布局
模块布局

练习 8. 浏览一个模块的内容

8.1) 打开一个模块

找到 AMR Stakeholder Requirements Specification 工件,单击它的 ID 或名称打开它。此工件为 Module 格式。

8.2) 浏览模块内容
  1. 滚动该模块,可以注意到它像一个文档,具有标题和子标题、富文本、图像,甚至是用例图。
  2. 将鼠标悬停在标题的 ID 和需求的 ID 上,并注意它们之间的区别。模块可以对不同类型的工件进行组织。将鼠标悬停在标题和需求 ID 上时,您可以看到它们是不同类型的工件。每种类型的工件根据项目的需要收集自己的属性集。
  3. 可以单击 1 Introduction 节的标题编号来折叠它。您可能注意到,分层结构中第 1 节下方的所有信息现在都已隐藏。另请注意第 1 节旁边的箭头,它表示该节已折叠(图 21)。
图 21. 一个模块中的各节可以折叠或展开。
一个模块中的各节
一个模块中的各节
8.3) 搜索模块中的信息

在模块的右上角,单击 Find/Goto 图标 Find-GoTo 图标,并在模块中搜索以下短语:AMR。

8.4) 查找一个术语表术语

一致的术语对创建和维护清晰的需求文档至关重要。

  1. 查找术语 meter reader
    1. 双击一个包含术语 meter reader 的工件,就会在编辑模式下打开它。请注意显示的编辑选项。
    2. 在该工件中,突出显示术语 meter reader
    3. 在编辑选项中,单击 Insert
    4. 单击 Lookup Term 图标 Lookup term 图标。在打开的窗口中,您可以看到,一个 meter reader 的解释为 “An employ who uses the handheld device or some other means to read usage data.”。
    图 22. 可以将术语表术语与工件中的文本相关联。
    将术语表术语与文本相关联
    将术语表术语与文本相关联
  2. 单击窗口中的 Meter Reader 链接,将工件中的 meter reader 文本与术语表术语相关联。
  3. 单击模块中该工件旁边的某处,即可保存该工件。
  4. 将鼠标悬停在工件中的 Meter Reader 链接上。现在该术语已与鼠标术语关联,并显示了它的详细信息(图 23)。
    图 23. 富鼠标悬停弹窗显示了术语表的细节。
    术语表细节
    术语表细节

模块编辑

您刚修改了一个模块的内容,编辑了其中的一个工件。如 图 8 所示,您可以直接编辑模块中的一个工件,或者可以打开该工件来编辑它的属性。您还可以更改一个模块的结构,重组它的工件和添加新工件。

之前您已经在 Artifacts 页面上编辑了一个模块的属性。图 20 展示了如何从一个模块内编辑模块属性。执行更改时,会维护审计线索以供将来引用。

练习 9. 编辑某个模块的属性

  1. 在右侧边栏中,请注意您添加到规范文档中的 Description 属性值。您可以看到,一些属性值已自动更新,包括 Modified On 和 Modified By。
  2. 在右上角,单击 Edit 以进入编辑模式,修改模块的属性。您可以注意到,一些属性(比如 ID)是不可编辑的。
  3. 将该工件的名称从 AMR Stakeholder Requirements Specification 更改为 AMR Stakeholder Requirements Specification (option 1)
    AMR Stakeholder Requirements 规范
    AMR Stakeholder Requirements 规范
  4. 单击 Done 保存您的更改并退出编辑模式。

练习 10. 检查工件的历史记录

对工件的更改会记录在工件历史记录中。您可以随时查看这些历史记录。

  1. 要查看模块的历史记录,可以单击 Open History 图标 Open History 图标
  2. 单击 Audit History 选项卡。在该选项卡上,可以注意到已经执行了一次更改。
    图 24. 可以在工件的 Audit History 选项卡上查看对它进行的更改。
    Audit History 选项卡
    Audit History 选项卡
  3. 单击 Open Current Version 图标返回到 AMR Stakeholder Requirements Specification (option 1)。

练习 11. 增大模块的内容区域

在模块中工作时,可以折叠一个或两个边栏来增大工作区域,这常常是个不错的想法。折叠模块的右侧边栏,并注意区别。

图 25. 边栏可折叠。
边栏可折叠

练习 12. 在列中显示模块中的工件属性

在列中显示模块中的工件的信息,就像之前在 Artifacts 页面上所做的那样。

  1. 单击 Change Column Display Settings 图标Change Column Display Settings 图标,更改设置,以便显示出这些额外的列:Status, Used in ModulesComments
  2. 在 Status 列中,可以注意到一些工件已批准,一些则被拒绝,其他的已过时,等等。
    备注:单击一个列标题,按照该列中包含的值对工件进行排序。单击一下就可以按升序、降序进行排列或者删除排序。
  3. 在 Used in Modules 列中,查找包含此 Multiple module 图标 符号的工件。该符号表示该工件用在多个模块中。如果编辑一个模块中的一个工件,更改会在该工件的其他实例中反映出来。但是,该工件的注释、链接和标记特定于这个特定模块中的工件。
  4. 查看 Comments 列。如果团队对此工件添加了任何注释,它们将显示在这里。此列还提供了一种便捷方式来创建或响应注释。
图 26. 该工件的属性显示在各列中。显示的属性包括:ID、Contents、Status、Used in Modules 和 Comments。
列中显示的工件属性
列中显示的工件属性

练习 13. 创建一个用在项目的所有模块中的共享视图

要跨模块一致地协作,可以保存一个可用在所有模块中的视图。此视图可以是私有的,也可以与团队进行共享。在此练习中,保存了数据的当前透视图,并与团队和在各个模块间共享它。

  1. 在左侧边栏中的 Views 节中,单击 Save
  2. 在 New View 窗口中(图 27),提供以下信息:
    1. 对于名称,可键入 Requirements Status
    2. 对于视图类型,可单击 Shared
    3. 选择 Use in all modules
    图 27. New View 窗口显示了创建一个要用在所有模块中的视图的设置。
    New View 窗口
  3. 单击 OK 创建该视图。

练习 14. 基于属性过滤模块内容

过滤模块,以便仅显示拒绝的工件。

  1. 在左侧边栏中,单击 Filter by Attribute,然后单击 More attributes
  2. 从该列表选择 Status,然后选择 Rejected图 28)。
  3. 单击 Apply。可以看到,需求工件被拒绝了,因为它们存在歧义(图 29)。
  4. 清除过滤器。
图 28. 您可以进行过滤,仅显示被拒绝的需求工件。
按属性过滤
图 29. 显示了已应用过滤器的模块。
应用了过滤器的模块
应用了过滤器的模块

练习 15. 同时编辑多个工件的属性

常常,各个工件的属性具有相同的值。可以同时编辑多个工件的属性值。

在此练习中,第 3.2 节的最后 5 个需求没有 Status 属性的值。要同时设置这 5 个属性的值,可以完成以下步骤:

  1. 选择所有 5 个工件的复选框(图 30)。
  2. 在一个工件的 row edit 菜单中,单击 Edit the attributes for 5 Artifacts图 30)。
  3. 在 Edit Attributes 窗口中,选择 Status 并将该值设置为 In Process。单击 OK
图 30. 可以同时编辑多个工件的属性。
同时编辑
同时编辑

练习 16. 为一个工件添加注释

在线讨论可以记录人员之间的沟通,无论讨论是直接与客户进行,还是在您组织内的不同利益相关者和领域专家之间进行。团队可以使用注释来协作,以某种所有人都可以看到的格式来集中捕获反馈,而且不会让反馈埋没在电子邮件或聊天窗口中。

  1. 在模块的内容内,找到此需求:Any portable equipment shall be yellow.。此需求正在进行审核。
  2. 在 Comments 列(图 26)中,通过将鼠标悬停在该列中并单击 Create Comment,为工件创建一条注释。
  3. 在 “Create comment for Artifact” 窗口中,提供以下信息:
    1. 对于主题,键入 Why yellow?
    2. 对于注释,键入 Why are we not using our company color?
    3. Directed to 字段中,将该注释定向到项目的另一个成员。如果使用了沙箱,那么项目中没有其他成员。
    4. 对于优先级,可以选择 Medium
  4. 将鼠标悬停在注释列中的注释指示器 注释指示器图标 上,以便审核注释。

练习 17. 创建一个需求工件

  1. 转到第 2.5 节 Operational Environments,这是一个标题。
  2. 创建一个利益相关者需求:
    1. 单击 2.5 Operational Environments,在它的菜单中单击 Insert New Artifact > Below (as a child)。新工件将会具有与您选择的工件相同的类型,在本例中为 Heading(图 31)。
    2. 将工件类型更改为 Stakeholder Requirement
    3. 对于需求的内容,可以键入 The human reader shall be able to locate the handheld unit
    4. 保存需求工件。
图 31. 可以创建一个具有特定类型的工件。
一种特定类型的工件
一种特定类型的工件

练习 18. 在模块中创建一节

发现了一个新的利益相关者:Marketing and Research。在第 2 节 Stakeholder Requirements 中,添加一节:

  1. 单击 2.General Description,在它的菜单中单击 Insert New Artifact > Below (as a child)。新工件将具有与您选择的工件相同的类型,在本例中为 Heading。新工件在分层结构中是第 2 节的子节。对于工件的内容,键入 Marketing and Research
  2. 查看编号。后续各节会根据需要进行编号。
图 32. 创建一节时,后续各节也会编号。
小节编号
小节编号

练习 19. 重新排列模块中的各节

如果从模块分层结构中选择一个父节并将它移动到一个新位置,它的所有子节也会移动。

单击小节 2.6 Regulatory 并将它移动到 2.3 小节 Product Perspective 之后(图 33)。您移动的工件会变成新的 2.4 小节,所有后续编号都会更新。

图 33. 移动一个模块中的工件时,分层结构会发生更改。
移动一个模块中的工件
移动一个模块中的工件

重新组织模块的结构时,模块会自动锁定。内容仍然可编辑,但结构不行。完成编辑时,结构会解锁。

如果计划大范围地调整模块的结构,那么可以考虑手动锁定它。完成操作后,一定要解锁该模块。

备注:在模块中工作时的键盘快捷键:

  • Shift+Alt+Right Arrow - 将一个工件移动分层结构中的更高级别。
  • Shift+Alt+Left Arrow - 将一个工件移动分层结构中的更低级别。
  • Ctrl+K、Ctrl+Alt+K 或 Ctrl+Shift+K - 创建一个工件并将他添加到当前行之后、下方或之前。
  • Ctrl+E、Ctrl+Alt+E 或 Ctrl+Shift+E - 将一个现有的工件添加到当前行的后面、下方或前面。
  • Ctrl+Enter、Ctrl+Alt+Enter 或 Ctrl+Shift+Enter - 在当前行的后面、下方或前面创建一个类似工件。
  • Ctrl+H - 将当前行更改为标题或从标题更改。

有关的更多信息,请参阅信息中心:Rational DOORS Next Generation 的键盘快捷键

使用链接关系跟踪工件活动

要证明一致性和合规性,能够跨生命周期而捕获和分析可跟踪性关系至关重要。在需要分析需求更改的影响时,可跟踪性也会对您所帮助(图 2)。

在 Rational DOORS Next Generation 中,可以连接产品中和整个生命周期中的相关信息。如果将该产品安装为 Rational CLM 解决方案的一部分,那么可以从需求工件链接到其他 CLM 应用程序中的测试案例和工作项。此外,还可以链接到其他任何支持基于 OSLC 的链接的应用程序。需要分析信息和制定决策时,此链接能力尤其有用。

链接提供了可跟踪性。您可以验证您构建的功能是否满足用户需求。例如,可以将一个用户需求链接到满足该需求的设计特性。也可以将设计特性链接到该特性的验证测试,比如 IBM® Rational® Quality Manager 中的一个测试案例。可以朝两个方向都建立链接。例如,如果一个测试失败,那么您可以通过跟踪从测试到设计特性的链接,发现哪些需求受到了影响。也可以根据设计特性来跟踪需求。

链接对管理更改很有帮助。您可以快速跟踪对一部分数据的更改会对系统的剩余部分有何影响。

查看可跟踪性

可跟踪性可以在各列中看到。可跟踪性也能够以图形方式进行查看。

查看可跟踪性时,可以确定信息的相关性,识别可能已被丢弃(镀金)的需求或没有与更高级需求的链接、在开发期间悄然产生的需求(范围蔓延)。例如,某个需求未得到满足的一种迹象是,它没有链接。

可以使用过滤器找到没有链接的需求。此外,您还可以配置视图,以便跨多个需求文档,或者跨其他工具中管理的用例、模型和设计、测试和工作项进行跟踪。

练习 20. 查看和分析可跟踪性

在左侧边栏中的 View 节中,找到 Upstream 和 Downstream Traceability 视图。如果将鼠标悬停在视图上,可以看到它是一个可用在所有模块中的共享视图。如果单击该视图,模块的内容也会发生改变,以便包含 Satisfies 和 Satisfied By columns,其中包含可跟踪性信息。

图 2 中,可以看到一个利益相关者需求满足一个前景文档中的一个或多个前景声明。此外,利益相关者需求由一个系统需求来满足。

在接下来的练习中,将会通过两种方式查看可跟踪性:在列中和以图形方式查看。

20.1 在列中查看可跟踪性
  1. 滚动文档,可以注意到没有利益相关者需求链接到前景声明(依据 图 2 中捕获的链接模式,查看 Satisfies 列)。此外,许多利益相关者需求都链接到系统需求。为什么您会假设与前景文档的链接已丢失?
    (回答:项目中没有前景文档。)
  2. 找到此利益相关者需求:
    仪表接口单元应与用于此项目中涵盖的区域的现有仪表模型兼容。
  3. 找到与该需求相关的以下信息:
    1. 该需求的状态是什么?
      (答案:拒绝)
    2. 此利益相关者需求链接到一个系统需求。此链接表明什么?
      (答案:此需求链接到一个系统需求。该链接表示即使此需求被拒绝,仍然可以在它之上完成一些工作。该工作可能已在该需求被拒绝之前完成。您可能需要确定该工作是否应该继续。)
    3. 链接的系统需求是否链接到其他任何地方?如果是,请查看这些链接,以确定它们表明什么。例如,这些链接可能指出了没有必要在一个拒绝的需求上继续的工作。这些链接可能还表明,即使该需求被拒绝,它之上的工作仍然必须继续进行,因为程序的其他部分可能需要它。您属于哪种情况?
      (回答:将鼠标悬停在链接的系统需求上时,可以看到它仅有一个链接:您查看的利益相关者需求的链接。)
20.2 在链接浏览器中查看可跟踪性
  1. 找到此需求工件,它是一个系统需求:
    “仪表接口应检测水泄漏,记录泄漏状态和帐户数据。”
  2. 单击该工件,在它的菜单中单击 Other Actions > Open Links Explorer图 34)。
    图 34. 可以从工件的菜单中打开链接浏览器。
    打开链接浏览器
    打开链接浏览器

    链接浏览器显示一个利益相关者需求如何追溯到系统需求。

  3. 展开系统需求。可以看到与更低级需求的链接如何在分层结构中层叠。
    图 35. 链接浏览器显示了需求是如何彼此链接的。

    如果与 Rational DOORS Next Generation 一起安装了其他 CLM 产品,那么您可以使用与计划相关的 Jazz 特性;创建任务或提出缺陷;将工作分配给团队成员;在仪表板上查看和报告进度。

  4. 关闭链接浏览器。

练习 21. 导航可跟踪性

可以通过多种方式导航可跟踪性:使用富悬停弹窗、可跟踪性列和链接浏览器。

  1. 在 Satisfied By 列中,单击该超链接打开系统需求模块。
  2. 单击此工件:The meter interface shall detect water leaks and record leak status with the account data.
  3. 应用 Upstream and Downstream Traceability 视图。应用该视图后,您可能需要再次找到并单击此工件。您应该很熟悉该视图;您可以完成与之前类似类型的分析。
    1. 查找未链接到利益相关者需求的需求工件。这些工件可能表明存在范围蔓延,其中的开发工作都花在未达成一致的功能上(图 36)。
    2. 查找未链接到下游的系统需求。这些工件可能表明丢弃了需求(图 36)。
图 36. 可以在可跟踪性视图中识别范围蔓延和超出需求的特性。
范围蔓延和增加超出需求的特性
范围蔓延和增加超出需求的特性

练习 22. 拖动工件来创建可跟踪性

创建可跟踪性的最轻松方式是,拖动工件来创建链接。

在此练习中,系统需求 Meter usage data and leak diagnostic data shall be retrievable on demand from any meter interface via the network or a handheld 未链接到此利益相关者需求:

The meter interface shall detect water leaks and record leak status with the account data


您将修复该空白,创建一个链接来表明系统需求满足该利益相关者需求。

  1. 调整系统需求窗口,以便让它填满屏幕的右半部分。
  2. 打开软件需求窗口并调整它,以便让它填满屏幕左半部分(图 37)。
    图 37. 拖动工件来创建链接。如果拖动工件来创建一个链接列,那么可以创建一个该类型的链接。如果将该工件拖到另一个工件,那么可以选择要创建的链接类型。
    拖动工件来创建链接
    拖动工件来创建链接
  3. 将以下系统需求
    Meter usage data and leak diagnostic data shall be retrievable on demand from any meter interface via the network or a handheld 拖到以下利益相关者需求之上
    "The meter interface shall detect water leaks and record leak status with the account data."
    图 38. 在 Create Link 窗口中,可以指明要创建的链接类型。
    Create Link 窗口
    Create Link 窗口
  4. 如果 Satisfied By 列未显示,系统会提示您显示它。单击 Yes。然后会创建该链接(图 39)。
    图 39. 该链接已创建并显示在列中。
    链接的列显示
    链接的列显示

达成一致并使用仪表板来监视项目进度

仪表板是一种在一个页面上显示来自不同来源的各种类型数据的方式。它们对大体跟踪状态、进度和活动很有用。它们可以包含来自所有 CLM 产品的信息。您可以自定义仪表板来跟踪任何数据,还可以访问仪表板上的链接来获取更多的细节。

图 40. 包含需求、开发和测试信息的仪表板。
包含需求、开发和测试信息的仪表板
包含需求、开发和测试信息的仪表板

存在多种类型的仪表板:

  • 个人仪表板对显示一个团队成员感兴趣的信息很有用。
  • 项目仪表板对从总体上跟踪整个项目的状态或进度很有用。
  • 团队仪表板对跟踪特定于一个团队的需要的信息或状态很有用。
  • 微型仪表板是显示有限数量的高优先级小部件的小仪表板。您可以在任何上下文下查看微型仪表板。例如,可以在模块上工作时查看微型仪表板。同一个微型仪表板可以在项目的其他区域中使用,甚至可以从 Jazz Team Server 中的其他 CLM 功能(比如工作项)使用。

练习 23. 自定义您的项目仪表板

根据您如何设置练习环境,您在此练习期间添加的小部件可能已在仪表板上。此练习的用途是学习如何处理小部件,自定义您的仪表板。

23.1) 导航到项目仪表板

在左上角,单击 Project DashboardGeneral 选项卡已显示了一些小部件。

23.2) 向仪表板添加一个新选项卡
  1. 要向仪表板添加一个选项卡,可以单击 Add New Tab 图标(图 41)。
    图 41. 单击 Add New Tab 图标将一个选项卡添加到仪表板中。
  2. 默认情况下,新选项卡名为 New Tab。单击选项卡的名称,将它重命名为 Tutorial(图 42)。
    图 42. 在仪表板的 Tutorial 选项卡上添加新的小部件。
    在 Tutorial 选项卡上添加小部件
    在 Tutorial 选项卡上添加小部件
23.3) 向仪表板添加小部件
  1. 要向仪表板添加小部件,可以单击 Add Widget 图标(图 42)。这将展开一个窗格,显示多个小部件,一个类别列表,以及其他选项(图 43)。小部件是按目录和类别进行组织的。该窗格是按目录进行组织的,所以您可以从所有与此项目关联的应用程序以及 Jazz Team Server 添加小部件。
    图 43. 小部件是按目录和类别进行组织的。
    小部件是按目录和类别进行组织的
    小部件是按目录和类别进行组织的
  2. Select Catalog 列表中,选择 Requirements Management
  3. 单击 Projects/Team 类别。找到 Team Members 小部件并单击 Add Widget 添加它。Team Members 小部件显示了一组术语一个团队或一个项目区域的贡献者,以及它们的角色。
  4. 单击 Requirements 类别并添加以下小部件:
    • Comments:此小部件列出您所属的所有项目中的最新注释。它还显示了与这些注释相关的工件。单击一个链接可以访问相应的工件,或者单击某个人的姓名来向其发送电子邮件。
    • Recent changes:此小部件显示您所属的所有项目中最近修改的工件。单击一个链接可以访问相应的工件。
  5. 关闭窗格。
23.4) 组织仪表板
  1. 依据您的需要,可以通过折叠小部件或移动它们来组织仪表板。
  2. 保存仪表板。

您修改了一个仪表板。如果项目有一些评论,那么可以将这些评论显示在仪表板上。在完成此教程后,可以计划进一步探索此功能。

图 44. 可以自定义项目仪表板来满足团队的需要。
自定义的仪表板
自定义的仪表板

备注:可以采用修改项目仪表板的方式来修改您的个人仪表板和微型仪表板。视频:使用一个 URL 向微型仪表板添加扩展

为开发流程的整个生命周期提供支持

Rational DOORS Next Generation 使用 Jazz 技术构建于 Jazz Team Server 之上。该产品是 Rational solution for Collaborative Lifecycle Management (CLM) [http://www.ibm.com/developerworks/cn/downloads/r/clm/] 和 Rational 系统和软件工程 (SSE) 解决方案的一部分。

除了 Rational DOORS Next Generation 之外,Rational CLM 解决方案还包含 Rational Team Concert 和 Rational Quality Manager。因为这些产品都构建于 Jazz 技术平台之上 [https://jazz.net/story/about/about-jazz-platform.jsp],所以它们共享了一个通用的用户界面、管理页面和许多服务。

Rational SSE 解决方案包含 Rational Quality Manager、Rational Team Concert、Rational DOORS Next Generation 和 Design Management,团队可以使用它来改善建模和生命周期可跟踪性。

相关帮助主题

可疑的可跟踪性
可跟踪性用于从一个项目元素跟踪到相关的项目元素,尤其是与需求相关的元素。可跟踪性能够帮助确定需求是否从一开始就通过实现和测试得到了满足。可疑可跟踪性表明对链接的工件的更改的潜在影响。

与开发、设计、测试和需求工件的链接
您可以使用 Rational 协作式生命周期管理 (CLM) 解决方案产品和其他 OSLC 生命周期集成,创建与其他产品中新的和现有工件的链接

创建工件来支持需求
在需求项目中,可以创建模块工件、富文本工件和图形工件,比如用例、故事板和业务流程图。

审核工件
从一开始就获取您的需求有助于节省时间和金钱。您可以创建对选定工件的审核。您可以指定其他团队成员参与审核。参与者会收到请求,根据他们在审核中指定的角色,他们可以批准、反对、审核或放弃审核每个工件。

创建需求项目模板
您可以从现有项目创建项目模板,选择要包含在模板中的项目元素。您可以包含或排除:工件、工件模板、工件类型和属性、工件之间的链接、链接类型、文件夹结构、标记,以及共享的以保存过滤器。在创建需求项目的模板后,就无法再修改这些模板。

需求项目的基准
在需求项目中,一个基准在一个特定时刻将会捕获整个项目的信息。例如,您可以在一次工件审核后创建一个项目基准。一个基准包含所有工件、文件夹树,以及公共标记。

扩展需求管理 (RM) 应用程序
您可以创作对需求管理 (RM) 应用程序的扩展来增强它。这些扩展可以增强生产力,对分析很有用。

使用 OSLC 服务扩展 Rational DOORS Next Generation
Open Services for Lifecycle Collaboration (OSLC) 是一个社区,它标准化了生命周期工具协同工作的方式。IBM® Rational® DOORS® Next Generation 支持使用 OSLC 数据共享规范作为需求管理 (RM) 领域的提供者,作为 Rational 协作式生命周期管理 (CLM) 解决方案中的其他领域的使用者。数据共享也受其他支持 OSLC 集成的 RM 工具的支持,比如 IBM Rational DOORS。

需求管理 (RM) 应用程序中的报告
您可以运行和查看基于一个数据仓库的报告,创建需求和其他生命周期数据的文档样式的报告。

更多参考资料:

Jazz.net 上的 IBM Rational DOORS Next Generation 产品页面

Rational 协作式生命周期管理解决方案文档

Rational DOORS Next Generation 学习周期


相关主题


评论

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

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=988563
ArticleTitle=IBM Rational DOORS Next Generation V4.0.6 入门
publish-date=11062014