使用 IBM Rational RequisitePro、IBM Rational Software Architect 以及 BIRT 管理 UML 模型与需求之间的可追溯性，第 1 部分: 需求报表

第 6 页，共 11 页 文档选项 对本教程的评价 帮助我们改进这些内容

建立需求数据集

下面对您创建需求数据集之前必需设置进行了简短的概述。

• RequisitePro BIRT ODA Java™档案 （JAR） 文件必须被添加到 Rational Software Architect

• RequisitePro 项目必须有安全激活
• RequisitePro project 必须能够通过 RequisiteWeb 进行访问

要创建一个新的 RequisitePro 数据源，可按照以下步骤操作。

1. 在 Data Explorer 中，从您的报告中选择 Data Sources。
   
2. 指出您希望创建一个新 IBM Rational RequisitePro Data Source。
   
3. 给这个数据源命名为 RequirementsThatLink，如图 32 所示。

4. 接下来，确定这个 RequisiteWeb 服务器，如图 33 所示。

5. 在这个例子中，RequisiteWeb 服务器IP地址为 192.168.0.110。一旦提供了这个地址，就点击 Connect。这个对话框应该表明到这台服务器的链接已经成功，如图 34 所示。

注意，作为一个成功的服务器连接结果，这个 Project 选项是激活的并且应该反映这台服务器上的 RequisiteWeb 项目是可使用的，如图 35 所示。

6. 选择 Learning Project – Use Cases 项目，提供登录信息，并按下 OK键，如图 36 所示。

这个对话框应该表明验证是成功的（换句话说，这个用户能够成功地验证指定的项目）。由于成功地进行了验证，这个 Project Items 的下拉菜单应该是激活的。

7. 选择 Packages并点击 OK，如图 37 所示。

选择了这个选项，这个对话框的 Explorer 部分应该表明这个项目的结构。

8. 选择 Eclipse Element Proxies RequisitePro 报告，它限制了这个包（和它的次级包）的范围。
   
9. 此外，确保 Requirements过滤已经选择，如图 39 所示。
   
10. 然后点击这个对话框中的 Generate URL和 Finish。

    注意这个新数据源将在这个项目的最高层中返回需求和软件包。

这个 Requirements 数据源这是已经被指定。您现在已经准备好开始在您的 RequisitePro 项目中查询需求的具体问题。也就是说，您现在要转向为这个新数据源创建数据集。

创建数据集

11. 由于有了先前创建的 UML 数据集，选择 Data Explorer 中的 Data Sets，右键点击并选择 New Data Set来开始这个向导。

12. 提供这个 Data Set Name LinkedReqs，并确保 Data Set Type和 Data Source 是正确的，如图 40 所示。
    
13. 点击 Next。

注意 RequisitePro 数据集都是基于 XML 的。

14. 因此，选择 使用数据源中定义的 XML 文件无线按钮，如图 41 所示。

15. 选择 Next提前来到图 42 中所显示的 Table Mapping 页面。

注意这个数据源，如指定那样，已经生成了 XML，它显示了这个需求项目的软件包结构。

16. 选择 Req 并将它添加到图表映射查询中。

17. 在最后结果的对话框中，选择 在固定绝对路径中名称为 "Req" 的 XML 元素并点击 OK。

注意图表映射查询 （被指定为一个 XPath 查询） 现在是 /PROJECT/Pkg/Requirements/Req，如图 44 所示。

查询操作如下：无论在这个软件包结构 （如数据源中所指定的 Eclipse Element Proxies 包）中的什么位置查找到 Req （Requirement），都会返回这个需求。

回页首

列映射

18. 选择 Next从而转入如图 45 所示的列映射中。

如注释的那样，对于报告作者来说，几个 Req 属性都是可使用的。与您的报告相关的属性如下所示（如图 46 所示）：

• GUID
• RPre
• FVs/FV/FLbl
• FVs/FV/FTxt

19. 通过点击 Show Sample Data 按钮使这个数据集生效。结果如图 47 所示。

这时，查询会返回内嵌在 Eclipse Element Proxies包所有的（代理）需求，您可以选择每个需求的属性：

• GUID（唯一的 RequisitePro 标识符）
• 需求标签
• 属性名称 （AssociatedElementUri）
• 属性（字符串）值 （模型元素 URI 的 RequisitePro 和 Rational Software Architect 表现，并且这个模型元素与代理需求相连接）

回页首

变更这个模型元素 URI 形式

下一个步骤是将模型元素 URI 的形式转换成如 UML 数据集所引用的那样能够与 URIs 相比较的形式。

20. 通过添加一个新计算栏（点击 New） 来开始这个步骤，如图 48 所示。

21. 在 New Computed Column 对话框中：
1. 输入 URI作为 Column Name
2. 选择 String作为 Data Type
3. 调用这个表达编辑器 （点击 fx）。

22. 然后，在这个 Java™Script 表达生成器（如图 50 所示）中，您可以通过以下操作来计算一个一致性 URI：
1. 从这个值中清除首列的 uml：
2. 将分隔符从 >更改为 #
3. 当作有都在 ?字符前面时才可以返回

您打代码看起来应该如列表 1 所示。

					
//	
// 如果这个属性是 AssociatedElementUri，仅仅处理这个值
//
if(row["FLbl"] == "AssociatedElementUri") {
      //
      // 生成一个与 Rational Software Architect BIRT 查询一致的 URI
      //
      row["FTxt"].replace("uml:","").replace(">","#").split("?",2)[0]
}

23. 完成这个计算栏的表达和定义，并通过 Preview 使查询生效，如图 51 所示。

正如您看到的那样，通过这个查询所返回的每一行包含：

• RequisitePro GUID
• RequisitePro 标签 （来自 RPre域）
• RequisitePro 属性名称 （在这个案例中，代理需求只有一个属性。AssociatedElementUri属性）
• RequisitePro AssociatedElementUri属性值
• 这个计算 URI 与 Rational Software Architect 一致

这时，需求数据集已经完全确定。

您最终的目标是生成一个连接数据集，即将这两个基于常用 URI 属性值的数据集联合起来。

回页首

	第 6 页，共 11 页