共用方式為


Fields - Get

取得特定欄位的相關資訊。

GET https://dev.azure.com/{organization}/{project}/_apis/wit/fields/{fieldNameOrRefName}?api-version=7.1-preview.3

URI 參數

名稱 位於 必要 類型 Description
fieldNameOrRefName
path True

string

功能變數名稱簡單名稱或參考名稱

organization
path True

string

Azure DevOps 組織的名稱。

project
path

string

專案識別碼或專案名稱

api-version
query True

string

要使用的 API 版本。 這應該設定為 '7.1-preview.3',以使用此版本的 API。

回應

名稱 類型 Description
200 OK

WorkItemField2

成功的作業

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

名稱 Description
vso.work 授與讀取工作專案、查詢、面板、區域和反復專案路徑,以及其他工作專案追蹤相關中繼資料的能力。 也授與執行查詢、搜尋工作專案,以及透過服務勾點接收工作專案事件通知的能力。

範例

Gets information on a specific field

Sample Request

GET https://dev.azure.com/fabrikam/_apis/wit/fields/{fieldNameOrRefName}?api-version=7.1-preview.3

Sample Response

{
  "name": "Iteration Path",
  "referenceName": "System.IterationPath",
  "type": "treePath",
  "readOnly": true,
  "supportedOperations": [
    {
      "referenceName": "SupportedOperations.Under",
      "name": "Under"
    },
    {
      "referenceName": "SupportedOperations.NotUnder",
      "name": "Not Under"
    },
    {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    },
    {
      "referenceName": "SupportedOperations.NotEquals",
      "name": "<>"
    },
    {
      "referenceName": "SupportedOperations.In",
      "name": "In"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath"
}

定義

名稱 Description
FieldType

欄位的型別。

FieldUsage

欄位的使用方式。

ReferenceLinks

表示 REST 參考連結集合的類別。

WorkItemField2

描述工作專案上的欄位,以及該工作專案類型特有的屬性。

WorkItemFieldOperation

描述工作專案欄位作業。

FieldType

欄位的型別。

名稱 類型 Description
boolean

string

布林值欄位類型。

dateTime

string

Datetime 欄位類型。

double

string

雙精度浮點數欄位類型。

guid

string

Guid 欄位類型。

history

string

歷程記錄欄位類型。

html

string

HTML (多行) 欄位類型。

identity

string

身分識別欄位類型。

integer

string

整數位段類型。

picklistDouble

string

雙重挑選清單欄位類型。 從 REST API 建立雙選清單欄位時,請使用 「Double」 FieldType。

picklistInteger

string

整數挑選清單欄位類型。 從 REST API 建立整數挑選清單欄位時,請使用 「Integer」 FieldType。

picklistString

string

字串挑選清單欄位類型。 從 REST API 建立字串挑選清單欄位時,請使用 「String」 FieldType。

plainText

string

純文字欄位類型。

string

string

字串欄位類型。

treePath

string

樹狀結構路徑欄位類型。

FieldUsage

欄位的使用方式。

名稱 類型 Description
none

string

空的使用方式。

tree

string

樹狀節點欄位使用方式。

workItem

string

工作專案欄位使用方式。

workItemLink

string

工作專案連結欄位使用方式。

workItemTypeExtension

string

工作專案類型延伸模組使用方式。

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的唯讀檢視。 因為參考連結是唯讀的,所以我們只想要將它們公開為唯讀。

WorkItemField2

描述工作專案上的欄位,以及該工作專案類型特有的屬性。

名稱 類型 Description
_links

ReferenceLinks

連結相關 REST 資源的參考。

canSortBy

boolean

指出欄位是否可在伺服器查詢中排序。

description

string

欄位的描述。

isDeleted

boolean

指出是否刪除此欄位。

isIdentity

boolean

指出此欄位是否為識別欄位。

isLocked

boolean

指出此欄位是否標示為鎖定以進行編輯。

isPicklist

boolean

指出這個實例是否為 picklist。

isPicklistSuggested

boolean

指出這個實例是否為建議的挑選清單。

isQueryable

boolean

指出是否可以在伺服器中查詢欄位。

name

string

欄位的名稱。

picklistId

string

如果此欄位是 picklist,則為相關聯的挑選清單識別碼,否則為 null

readOnly

boolean

指出欄位是否為 [唯讀]。

referenceName

string

欄位的參考名稱。

supportedOperations

WorkItemFieldOperation[]

此欄位支援的作業。

type

FieldType

欄位的型別。

url

string

usage

FieldUsage

欄位的使用方式。

WorkItemFieldOperation

描述工作專案欄位作業。

名稱 類型 Description
name

string

作業的易記名稱。

referenceName

string

作業的參考名稱。