作为一款一站式开源持续测试平台,MeterSphere 可以集成多种测试管理平台,包括 TAPD、Jira、禅道和 Azure DevOps。这里,笔者就跟大家介绍如何集成 TAPD 平台,以及集成后如何将缺陷自动推送到TAPD平台。
1 TAPD 服务集成
首先进入MeterSphere界面,在【系统设置-组织-服务集成】页面中选择 TAPD,并填写 TAPD Basic Auth的账号信息,包括 API 账号和 API 口令。编辑完成后测试连接是否有效。如下图:
2 关联项目
为保证 TAPD 项目和 MeterSphere 项目的一致性,需要将这两个平台中的项目关联起来。项目 ID 可在进入 TAPD 项目后的 URL 中获取,如下图所示:
3 关联个人信息
将 MeterSphere 用户和 TAPD 用户做关联后,在 MeterSphere中 提交缺陷,TAPD 上对应的处理人即为在 MeterSphere 中填写的账户名。
关联方法如下图所示,在 MeterSphere 的个人信息中的 TAPD 昵称处填写 TAPD 对应的昵称(查看位置在 TAPD “我的设置”中)。
4 配置缺陷模版
4.1 创建缺陷模版
如果是第一次集成 TAPD 服务,需要创建 TAPD 缺陷模版,创建步骤如下图:
在新的模版中设置模版名称、缺陷平台(此处选择 TAPD),并设置模版内容。模版包括缺陷标题、缺陷内容、缺陷字段。用户可以在缺陷标题和缺陷内容中预先定义格式,比如标题前缀、内容标题(包含测试环境、前置条件、测试步骤等)。
4.2 自定义字段
如果 MeterSphere 中默认的TAPD缺陷模版不能满足当下需求,我们还可以选择创建自定义字段。下图展示的信息中,发现阶段、缺陷类型、发现版本、项目名称等均为自定义缺陷字段。
下面介绍具体的创建方法。点击“创建字段”按钮后,会出现下图所示界面。
■ 字段名:和 TAPD 平台保持一致,如 TAPD 中字段名称为“优先级”,此处就填“优先级”;
■ 使用场景:选择“缺陷模版”选项;
■ 字段类型:目前 MeterSphere 中支持多种字段类型,如“输入框”、“文本框”等。缺陷字段中使用最多的类型为“单选下拉列表”类型,所以这里就以这个类型为例,介绍如何在 MeterSphere 中创建自定义缺陷字段;
■ 单选下拉列表:单选下拉列表需要设置选项值,其中包括选项内容和选项ID。选项内容就是我们在页面中看到的选项显示内容,选项ID为TAPD添加缺陷接口该字段接收的值(可通过点击 F12 快捷键查看字段对应的选项 ID,如紧急选项对应的选项 ID 是 urgent)。
添加完所有选项后,点击“确定”按钮,一个自定义字段就创建完成了,其他所有的自定义字段均可按照这个方法完成。
缺陷优先级(Priority)字段说明:
取值 | 字面值 |
urgent | 紧急 |
high | 高 |
medium | 中 |
low | 低 |
insignificant | 无关紧要 |
缺陷严重程度(Severity)字段说明:
取值 | 字面值 |
fatal | 致命 |
serious | 严重 |
normal | 一般 |
prompt | 提示 |
advice | 建议 |
4.3 配置缺陷模版
创建好自定义字段后,需要将字段应用到缺陷模板中。点击“添加字段”,可以在界面选择需要的字段添加到模板中。
添加好字段之后,需要将字段与TAPD添加缺陷接口中的API字段名做对应关系设置,才能将设置的字段作为缺陷的要素推送到TAPD。
TAPD 自定义字段的字段名可以通过接口获取,也可以通过抓包的方式在创建缺陷时获取,自定义字段的字段名形式一般为:custom_field_one、custom_field_two等。
接口的链接为:https://www.tapd.cn/help/view#1120003271001001455
TAPD 添加缺陷的 API 请求参数如下,如果在 TAPD 中定义了自定义字段,也要将自定义字段也传入。
字段名 | 必选 | 类型及范围 | 说明 |
title | 是 | string | 标题 |
priority | 否 | string | 优先级 |
severity | 否 | string | 严重程度 |
module | 否 | string | 模块 |
release_id | 否 | integer | 发布计划 |
version_report | 否 | string | 发现版本 |
version_test | 否 | string | 验证版本 |
version_fix | 否 | string | 合入版本 |
version_close | 否 | string | 关闭版本 |
baseline_find | 否 | string | 发现基线 |
baseline_join | 否 | string | 合入基线 |
baseline_test | 否 | string | 验证基线 |
baseline_close | 否 | string | 关闭基线 |
current_owner | 否 | string | 处理人 |
cc | 否 | string | 抄送人 |
reporter | 否 | string | 创建人 |
participator | 否 | string | 参与人 |
te | 否 | string | 测试人员 |
de | 否 | string | 开发人员 |
auditer | 否 | string | 审核人 |
confirmer | 否 | string | 验证人 |
fixer | 否 | string | 修复人 |
closer | 否 | string | 关闭人 |
lastmodify | 否 | string | 最后修改人 |
in_progress_time | 否 | datetime | 接受处理时间 |
resolved | 否 | datetime | 解决时间 |
verify_time | 否 | datetime | 验证时间 |
closed | 否 | datetime | 关闭时间 |
reject_time | 否 | datetime | 无关紧要 |
begin | 否 | date | 预计开始 |
due | 否 | date | 预计结束 |
deadline | 否 | date | 解决期限 |
os | 否 | string | 操作系统 |
platform | 否 | string | 软件平台 |
testmode | 否 | string | 测试方式 |
testphase | 否 | string | 测试阶段 |
testtype | 否 | string | 测试类型 |
source | 否 | string | 缺陷根源 |
bugtype | 否 | string | 缺陷类型 |
frequency | 否 | string | 重现规律 |
originphase | 否 | string | 发现阶段 |
sourcephase | 否 | string | 引入阶段 |
resolution | 否 | string | 解决方法 |
estimate | 否 | integer | 预计解决时间 |
description | 否 | string | 详细描述 |
workspace_id | 否 | integer | 项目ID |
custom_field_ | 否 | string或者integer | 自定义字段参数,具体字段名通过接口获取 |
4.4 关联模版
创建好缺陷模版后,还需要在项目中进行关联才能使用。选择“项目”→“项目管理”→“编辑项目”,在“缺陷模版”选项中选择新创建或修改的TAPD 缺陷模版。
4.5 提交缺陷
至此,缺陷模版设置完毕。在 MeterSphere 的测试跟踪中创建一个缺陷,即能同步到 TAPD 平台中了