Fields - Create
Créez un champ.
POST https://dev.azure.com/{organization}/{project}/_apis/wit/fields?api-version=5.0Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nom de l’organisation Azure DevOps. |
|
project
|
path |
string |
ID de projet ou nom du projet |
|
|
api-version
|
query | True |
string |
Version de l’API à utiliser. Cette valeur doit être définie sur « 5.0 » pour utiliser cette version de l’API. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| _links |
Lier des références à des ressources REST associées. |
|
| canSortBy |
boolean |
Indique si le champ peut être trié dans les requêtes de serveur. |
| description |
string |
Description du champ. |
| isIdentity |
boolean |
Indique si ce champ est un champ d’identité. |
| isPicklist |
boolean |
Indique si cette instance est une liste de sélection. |
| isPicklistSuggested |
boolean |
Indique si cette instance est une liste de choix suggérée. |
| isQueryable |
boolean |
Indique si le champ peut être interrogé dans le serveur. |
| name |
string |
Nom du champ. |
| picklistId |
string |
Si ce champ est une liste de sélection, l’identificateur de la liste de sélection est associé, sinon null |
| readOnly |
boolean |
Indique si le champ est [lecture seule]. |
| referenceName |
string |
Nom de référence du champ. |
| supportedOperations |
Opérations prises en charge sur ce champ. |
|
| type |
Type du champ. |
|
| url |
string |
|
| usage |
Utilisation du champ. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
opération réussie |
Sécurité
oauth2
Type:
oauth2
Flux:
accessCode
URL d’autorisation:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton:
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
Étendues
| Nom | Description |
|---|---|
| vso.work_write | Autorise la lecture, la création et la mise à jour d’éléments de travail et de requêtes, la mise à jour des métadonnées du tableau, la zone de lecture et les itérations des chemins d’autres métadonnées associées au suivi des éléments de travail, à exécuter des requêtes et à recevoir des notifications sur les événements d’élément de travail via des hooks de service. |
Définitions
| Nom | Description |
|---|---|
|
Field |
Type du champ. |
|
Field |
Utilisation du champ. |
|
Reference |
Classe pour représenter une collection de liens de référence REST. |
|
Work |
Décrit un champ sur un élément de travail et ses propriétés spécifiques à ce type d’élément de travail. |
|
Work |
Décrit une opération de champ d’élément de travail. |
FieldType
Type du champ.
| Valeur | Description |
|---|---|
| boolean |
Type de champ booléen. |
| dateTime |
Type de champ Datetime. |
| double |
Type de champ double. |
| guid |
Type de champ GUID. |
| history |
Type de champ d’historique. |
| html |
Type de champ HTML (multiligne). |
| identity |
Type de champ d’identité. |
| integer |
Type de champ Integer. |
| picklistDouble |
Type de champ de liste de sélection double. |
| picklistInteger |
Type de champ de liste de sélection entière. |
| picklistString |
Type de champ de liste de sélection de chaînes. |
| plainText |
Type de champ de texte brut. |
| string |
Type de champ de chaîne. |
| treePath |
Type de champ Treepath. |
FieldUsage
Utilisation du champ.
| Valeur | Description |
|---|---|
| none |
Utilisation vide. |
| tree |
Utilisation des champs Treenode. |
| workItem |
Utilisation des champs d’élément de travail. |
| workItemLink |
Utilisation du champ de lien d’élément de travail. |
| workItemTypeExtension |
Utilisation de l’extension de type élément de travail. |
ReferenceLinks
Classe pour représenter une collection de liens de référence REST.
| Nom | Type | Description |
|---|---|---|
| links |
object |
Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule. |
WorkItemField
Décrit un champ sur un élément de travail et ses propriétés spécifiques à ce type d’élément de travail.
| Nom | Type | Description |
|---|---|---|
| _links |
Lier des références à des ressources REST associées. |
|
| canSortBy |
boolean |
Indique si le champ peut être trié dans les requêtes de serveur. |
| description |
string |
Description du champ. |
| isIdentity |
boolean |
Indique si ce champ est un champ d’identité. |
| isPicklist |
boolean |
Indique si cette instance est une liste de sélection. |
| isPicklistSuggested |
boolean |
Indique si cette instance est une liste de choix suggérée. |
| isQueryable |
boolean |
Indique si le champ peut être interrogé dans le serveur. |
| name |
string |
Nom du champ. |
| picklistId |
string |
Si ce champ est une liste de sélection, l’identificateur de la liste de sélection est associé, sinon null |
| readOnly |
boolean |
Indique si le champ est [lecture seule]. |
| referenceName |
string |
Nom de référence du champ. |
| supportedOperations |
Opérations prises en charge sur ce champ. |
|
| type |
Type du champ. |
|
| url |
string |
|
| usage |
Utilisation du champ. |
WorkItemFieldOperation
Décrit une opération de champ d’élément de travail.
| Nom | Type | Description |
|---|---|---|
| name |
string |
Nom de l’opération. |
| referenceName |
string |
Nom de référence de l’opération. |