Fields - Get

Ссылка

Service:: Work Item Tracking

API Version:: 7.1-preview.3

Возвращает сведения об определенном поле.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
fieldNameOrRefName	path	True	string	Простое имя поля или имя ссылки
organization	path	True	string	Название организации Azure DevOps.
project	path		string	Идентификатор проекта или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.3.

Ответы

Имя	Тип	Описание
200 OK	WorkItemField2	успешная операция

Безопасность

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

Имя	Описание
vso.work	Предоставляет возможность чтения рабочих элементов, запросов, досок, путей областей и итераций, а также других метаданных, связанных с отслеживанием рабочих элементов. Также предоставляет возможность выполнять запросы, искать рабочие элементы и получать уведомления о событиях рабочих элементов с помощью перехватчиков служб.

Имя

Описание

vso.work

Предоставляет возможность чтения рабочих элементов, запросов, досок, путей областей и итераций, а также других метаданных, связанных с отслеживанием рабочих элементов. Также предоставляет возможность выполнять запросы, искать рабочие элементы и получать уведомления о событиях рабочих элементов с помощью перехватчиков служб.

Примеры

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

Определения

Имя	Описание
FieldType	Тип поля.
FieldUsage	Использование поля.
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
WorkItemField2	Описывает поле в рабочем элементе и его свойства, относящиеся к этому типу рабочего элемента.
WorkItemFieldOperation	Описывает операцию с полем рабочего элемента.

FieldType

Тип поля.

Имя	Тип	Описание
boolean	string	Логический тип поля.
dateTime	string	Тип поля даты и времени.
double	string	Тип поля Double.
guid	string	Тип поля GUID.
history	string	Тип поля журнала.
html	string	Тип поля HTML (многостроковый).
identity	string	Тип поля удостоверения.
integer	string	Тип целочисленного поля.
picklistDouble	string	Тип поля double picklist. При создании поля двойного списка выбора из REST API используйте "Double" FieldType.
picklistInteger	string	Тип поля списка выбора целочисленного типа. При создании целочисленного поля списка выбора из REST API используйте "Integer" FieldType.
picklistString	string	Тип поля "Список выбора строк". При создании поля списка выбора строк из REST API используйте "String" FieldType.
plainText	string	Тип поля "Обычный текст".
string	string	Тип строкового поля.
treePath	string	Тип поля "Путь к дереву".

FieldUsage

Использование поля.

Имя	Тип	Описание
none	string	Пустое использование.
tree	string	Использование поля Treenode.
workItem	string	Использование поля рабочего элемента.
workItemLink	string	Использование поля ссылки на рабочий элемент.
workItemTypeExtension	string	Использование расширения типа рабочего элемента.

ReferenceLinks

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

WorkItemField2

Описывает поле в рабочем элементе и его свойства, относящиеся к этому типу рабочего элемента.

Имя	Тип	Описание
_links	ReferenceLinks	Ссылки на связанные ресурсы REST.
canSortBy	boolean	Указывает, можно ли сортировать поле в серверных запросах.
description	string	Описание поля.
isDeleted	boolean	Указывает, удаляется ли это поле.
isIdentity	boolean	Указывает, является ли это поле полем идентификатора.
isLocked	boolean	Указывает, помечается ли это поле как заблокированное для редактирования.
isPicklist	boolean	Указывает, является ли этот экземпляр списком выбора.
isPicklistSuggested	boolean	Указывает, является ли этот экземпляр предлагаемым списком выбора .
isQueryable	boolean	Указывает, можно ли запрашивать поле на сервере.
name	string	Имя поля.
picklistId	string	Если это поле является списком выбора, идентификатор связанного списка выбора; в противном случае — значение NULL.
readOnly	boolean	Указывает, является ли поле [только для чтения].
referenceName	string	Имя ссылки на поле.
supportedOperations	WorkItemFieldOperation[]	Поддерживаемые операции с этим полем.
type	FieldType	Тип поля.
url	string
usage	FieldUsage	Использование поля.

WorkItemFieldOperation

Описывает операцию с полем рабочего элемента.

Имя	Тип	Описание
name	string	Понятное имя операции.
referenceName	string	Имя ссылки на операцию.

Поделиться через