Python 禪道測試用例助手

授客發表於2024-10-13
Python

程式及原始碼下載地址：

https://gitee.com/ishouke/zen-tao-testcase-helper

實現功能

禪道測試用例助手。

實現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

[ZENTAO]
# 要連線的資料庫伺服器主機地址
host = 192.168.88.129

# 資料庫使用的TCP埠，預設 3306
port = 3306

# 資料庫登陸名
user = testacc

# 資料庫登陸密碼
password = test1234

# 要使用的資料庫名，無預設值
db_name = zentao

# 指定客戶端字符集編碼，要跟資料庫的編碼一樣
charset = utf8

根據實際需求，修改conf/application.conf

[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檔案未修改，則不會執行當前檔案的匯入操作

相關文章