将 RQM 与 Shell 脚本进行集成

技术狂人

) M5 @  H+ S7 \' B! ~
: @6 o4 _& M5 n& ?4 t: y$ X3 RIBM Rational Quality Manager 是基于 Web 的协作性质量管理软件，用于贯穿软件生命周期的综合测试规划和测试资源管理。该软件建立在 Jazz 平台的基础之上，它适用于所有规模大小的测试团队，并支持不同的用户角色，例如测试管理员、测试结构师、测试负责人、测试员以及实验管理员，还有测试组织以外的角色。

. @: x: b( {) E- VRational Quality Manager 使您能够管理并运行由其他测试工具创建的自动测试脚本。您可以创建参考了由 IBM Rational Functional Tester、Rational Performance Tester、Rational Service Tester、Rational Robot，以及 Rational AppScan Tester Edition 创建的既有测试的测试脚本。不仅如此，Rational Quality Manager 同样可以管理并运行不同平台下的普通测试脚本，比如 windows 平台下的命令行脚本（bat 文件），以及 linux/unix 平台下的 shell 脚本。本文重点介绍在 Rational Quality Manager 如何管理普通脚本。
9 n- C1 Y! M9 ?  ^4 V6 N! {4 X5 f9 B
Rational Quality Manager 通过适配器完成测试工具与 Rational Quality Manager 之间的连接。适配器接收自 Rational Quality Manager 发出的请求，并调用安装在本地的测试工具来触发测试脚本。比如 Rational Performance Tester、Rational Robot、Rational AppScan Tester Edition 相应的适配器会在这些测试工具安装时被默认安装在本地。但是对于普通的 shell 脚本及命令行脚本，是没有适配被默认安装的。下文就重点描述这种情况的解决方案。
' N% S3 ], K6 h$ C% ]9 l

安装 Rational Quality Manager 对 Shell 脚本的适配器
8 V# ?" W3 o& K3 L- S9 B' }& Y2 P命令行适配器默认存放在 Rational Quality Manager 服务器的安装目录下，< Rational Quality Manager installation path>/server/adapters/RQMCommandLineAdapter.zip，你可以联系你的 Rational Quality Manager 管理员以获得此适配器，或者从本文的附件部分下载此适配器。
8 Q; I( k. @$ x# D0 i; P

---

配置适配器以连接 shell 脚本及 RQM 服务器
: B: p2 z  q, l& T* w  e: r& {$ ?  Q按照下面的步骤，来配置 Rational Quality Manager 中的 shell 脚本适配器：
# g$ O2 R/ D4 R% q1 L' ?( z

• 将文件 RQMCommandLineAdapter.zip 复制到 shell 脚本或命令行脚本所在的机器并将其解压。
• 打开一个命令提示符窗口。
• 切换 RQMCommandLineAdapter\ 目录，RQMCommandLineAdapter\ 目录就是适配器解压后所在的目录。
• 在 Windows 上输入命令 start.bat 或者在 Unix 系统上输入 start.sh 去启动适配器。
  

注意：初次启动适配器时需要在命令行添加必要的连接信息参数，启动适配器示例如下：

• Windows 平台启动命令：
  

C:\ start.bat -repository https://<rqmserver>:<port>/jazz ) `' J0 ]9 ?0 T$ ~# ~( N1 Y( m# G* a" C- @     -user <userid> -password <password> -adapter <adapter> \ ' x- }0 M3 {4 u9 q- @0 \1 h    [-projectArea <project area>] [-sleepTime <sleep time>] \     [-configFile <configuration file>]

• Linux/UNIX 平台启动命令：
  : U' U2 p( \5 d) u" l

$ start.sh -repository https://<rqmserver>:<port>/jazz      -user <userid> -password <password> -adapter <adapter> \ " ~) m* ]9 P* v    [-projectArea <project area>] [-sleepTime <sleep time>] \     [-configFile <configuration file>] # j* d1 Z! ^+ R# U5 A' A$ v; x

+ {' W  B! f9 D6 `5 N每个参数的含义分别如下：
0 o, }  Y/ c7 h; c/ brqmserver：Rational Quality Manager 服务器 IP 地址或主机名，必须提供该参数。
port：Rational Quality Manager 服务器端口，必须提供该参数。
userid：Rational Quality Manager 服务器上的注册用户，该用户必须具备运行适配器的许可，必须提供该参数。
password：Rational Quality Manager 服务器的用户的密码，必须提供该参数。
adapter：适配器名称，由用户自己定义，必须提供该参数。
project area：Rational Quality Manager 服务器上的工程，如不指明的话，默认为“Quality Manager”，用户亦可输入己存在的工程名称。
, V, |6 r1 m6 g) U6 lsleep time：任务间隔时间，默认为 30 秒，可不用输入。
log file：输出日志文件，默认为 CommandLineAdapter.log，可不用输入。
configuration file：存储适配器配置信息文件，默认为 Config.ini，可不用输入。

• 命令行适配器启动后如图 1。
  

! M  e, z% |9 a( L" d8 m图 1. 启动命令行适配器

$ a2 s0 K9 Z. N) A当成功建立连接后，屏幕上会出现语句 Created Command Line Adapter。有时会出现出错信息 Attempting relogin for AdapterId:<adapter name>；ResponseCode: 302 appears，这是一个已知的缺陷，可以简略，并不会影响使用。
* U- m) @! w4 H. n6 I) q

• 确认连接成功
  

可以登录到 Rational Quality Manager 检查连接状态，通过点击“Execution”图标，之后点击“Adapter Console”，如图 2 所示：

图 2. 检查连接状态
! x1 i+ j2 Z! N" ^0 B# E
图 2 中 Health 为绿色圆圈表示连接成功。至此，已经完成了命令行与 RQM 的集成了，为了测试这一点，我们可以导入一个测试用例去执行一下。

---

6 C, ]- {, g7 x

将 shell 脚本导入到 RQM 中
7 _5 w4 L! H: M! K, K$ O  d我们创建了一下示例脚本，它主要用来执行 IBM DB2 Content Manager 产品的 API 测试。
IBM DB2 Content Manager 是一种具有工业强度的内容管理系统，用于捕获、处理和存储从纸质转化而来的大量信息，也可用于丰富媒介管理。IBM DB2 Content Manager 已经成为一种具有高度伸缩性的资料库，基本上能用于所有类型的数字内容，包括基于 HTML 和 XML 的 Web 内容、文档图片、电子办公文档和多媒体，如数字视频和音频。该脚本对 IBM DB2 Content Manager Enterprise 进行数据建模，并对各种类型的信息进行批量的增、删、改、查操作。其中 postupgrade.tst 是 java 测试案例的集合，postupgrade.rpt 是测试的输出结果。该脚本集成并管理 IBM DB2 Content Manager 的 API 测试。

清单 1. 创建一个名为 RQMCommandLineAdpaterTest 的脚本文件
7 V0 L6 G: p+ y! A! @3 I# X* d

Echo "Test RQM Command Line Adapter" Cd C:\apiTest 5 h# E! L# X1 }Call %IBMCMROOT%\bin\cmbenv81.bat java TQueryTestBucketICM -testFile postupgrade.tst -reportFile postupgrade.rpt 2 c4 v' I# R2 a2 e' ], M( i0 a

0 O9 Q! F9 o3 M6 U/ w鼠标指向 Construction 图标，点击 Import Test Script 如图 3 所示。

" x. v* f" F: W  }' F9 _图 3. 在 Rational Quality Manager 中选择“Import Test Script”

这样就打开了 Import Test Script 图 4 所示的标签页。在此页面，在 Script Type 下拉列表中选择 Command Line，并且在 "Use test resources that are local to a test machine" 中，点击 Select Adapter 按钮。
) q' |& D3 n7 `' I( t
图 4. 选择 script type 和 adapter 来导入测试脚本


打开 Import Test Script 对话框之后，如图 5 所示。输入脚本所在路径，点击 Next 便可以看到此路径下所有的脚本。点击需求被导入的脚本，之后点击 Finish。

; u% O- }, B" o0 Q5 h图 5. 选择被导入的脚本
2 M; ~9 j( A, H3 b
当返回到脚本导入页面后，将看到 Selected Adapter 已经被填充，如图 6 所示。之后勾选所有需要被导入的脚本后，点击 Import。

5 O8 m+ D7 t  P, _图 6. 确认需要被导入的脚本

脚本导入完成后，All Test Scripts 标签页会被自动打开，如图 7 所示。可以看到，我们创建的 RQMCommandLineAdpaterTest.bat 文件被成功导入了。

图 7. 确认脚本被显示在 View Test Scripts 页面中

脚本导入后，可以将其与某个测试用例关联起来以便执行。
! X* E7 S& w7 `2 ~0 J" {+ N

---

( J& H- q3 X/ }6 S3 [0 G6 \

& a+ b" a! d# q+ N( Z; S% D将导入的 shell 脚本与 test case 关联
  q* b  V) O5 J; t6 q. I: X在 Rational Quality Manager 中，有多种方式执行其它测试工具创建的测试脚本。首先，需要将刚刚导入的测试脚本与某个测试用例关联起来：
+ V$ w  J+ Z+ N
9 M! h' V+ B* p8 O图 8. 在 Rational Quality Manager 创建测试用例
7 J& G. I) j- A9 s- _. V4 J8 k
: s9 a# O) U. H% _1 M* [+ d$ G打后 Create Test Case 标签页后，输入测用例的标题。点击 Test Scripts 段，在 Test Scripts 段中，点击 Add Existing Test Script 按钮并选择之前导入的测试脚本，如图 9：

! r* G, W, Z% B* H; @( G% m. x图 9. 在 Rational Quality Manager 中将脚本与测试用例关联起来
1 \) N: u8 d) }& d- \
# P9 K1 {& ?' j7 s# K: r; n  Q

---

7 H) d1 f8 c1 b) ?2 p- A: ~
通过 RQM 执行远程的 shell 脚本
点击 Save 之后，Run Test Case 按钮被激活。点击 Run Test Case，在 Run Test Case 对话框中，点击 OK 打开 Script Execution 标签页如图 10 所示。脚本成功执行后，点击 Close and show results 按钮。

9 ?3 s  \) |! d$ N! E3 I图 10. 在 Rational Quality Manager 执行 Shell 脚本或命令行脚本
4 K' I1 L3 {/ b% x
至此，shell 脚本 / 命令行脚本就被集成到 Rational Quality Manager 中了。执行完成后，显示该脚本运行结果如图 11 所示。

# d% B5 N( j8 Y8 ~图 11. 在 Rational Quality Manager 执行 Shell 脚本或命令行脚本测试结果

最后依据执行记录数量生成报表，此报告详细的列出了脚本的执行结果，如 Passed、Failed 等，Execution Status using TER Count 报告的实例如图 12 所示。
4 L8 S8 @) k% X' ^; ?
6 W, @9 K! L  B, e! O; S% g, w2 X; k6 |图 12. 依据执行记录数量的状态报告
) N) z% }; ]! F/ U" |; M+ p5 ?8 o* z

---

3 z/ T5 z% l1 [9 W' K

结束语
7 `8 {- G9 K, x/ X+ t/ c本文向您介绍了在 Rational Quality Manager 如何与 Shell 脚本及命令行脚本进行集成，来达到有效的管理测试脚本的目标，让测试管理者和测试人员能轻松和灵活将脚本管理和应用集成到 Rational Quality Manager 中，达到高效的测试目标。
9 s; I0 \: Z) M) @7 y, T

技术狂人

原文地址：http://www.ibm.com/developerwork ... egration/index.html