Fields - Create
Cree un nuevo campo.
POST https://dev.azure.com/{organization}/{project}/_apis/wit/fields?api-version=5.0Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
El nombre de la organización de Azure DevOps. |
|
project
|
path |
string |
Id. de proyecto o nombre del proyecto |
|
|
api-version
|
query | True |
string |
Versión de la API que se va a usar. Debe establecerse en "5.0" para usar esta versión de la API. |
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| _links |
Vincular referencias a recursos REST relacionados. |
|
| canSortBy |
boolean |
Indica si el campo se puede ordenar en las consultas del servidor. |
| description |
string |
Descripción del campo. |
| isIdentity |
boolean |
Indica si este campo es un campo de identidad. |
| isPicklist |
boolean |
Indica si esta instancia está seleccionada. |
| isPicklistSuggested |
boolean |
Indica si esta instancia es una lista de selección sugerida. |
| isQueryable |
boolean |
Indica si el campo se puede consultar en el servidor. |
| name |
string |
Nombre del campo. |
| picklistId |
string |
Si este campo es picklist, el identificador de la lista de selección asociada; de lo contrario, null |
| readOnly |
boolean |
Indica si el campo es [solo lectura]. |
| referenceName |
string |
Nombre de referencia del campo. |
| supportedOperations |
Las operaciones admitidas en este campo. |
|
| type |
Tipo del campo. |
|
| url |
string |
|
| usage |
El uso del campo. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
operación correcta |
Seguridad
oauth2
Tipo:
oauth2
Flujo:
accessCode
Dirección URL de autorización:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del 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
Ámbitos
| Nombre | Description |
|---|---|
| vso.work_write | Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos de panel, áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados con el seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio. |
Definiciones
| Nombre | Description |
|---|---|
|
Field |
Tipo del campo. |
|
Field |
El uso del campo. |
|
Reference |
Clase que se va a representar una colección de vínculos de referencia de REST. |
|
Work |
Describe un campo en un elemento de trabajo y son propiedades específicas de ese tipo de elemento de trabajo. |
|
Work |
Describe una operación de campo de elemento de trabajo. |
FieldType
Tipo del campo.
| Valor | Description |
|---|---|
| boolean |
Tipo de campo booleano. |
| dateTime |
Tipo de campo Datetime. |
| double |
Tipo de campo doble. |
| guid |
Tipo de campo guid. |
| history |
Tipo de campo Historial. |
| html |
Tipo de campo HTML (multilínea). |
| identity |
Tipo de campo de identidad. |
| integer |
Tipo de campo entero. |
| picklistDouble |
Tipo de campo de lista de selección doble. |
| picklistInteger |
Tipo de campo de lista de selección de enteros. |
| picklistString |
Tipo de campo de lista de selección de cadena. |
| plainText |
Tipo de campo de texto sin formato. |
| string |
Tipo de campo de cadena. |
| treePath |
Tipo de campo Treepath. |
FieldUsage
El uso del campo.
| Valor | Description |
|---|---|
| none |
Uso vacío. |
| tree |
Uso del campo Treenode. |
| workItem |
Uso de campos de elemento de trabajo. |
| workItemLink |
Uso del campo de vínculo de elemento de trabajo. |
| workItemTypeExtension |
Uso de la extensión de tipo de elemento de trabajo. |
ReferenceLinks
Clase que se va a representar una colección de vínculos de referencia de REST.
| Nombre | Tipo | Description |
|---|---|---|
| links |
object |
Vista de lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura. |
WorkItemField
Describe un campo en un elemento de trabajo y son propiedades específicas de ese tipo de elemento de trabajo.
| Nombre | Tipo | Description |
|---|---|---|
| _links |
Vincular referencias a recursos REST relacionados. |
|
| canSortBy |
boolean |
Indica si el campo se puede ordenar en las consultas del servidor. |
| description |
string |
Descripción del campo. |
| isIdentity |
boolean |
Indica si este campo es un campo de identidad. |
| isPicklist |
boolean |
Indica si esta instancia está seleccionada. |
| isPicklistSuggested |
boolean |
Indica si esta instancia es una lista de selección sugerida. |
| isQueryable |
boolean |
Indica si el campo se puede consultar en el servidor. |
| name |
string |
Nombre del campo. |
| picklistId |
string |
Si este campo es picklist, el identificador de la lista de selección asociada; de lo contrario, null |
| readOnly |
boolean |
Indica si el campo es [solo lectura]. |
| referenceName |
string |
Nombre de referencia del campo. |
| supportedOperations |
Las operaciones admitidas en este campo. |
|
| type |
Tipo del campo. |
|
| url |
string |
|
| usage |
El uso del campo. |
WorkItemFieldOperation
Describe una operación de campo de elemento de trabajo.
| Nombre | Tipo | Description |
|---|---|---|
| name |
string |
Nombre de la operación. |
| referenceName |
string |
Nombre de referencia de la operación. |