testlink自带java api_testlink的api

testlink可以做很多你想象得到的事情，如API测试参数管理，Excel导入导出，快速模板创建测试用例，集成Jenkins。

TestLink API第三方库: TestLink-API-Python-client 0.8.0

example

获取私人key

点击进入用户的页面，点击生成key按钮，生成成功后会通过邮件发送到该用户邮箱。

需要配置testlink配置中的SMTP，否则会报错：LOCALIZE: apikey_cannot_be_reseted_invalid_smtp_hostname。

http://[YOURSERVER]/testlink/lib/api/xmlrpc/v1/xmlrpc.php

如果搭建的未修改为testlink而是原始文件夹testlink-1.9.15,这里链接中的testlink要修改为testlink-1.9.15。

获取TestlinkAPIClient对象实例

url = "http://11.12.13.16/testlink/lib/api/xmlrpc/v1/xmlrpc.php"

key = "9f5ec9cd058457usdko2191188"

tlc = testlink.TestlinkAPIClient(url, key)

获取基础信息

print(tlc.countProjects())

projects = tlc.getProjects()

for project in projects:

print(project)

操作测试用例集

创建用例集

无测试用例集

新建项目，未创建测试集，此时获取first level的测试集为空。

使用创建测试用例集函数createTestSuite时，最后一个参数parentid此时可以不用传输。

有测试用例集

如果是创建在项目的根上，最后一个参数parentid此时可以不用传输。

如果是创建在已有的测试用例集下面，最后一个参数parentid此时要传输为目标用例集的ID。

创建名称相同的用例集

如创建已经存在相同名称的用例集，不会报错，返回0。

创建不重复的用例集，成功后，返回结果如下：

[{‘id‘: 68219, ‘name‘: ‘‘, ‘name_changed‘: False, ‘status‘: True,

‘operation‘: ‘createTestSuite‘, ‘additionalInfo‘: ‘‘, ‘message‘: ‘ok‘}]

获取用例集

获取顶级用例集

getFirstLevelTestSuitesForTestProject(project_id)

处于顶级用例集下的用例集不会被返回，只返回(一级)标红的用例集。

获取指定用例集下的用例集

用例集下只有一个用例集

用例集1

用例集2

使用tlc.getTestSuitesForTestSuite(testsuite_id)返回的数据结构如下，开头不会多一个key：

{‘id‘: ‘68596‘, ‘details‘: ‘‘, ‘name‘: ‘用例集2‘, ‘node_type_id‘: ‘2‘, ‘node_order‘: ‘1‘, ‘parent_id‘: ‘68576‘}

用例集下有多个用例集

用例集1

用例集2

用例集3

使用tlc.getTestSuitesForTestSuite(testsuite_id)返回的数据结构如下, 前面会多一个id的key：

{‘68596‘:

{‘id‘: ‘68596‘, ‘details‘: ‘‘, ‘name‘: ‘用例集2‘, ‘node_type_id‘: ‘2‘, ‘node_order‘: ‘1‘, ‘parent_id‘: ‘68576‘},

‘68673‘:

{‘id‘: ‘68673‘, ‘details‘: ‘‘, ‘name‘: ‘用例集3‘, ‘node_type_id‘: ‘2‘, ‘node_order‘: ‘2‘, ‘parent_id‘: ‘68576‘}}

试了下有3个子集的，情况和2个子集相同：

用例集1

用例集2

用例集3

用例集4

{‘68596‘:

{‘id‘: ‘68596‘, ‘details‘: ‘‘, ‘name‘: ‘用例集2‘, ‘node_type_id‘: ‘2‘, ‘node_order‘: ‘1‘, ‘parent_id‘: ‘68576‘},

‘68673‘:

{‘id‘: ‘68673‘, ‘details‘: ‘‘, ‘name‘: ‘用例集3‘, ‘node_type_id‘: ‘2‘, ‘node_order‘: ‘2‘, ‘parent_id‘: ‘68576‘},

‘68674‘:

{‘id‘: ‘68674‘, ‘details‘: ‘‘, ‘name‘: ‘用例集4‘, ‘node_type_id‘: ‘2‘, ‘node_order‘: ‘3‘, ‘parent_id‘: ‘68576‘}}

针对以上不同格式做不同处理。

操作测试用例

获取测试用例

def get_test_case(test_case_id):

test_case = tlc.getTestCase(None, testcaseexternalid=test_case_id)

for i in test_case:

print ("序列", "执行步骤", "预期结果")

for m in i.get("steps"):

print (m.get("step_number"), m.get("actions"), m.get("expected_results"))

get_test_case("auto-10") #要加上项目前缀

注意：这里的用例ID要加上项目前缀，否则获取不到

创建测试用例

源代码如下

def createTestCase(self, *argsPositional, **argsOptional):

参数

positional argument位置参数:

testcasename :测试用例名称

testsuiteid :创建在某个测试集，该测试集的ID

testprojectid :测试项目ID

authorlogin :创建人姓名

summary :用例总结

可选参数：

steps :步骤，为一个list

preconditions :前置条件

importance

executiontype

order

internalid

checkduplicatedname

actiononduplicatedname

status

estimatedexecduration

创建成功返回值

[

{‘operation‘: ‘createTestCase‘,

‘status‘: True,

‘id‘: 71278,

‘additionalInfo‘:

{‘id‘: 71278,

‘external_id‘: ‘119‘,

‘status_ok‘: 1,

‘msg‘: ‘ok‘,

‘new_name‘: ‘‘,

‘version_number‘: 1,

‘has_duplicate‘: False,

‘external_id_already_exists‘: False,

‘update_name‘: False,

‘tcversion_id‘: 71279},

‘message‘: ‘Success!‘}

]

external_id: 用例的ID

步骤预先定义

方法1 使用list

必须是定义好的由字典组成的列表

steps =

[{‘step_number‘ : 1, ‘actions‘ : "action A" ,

‘expected_results‘ : "result A", ‘execution_type‘ : 0},

{‘step_number‘ : 2, ‘actions‘ : "action B" ,

‘expected_results‘ : "result B", ‘execution_type‘ : 1},

{‘step_number‘ : 3, ‘actions‘ : "action C" ,

‘expected_results‘ : "result C", ‘execution_type‘ : 0}]

newTestCase = self.tlc.createTestCase(........steps=steps)

方法2 使用initStep

该方法无需传递steps参数，已经预存在了tlc对象中

tlc.initStep("添加一个动作", "期望一个结果", 1)

tlc.appendStep("添加一个动作2", "期望一个结果2", 1)

tlc.appendStep("添加一个动作3", "期望一个结果3", 1)

newTestCase = self.tlc.createTestCase(.......)

获取关键字

tlc.listKeywordsForTC(testcase_id)

自定义字段

自定义关键则的操作方法，在编辑器中输入custom后，搜出的关键字有如下

第一个猜测是需求关键字。 get开头的获取关键字。 update开头的是更新关键字。

注意: testcaseexternalid一定要写全"au-117",-符号不能少。

获取用例自定义字段值

getTestCaseCustomFieldDesignValue(

testcaseexternalid="au-117",

testprojectid="68194",

customfieldname=‘版本号‘,

version=1

)

这里的version没找到是指哪里，填写1就可以了。

更新用例自定义字段值

tlc.updateTestCaseCustomFieldDesignValue(

testcaseexternalid="au-117",

testprojectid="68194",

version=1,

customfields={"版本号": "6.6"}

)