根据多个需求项目创建基线

如何以编程方式使用 RequisitePro Baseline Manager Library 生成基线

IBM® Rational® RequisitePro® 中的 Baseline Manager Library 是一个 API,用户能够以编程方式使用它来创建基线。可以通过编写脚本来调整创建多个项目的基线的流程,或者将脚本安排为基于时间的任务来运行。使用该库,您可以创建在文档、Attribute Matrix 视图、包或整个项目中存在的需求的基线。

Fabian Lomeli, 软件工程师, IBM

Fabian LomeliFabian Lomeli 是墨西哥瓜达拉哈拉 IBM 的软件工程师,效力于 Rational RequisitePro 开发团队,他非常关注数据库、基线、LDAP 和 FIPS 主题。



2012 年 2 月 29 日

基线是项目中所存在内容的 XML 格式表示。IBM® Rational® RequisitePro® 包含一个工具,您可以使用该工具创建基线,在树结构中查看基线,或者是比较两个基线并生成比较报告。您还可以根据现有项目基线构建新项目。

有时,您需要能够创建多个项目的基线或者自动化基线创建。在这些情况下,您必须使用 Rational RequisitePro Baseline Manager Library 来轻松创建这些基线。

关于库

基线管理器库 (RqBaseComp.dll) 是 Rational RequisitePro Extensibility Interface (RPX) 的一部分。它包含 CreateBaseline 方法,该方法用于创建多个项目的基线或者自动化基线创建。

CreateBaseline 方法

The CreateBaseline 方法将 DataDescriptor 作为参数接收,提供有关 RequisitePro 基线的属性的信息。您可以在 Extensibility Interface Reference 下的 RequisitePro Help 菜单中找到有关 DataDescriptor 的更多信息。

下列行是一个语法示例:BaseCompDataDescriptor.CreateBaseLine(oData As DataDescriptor) As Boolean

BaseCompDataDescriptor 对象及其方法位于 RqBaseComp.dll 库中,该库包含在 Rational RequisitePro 安装文件夹的 bin 目录下:C:\Program Files\IBM\RationalSDLC\RequisitePro\bin\RqBaseComp.dll


根据库创建基线的用例

使用基线管理器库时,您可以通过编写脚本来定制基线创建任务。当您需要频繁地为同一项目创建基线,或者需要重复为多个项目创建基线时,可使用此方法,比如在下列情形中:

  • 在特定路径中为每个项目生成基线。
  • 根据 RequisitePro 目录为每个项目生成基线。
  • 以固定间隔(比如每日、每周或每月)生成基线。

代码示例

下列代码示例提供了使用 Visual Basic 或 Java 语言创建项目基线的指南。

清单 1 中的示例展示了如何创建 RequisitePro 示例项目的项目基线。要运行此脚本,则必须添加对该库的一个引用,比如 C:\Program Files\IBM\RationalSDLC\RequisitePro\bin\RqBaseComp.dll

清单 1. 创建项目基线

             Dim a_oData As RqBaseComp.DataDescriptor
             Dim a_oBaseComp As RqBaseComp.BaseCompApplication
             Dim a_sRQSPath As String
             Dim a_sProjectName As String

             Set a_oBaseComp = New RqBaseComp.BaseCompApplication
             Set a_oData = New RqBaseComp.DataDescriptor 
             a_sRQSPath = "C:\Program Files\IBM\RationalSDLC\RequisitePro" & _
             "\samples\Learning_Project-Use_Cases\"

             a_sProjectName = a_sRQSPath & "LEARNING - USE CASES.RQS"

             With a_oData
                  'set .ReqProProject = a_oProject ' can use this or the RQSFilepath
                .RQSFilePath = a_sProjectName
                .UserName = "admin"
                .UserPassword = ""
                .Location = a_sRQSPath & "Baselines"
                .Label = "Baseline-label"

                 'baseline type
                .ElementType = eProject

                ' what do you want to baseline
                .Traceability = True
                .Discussion = True
                .History = True
                .CPT = True

             End With
             ' Create the baseline
             a_oBaseComp.CreateBaseLine a_oData
             Set a_oBaseComp = Nothing
             Set a_oData = Nothing

清单 2 中的代码展示了如何使用 Java 语言创建项目基线。此特定代码片段显示,该代码将传递的基线选项作为参数使用,以便动态设置它们。

要运行此代码,您必须添加下列库:C:\Program Files\IBM\RationalSDLC\RequisitePro\lib\BaseComp.jar

清单 2. 创建项目基线

            BaseCompRPXProxy bcRPXProxy = (BaseCompRPXProxy) new
                BaseCompRPXProxy();
           RPXProxyDataDescriptor oDataDesc = new
                RPXProxyDataDescriptor();
          ProxyProject oProject = null;

          oProject = bcRPXProxy.openProject(projectPath, projectUserID,
                projectPWD);

            oDataDesc.project(oProject);
            oDataDesc.projectFilePath(projectPath);

            oDataDesc.userName(projectUserID);
            oDataDesc.userPassword(projectPWD);
            oDataDesc.label(projectLabel); 
            oDataDesc.location(projectDest);
           
            // Options
            oDataDesc.traceability(projectTraceability);
            oDataDesc.cpt(projectCPT);
            oDataDesc.discussion(projectDiscussion);
            oDataDesc.history(projectHistory);

            oDataDesc.elementType( EnumProxyElementType.project);

            bcRPXProxy.createBaseline(oDataDesc);

            oProject.closeProject();

将基线从 RequisitePro导入到 IBM Rational Requirements Composer

在 IBM Rational Requirements Composer 3.0.1.x 中,有一个可将从库创建的基线导入项目中的功能。通过选择 Administration > Import RequisitePro Project,可在 Requirements Composer 工具中使用此功能。

图 1. Import RequisitePro Project 向导
将基线从 RequisitePro 导入的界面

下载

描述名字大小
清单 1 的示例脚本CreateBaselineVB.zip5KB
清单 2 的示例脚本CreateBaselineJava.zip2KB

参考资料

学习

获得产品和技术

讨论

条评论

developerWorks: 登录

标有星(*)号的字段是必填字段。


需要一个 IBM ID?
忘记 IBM ID?


忘记密码?
更改您的密码

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件

 


在您首次登录 developerWorks 时,会为您创建一份个人概要。您的个人概要中的信息(您的姓名、国家/地区,以及公司名称)是公开显示的,而且会随着您发布的任何内容一起显示,除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。

所有提交的信息确保安全。

选择您的昵称



当您初次登录到 developerWorks 时,将会为您创建一份概要信息,您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的,并且出于隐私保护的原因,不能是您的电子邮件地址。

标有星(*)号的字段是必填字段。

(昵称长度在 3 至 31 个字符之间)

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件.

 


所有提交的信息确保安全。


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=799103
ArticleTitle=根据多个需求项目创建基线
publish-date=02292012