创建 TAPD bug
tapd_create_bugCreate a confirmed bug in TAPD, optionally link it to a requirement, and set assignee, priority, severity, module, iteration, custom fields, and more.
Instructions
在 TAPD 中创建一个已确认的新 bug,可选关联到指定需求,支持设置处理人、优先级、严重程度、模块、版本、迭代、排期、各类人员(测试/开发/参与人等)、工时、模板、自定义字段等。创建前建议先用 tapd_search_users 确认处理人的 nick;不传处理人则默认指派给当前登录用户。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | 可选,抄送人。与处理人同为 TAPD 用户 nick,参考 current_owner 格式,多个以分号分隔(如 a;b;) | |
| de | No | 可选,开发人员 TAPD nick | |
| os | No | 可选,操作系统 | |
| te | No | 可选,测试人员 TAPD nick | |
| due | No | 可选,预计结束日期(YYYY-MM-DD) | |
| size | No | 可选,规模 | |
| begin | No | 可选,预计开始日期(YYYY-MM-DD) | |
| fixer | No | 可选,修复人 TAPD nick | |
| label | No | 可选,标签,不存在时自动创建,多个以英文竖线(|)分隔 | |
| title | Yes | 缺陷标题 | |
| closer | No | 可选,关闭人 TAPD nick | |
| effort | No | 可选,预估工时 | |
| module | No | 可选,所属模块 | |
| source | No | 可选,缺陷根源 | |
| auditer | No | 可选,审核人 TAPD nick | |
| bugtype | No | 可选,缺陷类型 | |
| feature | No | 可选,特性 | |
| deadline | No | 可选,解决期限(YYYY-MM-DD) | |
| estimate | No | 可选,预计解决时间 | |
| platform | No | 可选,软件平台 | |
| severity | No | 可选,严重程度,需使用当前项目支持的 TAPD 严重程度值 | |
| story_id | No | 可选,需求 ID;传入后会在缺陷创建成功后关联到该需求 | |
| testmode | No | 可选,测试方式 | |
| testtype | No | 可选,测试类型 | |
| confirmed | Yes | 必须为 true,表示用户已明确确认创建该 TAPD bug | |
| confirmer | No | 可选,验证人 TAPD nick | |
| frequency | No | 可选,重现规律 | |
| testphase | No | 可选,测试阶段 | |
| release_id | No | 可选,发布计划 ID | |
| resolution | No | 可选,解决方法 | |
| description | Yes | 缺陷详细描述,支持 TAPD 富文本 HTML | |
| originphase | No | 可选,发现阶段 | |
| sourcephase | No | 可选,引入阶段 | |
| template_id | No | 可选,模板 ID。从缺陷模板创建时使用 | |
| version_fix | No | 可选,合入版本 | |
| iteration_id | No | 可选,迭代 ID | |
| participator | No | 可选,参与人。与处理人同为 TAPD 用户 nick,多个以分号分隔(如 a;b;) | |
| version_test | No | 可选,验证版本 | |
| workspace_id | Yes | TAPD 项目 ID(必填)。可先用 tapd_list_bugs / tapd_list_stories 跨项目查询,或 tapd_list_workspaces 获取目标项目 ID | |
| baseline_find | No | 可选,发现基线 | |
| baseline_join | No | 可选,合入基线 | |
| baseline_test | No | 可选,验证基线 | |
| custom_fields | No | 可选,自定义字段透传。key 为 TAPD 字段名(custom_field_*、cus_* 或 custom_plan_field_*),原样提交;具体字段名通过 TAPD 自定义字段配置接口获取 | |
| version_close | No | 可选,关闭版本 | |
| baseline_close | No | 可选,关闭基线 | |
| current_owners | No | 可选,缺陷处理人 TAPD nick 列表;建议先调用 tapd_search_users 确认 | |
| priority_label | No | 可选,优先级标识,推荐使用此字段以兼容自定义优先级(如 High/Medium/Low) | |
| version_report | No | 可选,发现版本 | |
| is_apply_template_default_value | No | 可选,是否从模板继承默认值(仅 0/1,1 继承),需配合 template_id |