全部產品
Search
文件中心

Alibaba Cloud DevOps:GetTestcaseFieldConfig - 擷取測試案例欄位配置

更新時間:Jul 07, 2026

服務存取點與授權資訊

產品

資源

要求的權限

測試管理

測試案例欄位配置

唯讀

請求文法

Region版

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

要求標頭

參數

類型

是否必填

描述

樣本值

x-yunxiao-token

string

個人存取權杖。

pt-0fh3****0fbG_35af****0484

請求參數

參數

類型

位置

是否必填

描述

樣本值

id

string

path

用例庫唯一標識。

請求樣本

Region版

curl -X 'GET' \
  'https://{domain}/oapi/v1/testhub/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 相關錯誤碼。