Fields - Update

Başvuru

Hizmet:: Work Item Tracking

API Sürümü:: 7.1

Bir alanı güncelleştirin.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
fieldNameOrRefName	path	True	string	Güncelleştirilecek alanın adı/başvuru adı
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path		string	Proje kimliği veya proje adı
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, API'nin bu sürümünü kullanmak için '7.1' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
isDeleted	boolean	Kullanıcının alanı geri yüklemek isteyip istemediğini gösterir.
isLocked	boolean	Kullanıcının alanı kilitlemek isteyip istemediğini gösterir.

Yanıtlar

Name	Tür	Description
200 OK	WorkItemField2	başarılı işlem

Güvenlik

oauth2

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

Name	Description
vso.work_write	İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, okuma alanı ve yineleme yolları ile ilgili diğer iş öğesi izleme meta verilerini okuma, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

Set field locked

Undelete a field

Set field locked

Örnek isteği

HTTP

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

{
  "isLocked": true
}

Örnek yanıt

Durum kodu:: 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

Örnek isteği

HTTP

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

{
  "isDeleted": false
}

Örnek yanıt

Durum kodu:: 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"
}

Tanımlar

Name	Description
FieldType	Alanın türü.
FieldUpdate	bir iş öğesi alanı için güncelleştirme isteğini açıklar.
FieldUsage	Alanın kullanımı.
ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
WorkItemField2	İş öğesindeki bir alanı ve bu iş öğesi türüne özgü özellikleri açıklar.
WorkItemFieldOperation	İş öğesi alanı işlemini açıklar.

FieldType

Listeleme

Alanın türü.

Değer	Description
boolean	Boole alan türü.
dateTime	Tarih saat alan türü.
double	Çift alan türü.
guid	Guid alan türü.
history	Geçmiş alan türü.
html	HTML (Çok Satırlı) alan türü.
identity	Kimlik alan türü.
integer	Tamsayı alan türü.
picklistDouble	Çift seçim listesi alan türü. REST API'den bir çift seçim listesi alanı oluştururken "Double" FieldType kullanın.
picklistInteger	Tamsayı seçim listesi alan türü. REST API'den bir tamsayı seçim listesi alanı oluştururken "Integer" FieldType kullanın.
picklistString	Dize seçim listesi alan türü. REST API'den dize seçim listesi alanı oluştururken "String" FieldType kullanın.
plainText	Düz metin alanı türü.
string	Dize alan türü.
treePath	Ağaç yolu alan türü.

FieldUpdate

Object

bir iş öğesi alanı için güncelleştirme isteğini açıklar.

Name	Tür	Description
isDeleted	boolean	Kullanıcının alanı geri yüklemek isteyip istemediğini gösterir.
isLocked	boolean	Kullanıcının alanı kilitlemek isteyip istemediğini gösterir.

FieldUsage

Listeleme

Alanın kullanımı.

Değer	Description
none	Boş kullanım.
tree	Ağaç düğümü alanı kullanımı.
workItem	İş öğesi alanı kullanımı.
workItemLink	İş öğesi bağlantı alanı kullanımı.
workItemTypeExtension	İş Öğesi Türü Uzantısı kullanımı.

ReferenceLinks

Object

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

WorkItemField2

Object

İş öğesindeki bir alanı ve bu iş öğesi türüne özgü özellikleri açıklar.

Name	Tür	Description
_links	ReferenceLinks	Başvuruları ilgili REST kaynaklarına bağlayın.
canSortBy	boolean	Alanın sunucu sorgularında sıralanabilir olup olmadığını gösterir.
description	string	Alanın açıklaması.
isDeleted	boolean	Bu alanın silinip silinmediğini gösterir.
isIdentity	boolean	Bu alanın bir kimlik alanı olup olmadığını gösterir.
isLocked	boolean	Bu alanın düzenleme için kilitli olarak işaretlenip işaretlenmediğini gösterir.
isPicklist	boolean	Bu örneğin seçim listesi olup olmadığını gösterir.
isPicklistSuggested	boolean	Bu örneğin önerilen bir seçim listesi olup olmadığını gösterir.
isQueryable	boolean	Alanın sunucuda sorgulanıp sorgulanamayacağını gösterir.
name	string	Alanın adı.
picklistId	string (uuid)	Bu alan seçim listesi ise, seçim listesinin tanımlayıcısı ilişkilendirilmiş, aksi takdirde null
readOnly	boolean	Alanın [salt okunur] olup olmadığını gösterir.
referenceName	string	Alanın başvuru adı.
supportedOperations	WorkItemFieldOperation[]	Bu alanda desteklenen işlemler.
type	FieldType	Alanın türü.
url	string
usage	FieldUsage	Alanın kullanımı.

WorkItemFieldOperation

Object

İş öğesi alanı işlemini açıklar.

Name	Tür	Description
name	string	İşlemin kolay adı.
referenceName	string	İşlemin başvuru adı.