Fields - Update

Referensi

Layanan:: Work Item Tracking

Versi API:: 7.1

Memperbarui bidang.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
fieldNameOrRefName	path	True	string	Nama/nama referensi bidang yang akan diperbarui
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' untuk menggunakan versi api ini.

Isi Permintaan

Nama	Jenis	Deskripsi
isDeleted	boolean	Menunjukkan apakah pengguna ingin memulihkan bidang.
isLocked	boolean	Menunjukkan apakah pengguna ingin mengunci bidang.

Respons

Nama	Jenis	Deskripsi
200 OK	WorkItemField2	operasi berhasil

Keamanan

oauth2

Jenis: oauth2
Alur: accessCode
URL Otorisasi: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Cakupan

Nama	Deskripsi
vso.work_write	Memberikan kemampuan untuk membaca, membuat, dan memperbarui item dan kueri kerja, memperbarui metadata papan, area baca dan jalur perulangan item kerja lainnya yang melacak metadata terkait, menjalankan kueri, dan untuk menerima pemberitahuan tentang peristiwa item kerja melalui kait layanan.

Contoh

Set field locked

Undelete a field

Set field locked

Permintaan sampel

HTTP

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

{
  "isLocked": true
}

Respon sampel

Kode status:: 200

persistent-Auth: true
lfs-Authenticate: NTLM
wwW-Authenticate: Negotiate oRswGaADCgEAoxIEEAEAAAAMDzOy0XQtlQAAAAA=

{
  "name": "New Work Item Field3",
  "referenceName": "Custom.TestField",
  "description": "New work item field for testing",
  "type": "string",
  "usage": "workItem",
  "readOnly": false,
  "canSortBy": true,
  "isQueryable": true,
  "supportedOperations": [
    {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    },
    {
      "referenceName": "SupportedOperations.NotEquals",
      "name": "<>"
    },
    {
      "referenceName": "SupportedOperations.GreaterThan",
      "name": ">"
    },
    {
      "referenceName": "SupportedOperations.LessThan",
      "name": "<"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEquals",
      "name": ">="
    },
    {
      "referenceName": "SupportedOperations.LessThanEquals",
      "name": "<="
    },
    {
      "referenceName": "SupportedOperations.Contains",
      "name": "Contains"
    },
    {
      "referenceName": "SupportedOperations.NotContains",
      "name": "Does Not Contain"
    },
    {
      "referenceName": "SupportedOperations.In",
      "name": "In"
    },
    {
      "name": "Not In"
    },
    {
      "referenceName": "SupportedOperations.InGroup",
      "name": "In Group"
    },
    {
      "referenceName": "SupportedOperations.NotInGroup",
      "name": "Not In Group"
    },
    {
      "referenceName": "SupportedOperations.Ever",
      "name": "Was Ever"
    },
    {
      "referenceName": "SupportedOperations.EqualsField",
      "name": "= [Field]"
    },
    {
      "referenceName": "SupportedOperations.NotEqualsField",
      "name": "<> [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanField",
      "name": "> [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanField",
      "name": "< [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEqualsField",
      "name": ">= [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanEqualsField",
      "name": "<= [Field]"
    }
  ],
  "isIdentity": false,
  "isPicklist": false,
  "isLocked": true,
  "isPicklistSuggested": false,
  "url": "http://localhost/DefaultCollection/_apis/wit/fields/Custom.TestField"
}

Undelete a field

Permintaan sampel

HTTP

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

{
  "isDeleted": false
}

Respon sampel

Kode status:: 200

persistent-Auth: true
lfs-Authenticate: NTLM
wwW-Authenticate: Negotiate oRswGaADCgEAoxIEEAEAAAAMDzOy0XQtlQAAAAA=

{
  "name": "New Work Item Field3",
  "referenceName": "Custom.TestField",
  "description": "New work item field for testing",
  "type": "string",
  "usage": "workItem",
  "readOnly": false,
  "canSortBy": true,
  "isQueryable": true,
  "supportedOperations": [
    {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    },
    {
      "referenceName": "SupportedOperations.NotEquals",
      "name": "<>"
    },
    {
      "referenceName": "SupportedOperations.GreaterThan",
      "name": ">"
    },
    {
      "referenceName": "SupportedOperations.LessThan",
      "name": "<"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEquals",
      "name": ">="
    },
    {
      "referenceName": "SupportedOperations.LessThanEquals",
      "name": "<="
    },
    {
      "referenceName": "SupportedOperations.Contains",
      "name": "Contains"
    },
    {
      "referenceName": "SupportedOperations.NotContains",
      "name": "Does Not Contain"
    },
    {
      "referenceName": "SupportedOperations.In",
      "name": "In"
    },
    {
      "name": "Not In"
    },
    {
      "referenceName": "SupportedOperations.InGroup",
      "name": "In Group"
    },
    {
      "referenceName": "SupportedOperations.NotInGroup",
      "name": "Not In Group"
    },
    {
      "referenceName": "SupportedOperations.Ever",
      "name": "Was Ever"
    },
    {
      "referenceName": "SupportedOperations.EqualsField",
      "name": "= [Field]"
    },
    {
      "referenceName": "SupportedOperations.NotEqualsField",
      "name": "<> [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanField",
      "name": "> [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanField",
      "name": "< [Field]"
    },
    {
      "referenceName": "SupportedOperations.GreaterThanEqualsField",
      "name": ">= [Field]"
    },
    {
      "referenceName": "SupportedOperations.LessThanEqualsField",
      "name": "<= [Field]"
    }
  ],
  "isIdentity": false,
  "isPicklist": false,
  "isPicklistSuggested": false,
  "url": "http://localhost/DefaultCollection/_apis/wit/fields/Custom.TestField"
}

Definisi

Nama	Deskripsi
FieldType	Jenis bidang .
FieldUpdate	Menjelaskan permintaan pembaruan untuk bidang item kerja.
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

Enumeration

Jenis bidang .

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

FieldUpdate

Objek

Menjelaskan permintaan pembaruan untuk bidang item kerja.

Nama	Jenis	Deskripsi
isDeleted	boolean	Menunjukkan apakah pengguna ingin memulihkan bidang.
isLocked	boolean	Menunjukkan apakah pengguna ingin mengunci bidang.

FieldUsage

Enumeration

Penggunaan bidang .

Nilai	Deskripsi
none	Penggunaan kosong.
tree	Penggunaan bidang Treenode.
workItem	Penggunaan bidang item kerja.
workItemLink	Penggunaan bidang tautan item kerja.
workItemTypeExtension	Penggunaan Ekstensi Tipe Item Kerja.

ReferenceLinks

Objek

Kelas untuk mewakili kumpulan tautan referensi REST.

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

WorkItemField2

Objek

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 pilih yang disarankan .
isQueryable	boolean	Menunjukkan apakah bidang dapat dikueri di server.
name	string	Nama bidang.
picklistId	string (uuid)	Jika bidang ini adalah daftar pilih, pengidentifikasi daftar pilih 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

Objek

Menjelaskan operasi bidang item kerja.

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

Bagikan melalui

Fields - Update

Parameter URI

Isi Permintaan

Respons

Keamanan

oauth2

Cakupan

Contoh

Set field locked

Permintaan sampel

Respon sampel

Undelete a field

Permintaan sampel

Respon sampel

Definisi

FieldType

FieldUpdate

FieldUsage

ReferenceLinks

WorkItemField2

WorkItemFieldOperation