GetTestcaseFieldConfig,获取测试用例字段配置_云效(Apsara Devops)-阿里云帮助中心

通过 OpenAPI 获取测试用例字段配置。

适用版本

标准版

服务接入点与授权信息

获取服务接入点，替换 API 请求语法中的 <domain> ：服务接入点（domain）。
获取个人访问令牌，具体操作，请参见获取个人访问令牌。
获取organizationId，请前往组织管理后台的基本信息页面获取组织 ID 。
产品
资源
所需权限
产品
资源
所需权限
测试管理
测试用例字段配置
只读

请求语法

GET https://{domain}/oapi/v1/testhub/organizations/{organizationId}/testRepos/{id}/testcases/fields

请求头

参数	类型	是否必填	描述	示例值

参数	类型	是否必填	描述	示例值
x-yunxiao-token	string	是	个人访问令牌。	pt-0fh3**0fbG_35af**0484

请求参数

参数	类型	位置	是否必填	描述	示例值

参数	类型	位置	是否必填	描述	示例值
id	string	path	是	用例库唯一标识。
organizationId	string	path	是	organizationId。

请求示例

curl -X 'GET' \
  'https://test.rdc.aliyuncs.com/oapi/v1/testhub/organizations/{organizationId}/testRepos/{id}/testcases/fields' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

返回参数

参数	类型	描述	示例值

参数	类型	描述	示例值
-	array
-	object
cascadingOptions	object
mustSelectLeaf	boolean	是否必须选择叶子节点。	true
optionsList	array	选项列表。	[]
-	object
children	array[string]
defaultValue	string	默认值。	12233
description	string	描述。	描述
format	string	字段格式，目前支持的有 list、multiList、date、dateTime、int、float、string、text、user、multiUser、cascading、file、 tag、sprint、version 分别对应单选、多选、日期、时间、整型、浮点、单行文本、多行文本、用户、多选用户、层级字段、文件、标签、迭代、版本。	list
id	string	字段 id。	field-id-xxx
name	string	名称。	名称
options	array	可选值。
-	object
displayValue	string	可选值值显示值。	111
id	string	字段 id。	field-id-xxx
value	string	可选值值。	111
valueEn	string	可选值值英文。	111
required	boolean	是否必填。	true
showWhenCreate	boolean	创建时是否展示。	true
type	string	字段类型,区分不同的类型，如系统字段：NativeField，用户自定义字段：CustomField。	NativeField

返回示例

[
    {
        "cascadingOptions": {
            "mustSelectLeaf": true,
            "optionsList": []
        },
        "defaultValue": "12233",
        "description": "描述",
        "format": "list",
        "id": "field-id-xxx",
        "name": "名称",
        "options": [
            {
                "displayValue": "111",
                "id": "field-id-xxx",
                "value": "111",
                "valueEn": "111"
            }
        ],
        "required": true,
        "showWhenCreate": true,
        "type": "NativeField"
    }
]

错误码

访问错误码中心查看 API 相关错误码。

产品	资源	所需权限
测试管理	测试用例字段配置	只读