README.md · 授客/ZenTaoTestcaseHelper

# 禅道测试用例助手使用说明

## 实现功能

禅道测试用例助手。

实现xmind用例导入禅道，支持自动创建产品，模块，删除用例，此外，支持禅道导出的excel用例转xmind用例之后，再导入禅道，实现禅道用例管理闭环

## 使用要求

适配xmind版本：xmind 8 update 9（XMind_3.7.9.0）

说明：使用xmind编写的用例要能被程序解析，需要安装以上xmind版本

win10

禅道专业版 3.10.1

禅道开源版 3.10

## 程序目录结构说明

```
├─conf  存放配置文件
├─excel_testcases  存放禅道导出的excel用例文件
├─xmind_testcases  存放使用xmind编写的用例文件
├─results 程序运行输出结果目录(如果改目录不存在，会自动创建)
└─_internal  程序使用的内部文件（无需关注）
```

## 使用说明

### 修改应用程序配置

根据实际需求，修改禅道数据库配置`conf/database.conf`

```properties
[ZENTAO]
# 要连接的数据库服务器主机地址
host = 192.168.88.129

# 数据库使用的TCP端口，默认 3306
port = 3306

# 数据库登陆名
user = testacc

# 数据库登陆密码
password = test1234

# 要使用的数据库名，无默认值
db_name = zentao

# 指定客户端字符集编码，要跟数据库的编码一样
charset = utf8
```

根据实际需求，修改`conf/application.conf`

```properties
[COMMON]
# 操作：可选值如下：
# xmind_to_excel -- 把使用xmind用例按禅道用例导出模板转成excel用例
# xmind_to_zentao -- 把使用xmind用例导入禅道
# excel_to_xmind  -- 把禅道导出的excel用例转xmind用例
operation =  xmind_to_excel

# 转换后的测试用例文件所在目录路径
result_file_dir_path =

[XMIND_TO_EXCEL_OR_ZENTAO]
# xmind用例excel用例，或者导入禅道公共配置
# xmind测试用例文件所在目录路径(xmind转excel用例或者xmind导入禅道时使用)
xmind_testcase_file_dir_path =

# 默认用例适用阶段，可选值如下：
# 单元测试阶段, 单元测试, 功能测试阶段, 功能测试, 集成测试阶段, 集成测试, 系统测试阶段, 系统测试, 冒烟测试阶段, 冒烟测试, 版本验证阶段, 版本验证
# 支持多个，英文或者中文逗号相隔
# 默认值：系统测试阶段
default_applicable_stage = 系统测试阶段

# 默认用例类型，可选值如下：
# 功能测试, 接口测试，性能测试，安装部署，配置测试，安全相关，其它
default_testcase_type = 功能测试

# 用例默认优先级 默认值2
default_testcase_priority = 2

[XMIND_TO_ZENTAO]
# xmind用例导入禅道用例配置
# 用例归属产品名称不存在时是否自动创建产品 可选值：1、0
# 1--表示自动创建； 0--表示不自动创建 默认自动创建
auto_create_product = 1

# 用例归属产品模块不存在时是否自动创建模块 可选值：1、0
# 1--表示自动创建； 0--表示不自动创建 默认自动创建
auto_create_module = 1

[XMIND_TO_EXCEL]
# xmind用例转excel用例配置
# xmind转excel存储方式：可选值 1|2|3  默认为 1:每个xmind画布对应一个excel Sheet, 2: 每个 xmind 画布对应一个excel 3: 整个xmind对应一个excel Sheet
saving_way = 2

# 用例模块适配禅道 默认0
testcase_module_adapt_to_zen = 1

# 添加用例路径去除所属模块的剩余路径到用例名称 默认0, 仅仅testcase_module_adapt_to_zen设置为真值时可用
add_path_to_testcase = 0

# 默认用例状态
default_testcase_status = 正常

[EXCEL_TO_XMIND]
# excel转xmind存储方式：可选值 1|2|3
# 默认为 1: 所有 excel 对应一个xmind，每个画布对应一个excel
# 2: 每个excel对应一个xmind，每个xmind只包含一个画布
# 3: 所有excel对应一个xmind 画布(一般用于相同产品的用例文件合并)
saving_way = 2

# excel测试用例文件所在目录路径(禅道导出的excel测试用例转为xmind用例时使用)
excel_testcase_file_dir_path =

[ZEN_TAO]
# 是否禅道专业版 1--是 0--否，默认为 0
is_version_pro = 0
```

### 将用例文件放到对应目录下

根据实际需求，将用例文件放到对应目录：

- 如果希望把xmind用例按禅道用例导出模板转成excel用例 或者 把xmind用例导入禅道，则将xmind用例文件放入`xmind_testcases`目录

- 如果希望把禅道导出的excel用例转xmind用例，则把excel用例文件放入`excel_testcases`目录

注意：

1. 禅道开源版3.10 导出用例时，不支持直接导出用例为`.xlsx`、`.xls`文件，但可以导出`csv`文件，需要自己手工转换为excel文件
  2. 禅道开源版3.10导出的用例时所属模块仅包含用例直接上级模块，不包含祖先模块（父级模块往上至根路径），转为xmind用例，再导入禅道时，程序暂时不会做任何补偿操作，即excel模块中包含用例模块层级是咋样的，导入后就是咋样的。

### 运行程序

双击`testcase_helper.exe` 或者`cmd`控制台下，输入`testcase_helper.exe`文件绝对、相对路径，回车运行

注意：导入xmind用例到禅道时，如果程序检测到距离上次操作以来当前xmind文件未修改，则不会执行当前文件的导入操作

授客/ZenTaoTestcaseHelper

简介

发行版

贡献者

近期动态

授客/ZenTaoTestcaseHelper .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

授客/ZenTaoTestcaseHelper