内容


在 Rational Team Concert 和 Rational RequisitePro 之间同步需求

使用 Jazz Connector 来从需求初始化项目计划

Comments

连接器可以做什么

对于需求您有三件事要做并且可以做:使用它们来驱动设计和开发,驱动测试,驱动您的规划。下面显示的图向您展示了项目管理员,结构师和测试领导等角色是怎样使用需求来促进开发任务的。

图 1. 需求使用
项目管理员,结构师和测试领导的需求样式基础
项目管理员,结构师和测试领导的需求样式基础

本文描述了一个 IBM® Rational® Jazz™ 连接器,它从 IBM® Rational® RequisitePro® 处复制需求到 IBM® Rational Team Concert® 中的规划项目之中。然后需求可以分配给迭代,并分解成开发团队可以实施的任务。这种方法可以确保规划在需求层次上得到管理,而且实施需求的进度(正常情况下是事例或者用例场景)可以得到测量和管理。

这里的代码使用了 Jazz 连接器结构,这带来了一定的优势。首先他提供了一个综合的映射框架,这样 Rational Team Concert 之中的字段了。同样,框架提供了功能强大的同步化机制,以确保更改在两个系统之间得到成功的传递,并在发送冲突时解决问题。

连接器还提供了两种机制,以选择同步化什么需求。您可以选择同步化特定种类所有顶级层次的需求,或者您可以选择一个视图进行同步化。创建多个同步化也成为可能的了,这样如果您想要同步化多种类型的需求,那么您可以简单地创建并运行一些同步化操作。

删除以前的版本

建议您将连接器的以前版本删除掉。按照以下的步骤来卸载连接器的早期版本:

  1. 在文件系统之中,从服务器目录中删除掉 RequisitePro 连接器更新站点文件夹,并从 Jazz 服务器 InstallDir/jazz/server/conf/Jazz/provision_profiles 之中删除掉 reqproconnector.ini 文件。
  2. 启动 RTC 服务器,然后切换至 https://localhost:9443/jazz/admin/cmd/requestReset,并重启服务器。
  3. 关闭服务器,重启它以刷新插件,然后再次将其关闭以为安装新连接器做好准备。

以前版本的连接器现在已经卸载掉了。

安装服务器

安装服务器是一个简单的过程。当您解压本文中所包含的(参见 下载 部分)ReqProCon_server.zip 文件时,您可以查看名为 com.ibm.uk.reqproconnector.repositorymanager.updatesite 的文件夹,以及一个名为 reqproconnector.ini 的文件。按照下面的步骤来安装连接器的服务器端:

  1. com.ibm.uk.reqproconnector.repositorymanager.updatesite 文件夹复制到 JazzInstallDir/Jazz/server
  2. reqproconnector.ini 文件复制到 JazzInstallDir/server/conf/jazz/provision_profiles 之中。

现在您的文件系统如图 2 所示。

图 2. 服务器文件系统
Jazz 服务器文件系统显示了安装的插件
Jazz 服务器文件系统显示了安装的插件
  1. 现在您可以重启 Jazz 服务器以载入更改。

创建和配置服务器,并同步化规则

既然服务器端构件已经得到了安装,那么现在您需要做两件事情。首先您需要配置即将同步化的工作项类型。第二您需要创建一个同步化规则。

配置工作项类型以为同步化做好准备

为了让同步化发挥作用,您需要存储工作项的需求键值。所以您需要创建工作项的新字段,以存储该键值。

  1. 右击项目区域,并选择 Open
  2. 点击 Process Configuration 项,然后切换至 Project Configuration > ConfigurationData > Work Items > Types and Attributes
  3. 在下拉菜单之中,选择您想要同步化需求的类型,然后添加一个名为 key 的通用属性, ID 为 key,类型为 Small String
  4. 保存 更改。
图 3. 通用事例的范例,包括键值字段
使用键值字段定制的事例工作项
使用键值字段定制的事例工作项

创建一个同步化规则

现在您需要创建同步化规则,它就是 RequisitePro 字段对工作项字段的映射。

  1. 首先,选择 Team Artifacts 视图之中的联系。右击并选择 Administer > Synchronization Rules
图 4. 管理员同步化规则的菜单项
两个选项突出显示的两个下拉菜单
两个选项突出显示的两个下拉菜单

现在我们要创建一个一个新的外部性联系以代表 RequisitePro 项目:

  1. Synchronization Rules 视图中,右击 External Repository ConnectionsSynchronization,并选择 New > External Repository Connection
  2. 指定联系的名字, RequisitePro REST 联系的名字(例如:http://reqwebhostname/ReqWeb/Servlet/project/projectname),登录私密性信息的名字,以及目标项目区域的名字。

    注意: 有一个限制条件,那就是 RequisiteWeb 目录之中项目的名字中不能有任何空格。

界面如图 5 所示。

图 5. External Repository Connection 窗口
Properties 对话框
Properties 对话框

现在您需要创建 RequisitePro 与 Rational Team Concert 之间的映射。

  1. 在 Synchronization Rule 视图之中,右击项目区域并选择 New > Synchronization Rule。按照以下的步骤来创建规则 :
  2. 指定规则的名字。
  3. 在界面的左上部,指定工作项的类型,您在前面所创建的外部性储存库,外部性管理器(RequisiteWeb 7.1),以及您想要保持同步化的需求类型。
  4. 然后指定映射。您至少需要指定以下内容 :
    • FiledAgainst: Team
    • Key: key(确定您已经将键值标记为外部性标识符)
    • Type: RtcType
    • Summary: Name
  5. 注意 FiledAgainst 属性需要使用 CategoryTransformer,所以取消 No Transformation (Just Copy) 的选择并在下拉菜单中选择 CategoryTransformer
  6. 如果您遇到了枚举型的字段,那么您可以将两个字段映射到一起,取消 No Transformation (Just Copy) 复选框的选择,然后将枚举型映射添加至 Value Mapping 框之中。

当您完成操作之后,同步化规则如图 6 所示。

图 6. 一个简单的同步化规则
显示 Type, Property 以及 Value 映射选项
显示 Type, Property 以及 Value 映射选项

现在您需要为同步化客户端配置许可证(同样参见图 7)。客户端需要 Synchronize with external objects 许可证。您可以向项目添加执行同步化的用户,或者编辑项目设置,这样所有的用户都拥有该许可权了。

  1. 为了完成该操作,您可以打开项目区域,点击 Process Configuration 项,并切换至 Team Configuration > Permissions
  2. 然后,在主操作板之中,选择 Item Connector > Synchronize with external objects,并确定选择的用户或者每一个人都有这样操作的许可权。
图 7. 与外部性对象同步化的项目许可权
 Item Connections 之下的选项
Item Connections 之下的选项

安装客户端

  1. 为了安装客户端,您可以下载并从本文的 下载 部分中下载并解压 ReqProCon_client.zip 文件。
  2. 编辑 start_reqpro_connector.bat 文件,并更新环境变量至 Jazz 客户端 jre bin 目录以及 ext 目录之中。

    注意:
    它必须是 Jazz 客户端提供的 JRE(Java™ Runtime Environment)。

  3. 然后您需要从 jazz.net 处 下载客户端 Java Archive(JAR)文件 ,然后将其保存在与客户端相同目录下名为 jpjc 的文件夹之中。
  4. 现在您需要再次更新批文件,并将 JAVA_CLIENT_JARS 变量设置为指向含有所有 Java™ Archive(JAR)文件的目录。

运行同步化

为了运行同步化,首先您需要根据设置来编辑 reqproconnector.properties 文件。您可以配置怎样选择需求,或者根据需求类型选择,或者根据视图来选择。在提供的文件之中,是根据选择的视图来配置的,您还可以根据需求来进行选择。

  1. 这有助于创建一个单独的用户以和连接器一起使用。用户必须拥有 Jazz Admin 优先权并有一个开发器,构建,以及一个 IBM® Rational® ClearCase® 连接器或者 IBM® Rational® ClearQuest® 连接器客户端许可证。
  2. 然后,从命令行中,运行 start_reqpro_conector.bat 文件。这将会连接到 RequisitePro 上,并将需求与 Jazz Team Server 进行同步化。
  3. 在您确认连接器发挥作用,并将需求复制到 Jazz Team Server 中之后,选择 Control Panel > Scheduled Tasks > Add Scheduled Task 来设置该文件以按频繁的间隔来运行,并安排文件以每隔 15 分钟来运行一次。
  4. 逆向同步化会由 Jazz Team Server 自动处理。但是,为了进行强制同步化,您可以选择 Synchronization Rule 视图之中的规则,右击并选择 Synchronize Out

提示:
如果需求更改在系统之间没有得到适当的流动,那么这可能是因为需求在同一个同步化期间在两个系统中得到了同时更改。在这种情况下,失败的需求将会显示为未同步化,而且您可以决定接受什么更改。为了查看未同步化的需求,您可以点击 SynchronizationView 之中的规则并选择 Show Unsynchronized

图 8. Show Unsynchronized 菜单项
下拉菜单之中的选项

现在您已经可以看到了,来自 Rational RequisitePro 的需求与 Rational Team Concert 之中工作项之间的双向同步化了。

限制条件

连接器拥有以下的限制条件:

  • Rational RequisitePro 多项选择枚举字段在映射中并不支持。
  • 注册为 RequisiteWeb 的项目的名字中不应该包含有空格。这可以通过向 RequisiteWeb 目录添加第二个条目以与连接器一起使用而发挥作用。

总结

您可以使用 Rational RequisitePro 以及 Rational Team Concert Connector ,以用高层次的规划项来同步化需求。这意味着项目规划对一致的需求拥有强大的追踪功能,通过确保列出的需求得到了规划,评价以及交付,就会产生改善的项目交付性能以及提高的客户满意度。这个版本的连接器得到了重新设计,以使用 RequisitePro REST APIs,这意味着您可以在除 Microsoft Windows 服务器之外的服务器上使用它。


下载资源


相关主题


评论

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

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Rational
ArticleID=587475
ArticleTitle=在 Rational Team Concert 和 Rational RequisitePro 之间同步需求
publish-date=11152010