Fields - Create

Référence

Service:: Work Item Tracking

API Version:: 6.0

Créez un champ.

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

Paramè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 « 6.0 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
_links	ReferenceLinks	Lier des références à des ressources REST associées.
canSortBy	boolean	Indique si le champ peut être trié dans les requêtes serveur.
description	string	Description du champ.
isDeleted	boolean	Indique si ce champ est supprimé.
isIdentity	boolean	Indique si ce champ est un champ d’identité.
isPicklist	boolean	Indique si cette instance est une liste de choix.
isPicklistSuggested	boolean	Indique si cette instance est une liste de choix suggérée.
isQueryable	boolean	Indique si le champ peut être interrogé sur 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	WorkItemFieldOperation[]	Opérations prises en charge sur ce champ.
type	FieldType	Type du champ.
url	string
usage	FieldUsage	Utilisation du champ.

Réponses

Nom	Type	Description
200 OK	WorkItemField	opération réussie

Sécurité

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

Nom	Description
vso.work_write	Accorde la possibilité de lire, créer et mettre à jour des éléments de travail et des requêtes, mettre à jour les métadonnées du tableau, les zones de lecture et les itérations 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.

Exemples

Create a new field

Sample Request

HTTP

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

{
  "name": "New Work Item Field",
  "referenceName": "SupportedOperations.GreaterThanEquals",
  "description": null,
  "type": "string",
  "usage": "workItem",
  "readOnly": false,
  "canSortBy": true,
  "isQueryable": true,
  "supportedOperations": [
    {
      "referenceName": "SupportedOperations.Equals",
      "name": "="
    }
  ],
  "isIdentity": true,
  "isPicklist": false,
  "isPicklistSuggested": false,
  "url": null
}

Sample Response

Status code:: 200

{
  "name": "New Work Item Field",
  "referenceName": "SupportedOperations.GreaterThanEquals",
  "description": null,
  "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": "https://dev.azure.com/fabricam3/_apis/wit/fields/SupportedOperations.GreaterThanEquals"
}

Définitions

Nom	Description
FieldType	Type du champ.
FieldUsage	Utilisation du champ.
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.
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.
WorkItemFieldOperation	Décrit une opération de champ d’élément de travail.

FieldType

Type du champ.

Nom	Type	Description
boolean	string	Type de champ booléen.
dateTime	string	Type de champ Datetime.
double	string	Type de champ double.
guid	string	Type de champ GUID.
history	string	Type de champ Historique.
html	string	Type de champ HTML (multiligne).
identity	string	Type de champ d’identité.
integer	string	Type de champ Integer.
picklistDouble	string	Type de champ liste de sélection double. Lorsque vous créez un champ de liste de sélection double à partir de l’API REST, utilisez « Double » FieldType.
picklistInteger	string	Type de champ de liste de choix d’entier. Lorsque vous créez un champ de liste de choix d’entiers à partir de l’API REST, utilisez « Integer » FieldType.
picklistString	string	Type de champ de liste de choix de chaînes. Lorsque vous créez un champ de liste de choix de chaîne à partir de l’API REST, utilisez « String » FieldType.
plainText	string	Type de champ de texte brut.
string	string	Type de champ chaîne.
treePath	string	Type de champ Treepath.

FieldUsage

Utilisation du champ.

Nom	Type	Description
none	string	Utilisation vide.
tree	string	Utilisation du champ Treenode.
workItem	string	Utilisation du champ d’élément de travail.
workItemLink	string	Utilisation du champ de lien d’élément de travail.
workItemTypeExtension	string	Utilisation de l’extension de type d’é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 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	ReferenceLinks	Lier des références à des ressources REST associées.
canSortBy	boolean	Indique si le champ peut être trié dans les requêtes serveur.
description	string	Description du champ.
isDeleted	boolean	Indique si ce champ est supprimé.
isIdentity	boolean	Indique si ce champ est un champ d’identité.
isPicklist	boolean	Indique si cette instance est une liste de choix.
isPicklistSuggested	boolean	Indique si cette instance est une liste de choix suggérée.
isQueryable	boolean	Indique si le champ peut être interrogé sur 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	WorkItemFieldOperation[]	Opérations prises en charge sur ce champ.
type	FieldType	Type du champ.
url	string
usage	FieldUsage	Utilisation du champ.

WorkItemFieldOperation

Décrit une opération de champ d’élément de travail.

Nom	Type	Description
name	string	Nom convivial de l’opération.
referenceName	string	Nom de référence de l’opération.

Partager via