【最佳实践】MeterSphere 服务集成之 TAPD 对接


Administrator
飞致云 发布于 2023-01-11 / 1297 阅读 / 0 评论 /
作为一款一站式开源持续测试平台,MeterSphere 可以集成多种测试管理平台,包括 TAPD、Jira、禅道和 Azure DevOps。这里,笔者就跟大家介绍如何集成 TAPD 平台,以及集成后如何将缺陷自动推送到TAPD平台。1 TAPD 服务集成首先进入MeterSphere界面,在【系统

作为一款一站式开源持续测试平台,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 “我的设置”中)。
个人信息-1673419763675

4 配置缺陷模版

4.1 创建缺陷模版

如果是第一次集成 TAPD 服务,需要创建 TAPD 缺陷模版,创建步骤如下图:
缺陷模板-1673419792087

在新的模版中设置模版名称、缺陷平台(此处选择 TAPD),并设置模版内容。模版包括缺陷标题、缺陷内容、缺陷字段。用户可以在缺陷标题和缺陷内容中预先定义格式,比如标题前缀、内容标题(包含测试环境、前置条件、测试步骤等)。
缺陷模板_1

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 平台中了



是否对你有帮助?