TestlinkConvert 工具(java版)用法说明

一、 工具的用途：

Testlink作为用例管理工具，只支持以xml文件导出测试用例；对于测试工作，excel格式的测试用例阅读和编辑起来会更方便。

该工具：

1. 可以将从testlink导出的xml文件转换成excel文件；

2. 也可以将excel文件转换成符合testlink规范的xml文件，以方便测试用例导回到testlink中，进行共享和维护。（支持2003和2007版的excel文件）

 

二、 工具使用的前提条件：

1. 安装jdk，配置相应的jdk环境变量；
2. 将TestlinkConvert.java和TestlinkConvert.bat文件，放在同一目录下；
3. 双击TestlinkConvert.bat启动该工具，启动之后有两个窗口：cmd窗口及jar窗口；

（注意：双击TestlinkConvert.java启动工具，进行文件转换时，可能会报编码错误）

4. 文件转换过程中，不要关闭cmd窗口及jar窗口；
5. 文件转换未完成时，请不要打开或删除待转换的和转换产生的文件，否则文件无法被程序访问，会导致得到的文件丢失数据或程序终止。

三、 工具支持的xml文件和excel文件的规范说明：

关于xml文件：

1.  在testlink中编写测试用例时，请不要直接使用“<”和“>”符号，如需使用请直接写成“小于号”、“大于号”或“尖括号”；（因为<> 是html和xml标签的标识）

2. xml文件经该工具转换后会得到如下两种格式的excel文件：

A．在testlink中，以“导出测试用例”的方式导出xml文件，转换后的格式；

B．在testlink中，以“导出测试套件”的方式导出的xml文件，转换后的格式；

模块和子模块，对应着testlink中用例所属的目录名称；用例的直属目录对应着子模块，用例所属的外层目录为多个时，由“/”连起来，即为模块。

关于excel文件：

1.  使用excel文件编写测试用例，请不要直接使用“<”和“>”符号，如需使用请直接写成“小于号”、“大于号”或“尖括号”；（“<”和“>”会被统一转换成“小于”和“大于”）

2.  测试用例需要放在excel的第一个sheet表中，且用例需要顶行顶列编写，用例与用例之间不要有空行，空文件也是不支持的，所有的列和行都要包含在设置好的边框之内，设置的边框内最好不要包含“不属于用例的空行空列”；

3.  用excel编写测试用例时，用例等级可填写：高、中、低或3、2、1；

4.用例的名称不要过于冗长，否则导入到testlink后，用例名称会被“als”代替，因为testlink对用例名称的长度是有限制的。
5.excel文件的测试用例，需要按照以下模板格式编写，才能成功转换成xml；Excel转换成xml后，以“导入测试套件” 的形式导入（可根据需要，看导入前是否需要手动新建一个目录（或套件））

注意：

1. 以上模板的列名最好不要随意改变，尤其是“预期结果”和“测试序号”这两列的列名是固定的，且列顺序是固定的，请不要改变；

2. 模块和子模块导入到testlink中，便是用例所属的目录（或套件）；

模块和子模块可以同时为空 ----用例在testlink中，不属于任何目录；

模块不为空，子模块为空 ----用例在testlink中，有一层目录；

模块和子模块都不为空，模块为“AA”和子模块为“DD”----用例在testlink中，有AA和DD两层目录；子模块为“DD”，模块为“AA/BB/CC”（多层目录结构）----用例在testlink中，有AA、BB、CC和DD四层目录。

3. 以上两个模板可以做扩展：

a) 在“模块”和“测试名称”前可添加一列“测试序号”（即如果有“测试序号”必须位于第一列）；

b) 在“预期结果”后，可以添加N列（称为扩展列），且列名可自定义，排序也无要求；

c) “测试序号”和“扩展列”信息会被导入到testlink用例的“摘要”中；

d) 如果在扩展列中添加了“用例等级”，该列名必须这样写，才能导入到testlink用例的用例等级属性中，否则会被导入到testlink用例的“摘要”中。

按照上述规范扩展后的用例模板，举例有：

补充说明：

1.将excel转换成xml时，如果文件符合上述各项要求，在转换过程中，仍报NullPointException异常，请新建一个excel空白文件，将写好的用例拷贝到新建的excel空白文件的第一个sheet中，将新建的excel转成xml即可。

（转换失败的原因可能是：在原来的excel中，某些单元格/空行/空列中，被插入了空字符串，使用例和这些含空字符串的行列间出现了空行/空列。）

2.将xml转换成excel后，选中全部用例----》右键----》设置单元格格式----》对齐----》选中自动换行。操作步骤、预期结果等的每个步骤就会换行展示（前提是在testlink中编写的时候，每个步骤换过行）。

• Case 可以按照模块分开多个Sheet编写
• 写完后导入前，仔细检查是否有空格，否则报错（具体方法是调整每行的距离，一眼就可以看出来了）

 

工具以及源码放入FTP/Staffs/annie.wang