Fields - Get

Referensi

Service:: Work Item Tracking

API Version:: 7.1-preview.3

Mendapatkan informasi tentang bidang tertentu.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
fieldNameOrRefName	path	True	string	Nama sederhana bidang atau nama referensi
organization	path	True	string	Nama organisasi Azure DevOps.
project	path		string	ID proyek atau nama proyek
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.3' untuk menggunakan versi api ini.

Respons

Nama	Jenis	Deskripsi
200 OK	WorkItemField2	operasi berhasil

Keamanan

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

Nama	Deskripsi
vso.work	Memberikan kemampuan untuk membaca item kerja, kueri, papan, jalur perulangan dan area, serta metadata terkait pelacakan item kerja lainnya. Juga memberikan kemampuan untuk menjalankan kueri, mencari item kerja, dan menerima pemberitahuan tentang peristiwa item kerja melalui kait layanan.

Contoh

Gets information on a specific field

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "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"
}

Definisi

Nama	Deskripsi
FieldType	Jenis bidang .
FieldUsage	Penggunaan bidang .
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.
WorkItemField2	Menjelaskan bidang pada item kerja dan properti khusus untuk jenis item kerja tersebut.
WorkItemFieldOperation	Menjelaskan operasi bidang item kerja.

FieldType

Jenis bidang .

Nama	Jenis	Deskripsi
boolean	string	Jenis bidang Boolean.
dateTime	string	Jenis bidang tanggalwaktu.
double	string	Jenis bidang ganda.
guid	string	Jenis bidang guid.
history	string	Jenis bidang riwayat.
html	string	Jenis bidang HTML (Multibaris).
identity	string	Jenis bidang identitas.
integer	string	Jenis bidang bilangan bulat.
picklistDouble	string	Jenis bidang daftar pilihan ganda. Saat membuat bidang daftar pilihan ganda dari REST API, gunakan FieldType "Ganda".
picklistInteger	string	Jenis bidang daftar pilih bilangan bulat. Saat membuat bidang daftar pilih bilangan bulat dari REST API, gunakan FieldType "Bilangan Bulat".
picklistString	string	Jenis bidang daftar pilih string. Saat membuat bidang daftar pilih string dari REST API, gunakan FieldType "String".
plainText	string	Jenis bidang teks biasa.
string	string	Jenis bidang string.
treePath	string	Jenis bidang treepath.

FieldUsage

Penggunaan bidang .

Nama	Jenis	Deskripsi
none	string	Penggunaan kosong.
tree	string	Penggunaan bidang treenode.
workItem	string	Penggunaan bidang item kerja.
workItemLink	string	Penggunaan bidang tautan item kerja.
workItemTypeExtension	string	Penggunaan Ekstensi Jenis Item Kerja.

ReferenceLinks

Kelas untuk mewakili kumpulan tautan referensi REST.

Nama	Jenis	Deskripsi
links	object	Tampilan baca-saja dari tautan. Karena tautan Referensi dibaca saja, kami hanya ingin mengeksposnya sebagai baca-saja.

WorkItemField2

Menjelaskan bidang pada item kerja dan properti khusus untuk jenis item kerja tersebut.

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Menautkan referensi ke sumber daya REST terkait.
canSortBy	boolean	Menunjukkan apakah bidang dapat diurutkan dalam kueri server.
description	string	Deskripsi bidang .
isDeleted	boolean	Menunjukkan apakah bidang ini dihapus.
isIdentity	boolean	Menunjukkan apakah bidang ini adalah bidang identitas.
isLocked	boolean	Menunjukkan apakah bidang ini ditandai sebagai terkunci untuk pengeditan.
isPicklist	boolean	Menunjukkan apakah instans ini adalah daftar pilihan.
isPicklistSuggested	boolean	Menunjukkan apakah instans ini adalah daftar pilihan yang disarankan.
isQueryable	boolean	Menunjukkan apakah bidang dapat dikueri di server.
name	string	Nama bidang.
picklistId	string	Jika bidang ini adalah daftar pilihan, pengidentifikasi daftar pilihan yang terkait, jika tidak, null
readOnly	boolean	Menunjukkan apakah bidang tersebut [baca saja].
referenceName	string	Nama referensi bidang.
supportedOperations	WorkItemFieldOperation[]	Operasi yang didukung pada bidang ini.
type	FieldType	Jenis bidang .
url	string
usage	FieldUsage	Penggunaan bidang .

WorkItemFieldOperation

Menjelaskan operasi bidang item kerja.

Nama	Jenis	Deskripsi
name	string	Nama operasi yang mudah diingat.
referenceName	string	Nama referensi operasi.

Bagikan melalui