示例:从支持 RESTful API 的应用程序中检索工件

此示例描述了如何从 Rational® solution for Collaborative Lifecycle Management 的“需求管理”应用程序中检索工件,以及如何在 IBM® Rational Focal Point™ 中创建元素。

用途

如果您在“需求管理”应用程序中具有需求并且想要在 Rational Focal Point 中对这些需求划分优先级,那么您可以使用 REST 客户机视图命令来检索这些需求。
先决条件
  • 在配置集成的计算机的主机文件中,设置 Rational solution for CLM 服务器的 IP 地址和主机名。对于 Windows,该主机文件通常位于 C:\Windows\System32\drivers\etc,对于 Linux,该主机文件位于 /etc/hosts
  • Rational Focal Point 中,将“需求管理”应用程序添加为好友(出站)。 有关更多信息,请参阅连接到 Rational solution for Collaborative Lifecycle Management 应用程序服务器
  • 请注意“需求管理”应用程序工件的 XML 结构以及是否有权访问这些工件。

样本

此示例假设 Rational Focal Point 具有工作空间 FP-RRC 和视图查看 RRC 需求。 下表显示了 Rational Focal Point 和“需求管理”应用程序中可用的一些属性。
表 1. Rational Focal Point 和“需求管理”应用程序的属性
Rational Focal Point 属性 “需求管理”应用程序属性
燃料选项 rrm:description
燃料效率 rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
集成链接 rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
标题 ds:location/ds:project/rrm:title
  1. Rational Focal Point 中,打开要检索工件的 FP-RRC 工作空间。
  2. 单击配置 > REST 客户机视图命令,然后单击添加视图命令
  3. REST 客户机连接符名称中,输入用于标识连接的 RRC 连接符
  4. REST 请求方法中,选择 GET 方法。
  5. 好友列表中,选择 RRC
  6. REST 应用程序请求 URL 中,输入包含要检索工件的应用程序 URL。 例如,要从“需求管理”应用程序中获取工件,请输入 https://<hostName>:<portNumber>/rm/<projectName>/<collectionName>
    提示: 打开 Web 浏览器,然后输入在将“需求管理”应用程序添加为好友时使用的 URL。这样会显示高级工件的列表。找到您要检索的工件,然后将其 URL 复制在 REST 应用程序请求 URL 中。
  7. 单击连接
  8. 单击选择根 XPath 以将工件搜索范围限制为一个集合。选择 /ds:dataSource/ds:artifact。 XPath 用于缩小工件搜索范围。XPaths 是应用程序的分层 XML 结构。
  9. 为了确保工件不重复,请在标识映射部分中,单击添加并将 Rational Focal Point燃料选项映射到“需求管理”应用程序的 rrm:description。您只能映射一个属性。
  10. 属性映射部分中,单击添加以在“需求管理”应用程序和 Rational Focal Point 之间映射以下属性。 这样会针对从应用程序检索的元素显示已映射的属性。确保这些属性可编辑。
    注: 您在标识映射部分中选择的属性未显示在属性映射部分中,因为该属性在内部进行映射,且对已访存元素可用。
    表 2. 在 Rational Focal Point 和“需求管理”应用程序之间映射属性
    Rational Focal Point 属性 “需求管理”应用程序属性
    燃料效率 rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    集成链接 rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    标题 ds:location/ds:project/rrm:title
  11. REST 应用程序支持的日期格式字段中,输入 2012-08-18
  12. Focal Point 分隔符字段中,使 , 保持不变。
  13. 单击保存
  14. 打开查看 RRC 需求视图,然后从下拉列表中选择 RRC 连接符。这样会在该视图中检索需求和属性的列表并将这些需求和属性创建为元素。

反馈