Fields - Update

Odwołanie

Usługa:: Work Item Tracking

Wersja interfejsu API:: 7.1

Aktualizowanie pola.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
fieldNameOrRefName	path	True	string	Nazwa/nazwa odwołania pola do zaktualizowania
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path		string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
isDeleted	boolean	Wskazuje, czy użytkownik chce przywrócić pole.
isLocked	boolean	Wskazuje, czy użytkownik chce zablokować pole.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WorkItemField2	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa	Opis
vso.work_write	Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, metadanych tablicy aktualizacji, ścieżek obszaru odczytu i iteracji innych metadanych powiązanych elementów roboczych, wykonywania zapytań i odbierania powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Set field locked

Undelete a field

Set field locked

Przykładowe żądanie

HTTP

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

{
  "isLocked": true
}

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

HTTP

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

{
  "isDeleted": false
}

Przykładowa odpowiedź

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
FieldType	Typ pola.
FieldUpdate	Opisuje żądanie aktualizacji dla pola elementu roboczego.
FieldUsage	Użycie pola.
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
WorkItemField2	Opisuje pole elementu roboczego i jego właściwości specyficzne dla tego typu elementu roboczego.
WorkItemFieldOperation	Opisuje operację pola elementu roboczego.

FieldType

Wyliczanie

Typ pola.

Wartość	Opis
boolean	Typ pola logicznego.
dateTime	Typ pola Data/godzina.
double	Podwójny typ pola.
guid	Typ pola guid.
history	Typ pola Historia.
html	Typ pola HTML (wielowierszowy).
identity	Typ pola Tożsamość.
integer	Typ pola Liczba całkowita.
picklistDouble	Podwójny typ pola listy wyboru. Podczas tworzenia pola podwójnej listy wyboru z interfejsu API REST użyj wartości "Double" FieldType.
picklistInteger	Typ pola Lista wyboru liczby całkowitej. Podczas tworzenia pola listy wyboru liczby całkowitej z interfejsu API REST użyj pola "Liczba całkowita".
picklistString	Typ pola listy wyboru ciągów. Podczas tworzenia pola listy wyboru ciągów z interfejsu API REST użyj wartości "String" FieldType.
plainText	Typ pola zwykłego tekstu.
string	Typ pola ciąg.
treePath	Typ pola Ścieżka drzewa.

FieldUpdate

Objekt

Opisuje żądanie aktualizacji dla pola elementu roboczego.

Nazwa	Typ	Opis
isDeleted	boolean	Wskazuje, czy użytkownik chce przywrócić pole.
isLocked	boolean	Wskazuje, czy użytkownik chce zablokować pole.

FieldUsage

Wyliczanie

Użycie pola.

Wartość	Opis
none	Puste użycie.
tree	Użycie pola węźle drzewa.
workItem	Użycie pola elementu roboczego.
workItemLink	Użycie pola łącza elementu roboczego.
workItemTypeExtension	Użycie rozszerzenia typu elementu roboczego.

ReferenceLinks

Objekt

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

WorkItemField2

Objekt

Opisuje pole elementu roboczego i jego właściwości specyficzne dla tego typu elementu roboczego.

Nazwa	Typ	Opis
_links	ReferenceLinks	Połącz odwołania do powiązanych zasobów REST.
canSortBy	boolean	Wskazuje, czy pole jest sortowalne w zapytaniach serwera.
description	string	Opis pola.
isDeleted	boolean	Wskazuje, czy to pole zostało usunięte.
isIdentity	boolean	Wskazuje, czy to pole jest polem tożsamości.
isLocked	boolean	Wskazuje, czy to pole jest oznaczone jako zablokowane do edycji.
isPicklist	boolean	Wskazuje, czy to wystąpienie jest listą wyboru.
isPicklistSuggested	boolean	Wskazuje, czy to wystąpienie jest sugerowaną listą wyboru.
isQueryable	boolean	Wskazuje, czy pole może być odpytywane na serwerze.
name	string	Nazwa pola.
picklistId	string (uuid)	Jeśli to pole jest listą wyboru, identyfikator skojarzonej listy wyboru, w przeciwnym razie wartość null
readOnly	boolean	Wskazuje, czy pole jest [tylko do odczytu].
referenceName	string	Nazwa odwołania do pola.
supportedOperations	WorkItemFieldOperation[]	Obsługiwane operacje w tym polu.
type	FieldType	Typ pola.
url	string
usage	FieldUsage	Użycie pola.

WorkItemFieldOperation

Objekt

Opisuje operację pola elementu roboczego.

Nazwa	Typ	Opis
name	string	Przyjazna nazwa operacji.
referenceName	string	Nazwa odwołania do operacji.

Udostępnij przez

Fields - Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

oauth2

Zakresy

Przykłady

Set field locked

Przykładowe żądanie

Przykładowa odpowiedź

Undelete a field

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

FieldType

FieldUpdate

FieldUsage

ReferenceLinks

WorkItemField2

WorkItemFieldOperation