Fields - Create

Service:

Work Item Tracking

API Version:

5.0

Utwórz nowe pole.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/fields?api-version=5.0

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
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ść "5.0", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki do powiązanych zasobów REST.
canSortBy	boolean	Wskazuje, czy pole jest sortowalne w zapytaniach serwera.
description	string	Opis pola.
isIdentity	boolean	Wskazuje, czy to pole jest polem tożsamości.
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	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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WorkItemField	operacja zakończona powodzeniem

Zabezpieczenia

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

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

Definicje

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

FieldType

Typ pola.

Nazwa	Typ	Opis
boolean	string	Typ pola logicznego.
dateTime	string	Typ pola Data/godzina.
double	string	Typ pola podwójnego.
guid	string	Typ pola identyfikatora GUID.
history	string	Typ pola Historia.
html	string	Typ pola HTML (wielowierszowy).
identity	string	Typ pola Tożsamość.
integer	string	Typ pola Liczba całkowita.
picklistDouble	string	Podwójny typ pola listy wyboru.
picklistInteger	string	Typ pola Lista wyboru liczb całkowitych.
picklistString	string	Typ pola lista wyboru ciągów.
plainText	string	Typ pola zwykłego tekstu.
string	string	Typ pola ciąg.
treePath	string	Typ pola Ścieżka drzewa.

FieldUsage

Użycie pola.

Nazwa	Typ	Opis
none	string	Puste użycie.
tree	string	Użycie pola drzewa.
workItem	string	Użycie pola elementu roboczego.
workItemLink	string	Użycie pola łącza elementu roboczego.
workItemTypeExtension	string	Użycie rozszerzenia typu elementu roboczego.

ReferenceLinks

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

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

WorkItemField

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

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki do powiązanych zasobów REST.
canSortBy	boolean	Wskazuje, czy pole jest sortowalne w zapytaniach serwera.
description	string	Opis pola.
isIdentity	boolean	Wskazuje, czy to pole jest polem tożsamości.
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	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

Opisuje operację pola elementu roboczego.

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