文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务用例管理/ 更新用户自定义列展示及顺序配置 - UpdateCustomizedConfig
更新时间:2025-12-27 GMT+08:00
分享

更新用户自定义列展示及顺序配置 - UpdateCustomizedConfig

功能介绍

此接口用于更新页面用户自定义列展示及顺序配置,配置页面展示/不展示用户添加的自定义列,同页面 测试 -> 测试用例 -> 操作 -> 自定义列, 通过勾选选择展示/隐藏自定义列

调用方法

请参见如何调用API

URI

PUT /v4/projects/{project_id}/customized-columns

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

service_type

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

默认取值:

不涉及

stage_type

Integer

阶段过程(2:测试设计,3:测试执行,4:质量报告)

display

Array of ColumnInfo objects

展示的表格列集合

hidden

Array of ColumnInfo objects

隐藏的表格列集合

表3 ColumnInfo

参数

是否必选

参数类型

描述

id

String

表格列ID

name

String

表格列名称

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

display

Array of ColumnVo objects

展示的表格列集合

hidden

Array of ColumnVo objects

隐藏的表格列集合

表5 ColumnVo

参数

参数类型

描述

id

String

表格列ID

name

String

表格列名称

custom_field_param

String

项目用例自定义字段入参或者返回参数名称

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

put https://{endpoint}/v4/projects/a5eb0d410ea341a192f7c12483568985/customized-columns

{
  "display" : [ {
    "id" : "B",
    "name" : "名称"
  }, {
    "id" : "A",
    "name" : "编号"
  }, {
    "id" : "I",
    "name" : "结果"
  }, {
    "id" : "D",
    "name" : "用例等级"
  }, {
    "id" : "S",
    "name" : "执行者"
  }, {
    "id" : "U",
    "name" : "执行方式"
  }, {
    "id" : "Z",
    "name" : "关联测试设计"
  }, {
    "id" : "G",
    "name" : "状态"
  } ],
  "hidden" : [ {
    "id" : "E",
    "name" : "是否来自测试设计"
  }, {
    "id" : "C",
    "name" : "处理者"
  }, {
    "id" : "J",
    "name" : "关联需求"
  }, {
    "id" : "N",
    "name" : "关联缺陷"
  }, {
    "id" : "H",
    "name" : "执行次数"
  }, {
    "id" : "Q",
    "name" : "执行时间"
  }, {
    "id" : "R",
    "name" : "执行时长"
  }, {
    "id" : "F",
    "name" : "迭代"
  }, {
    "id" : "L",
    "name" : "创建时间"
  }, {
    "id" : "O",
    "name" : "模块"
  }, {
    "id" : "K",
    "name" : "创建者"
  }, {
    "id" : "T",
    "name" : "类型"
  }, {
    "id" : "X",
    "name" : "标签"
  }, {
    "id" : "Y",
    "name" : "评审状态"
  }, {
    "id" : "AA",
    "name" : "密级"
  } ],
  "service_type" : -1,
  "stage_type" : 3
}

响应示例

状态码:200

OK

{
  "value" : {
    "display" : [ {
      "id" : "B",
      "name" : "名称"
    }, {
      "id" : "A",
      "name" : "编号"
    }, {
      "id" : "I",
      "name" : "结果"
    }, {
      "id" : "D",
      "name" : "用例等级"
    }, {
      "id" : "S",
      "name" : "执行者"
    }, {
      "id" : "U",
      "name" : "执行方式"
    }, {
      "id" : "N",
      "name" : "关联缺陷"
    }, {
      "id" : "C",
      "name" : "处理者"
    } ],
    "hidden" : [ {
      "id" : "G",
      "name" : "状态"
    }, {
      "id" : "J",
      "name" : "关联需求"
    }, {
      "id" : "H",
      "name" : "执行次数"
    }, {
      "id" : "Q",
      "name" : "执行时间"
    }, {
      "id" : "R",
      "name" : "执行时长"
    }, {
      "id" : "F",
      "name" : "迭代"
    }, {
      "id" : "L",
      "name" : "创建时间"
    }, {
      "id" : "O",
      "name" : "模块"
    }, {
      "id" : "K",
      "name" : "创建者"
    }, {
      "id" : "T",
      "name" : "类型"
    }, {
      "id" : "X",
      "name" : "标签"
    }, {
      "id" : "E",
      "name" : "是否来自测试设计"
    }, {
      "id" : "Y",
      "name" : "评审状态"
    }, {
      "id" : "Z",
      "name" : "关联测试设计"
    } ]
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档