Partager via


Work Items - Create

Crée un seul élément de travail.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?api-version=7.1-preview.3
POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?validateOnly={validateOnly}&bypassRules={bypassRules}&suppressNotifications={suppressNotifications}&$expand={$expand}&api-version=7.1-preview.3

Paramètres URI

Nom Dans Obligatoire Type Description
organization
path True

string

Nom de l’organisation Azure DevOps.

project
path True

string

ID de projet ou nom du projet

type
path True

string

Type d’élément de travail de l’élément de travail à créer

api-version
query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.3 » pour utiliser cette version de l’API.

$expand
query

WorkItemExpand

Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }.

bypassRules
query

boolean

N’appliquez pas les règles de type d’élément de travail sur cette mise à jour

suppressNotifications
query

boolean

Ne déclenchez aucune notification pour cette modification

validateOnly
query

boolean

Indiquez si vous souhaitez uniquement valider les modifications sans enregistrer l’élément de travail

Corps de la demande

Media Types: "application/json-patch+json"

Nom Type Description
from

string

Chemin d’accès à partir duquel copier pour l’opération Déplacer/Copier.

op

Operation

Opération de correctif

path

string

Chemin d’accès de l’opération. Dans le cas d’un tableau, un index de base zéro peut être utilisé pour spécifier la position dans le tableau (par exemple, /biscuits/0/name). Le caractère « - » peut être utilisé à la place d’un index à insérer à la fin du tableau (par exemple, /biscuits/-).

value

object

Valeur de l’opération. Il s’agit d’une primitive ou d’un JToken.

Réponses

Nom Type Description
200 OK

WorkItem

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 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.

Exemples

Create work item

Sample Request

POST https://dev.azure.com/fabrikam/{project}/_apis/wit/workitems/${type}?api-version=7.1-preview.3

[
  {
    "op": "add",
    "path": "/fields/System.Title",
    "from": null,
    "value": "Sample task"
  }
]

Sample Response

{
  "id": 131489,
  "rev": 1,
  "fields": {
    "System.AreaPath": "CustomProcessPrj",
    "System.TeamProject": "CustomProcessPrj",
    "System.IterationPath": "CustomProcessPrj",
    "System.WorkItemType": "Task",
    "System.State": "New",
    "System.Reason": "New",
    "System.CreatedDate": "2017-10-06T01:04:51.57Z",
    "System.CreatedBy": {
      "displayName": "Jamal Hartnett",
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "_links": {
        "avatar": {
          "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        }
      },
      "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "uniqueName": "fabrikamfiber4@hotmail.com",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
    },
    "System.ChangedDate": "2017-10-06T01:04:51.57Z",
    "System.ChangedBy": {
      "displayName": "Jamal Hartnett",
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "_links": {
        "avatar": {
          "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        }
      },
      "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "uniqueName": "fabrikamfiber4@hotmail.com",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
    },
    "System.Title": "Sample task",
    "Microsoft.VSTS.Common.StateChangeDate": "2017-10-06T01:04:51.57Z",
    "Microsoft.VSTS.Common.Priority": 2
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
    },
    "workItemUpdates": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/updates"
    },
    "workItemRevisions": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/revisions"
    },
    "workItemHistory": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/history"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=20cda608-32f0-4e6e-9b7c-8def7b38d15a&id=131489"
    },
    "workItemType": {
      "href": "https://dev.azure.com/fabrikam/aaee31d9-14cf-48b9-a92b-3f1446c13f80/_apis/wit/workItemTypes/Task"
    },
    "fields": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
    }
  },
  "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
}

Définitions

Nom Description
JsonPatchDocument

Modèle JSON pour les opérations de correctif JSON

Operation

Opération de correctif

ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

WorkItem

Décrit un élément de travail.

WorkItemCommentVersionRef

Représente la référence à une version spécifique d’un commentaire sur un élément de travail.

WorkItemExpand

Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }

WorkItemRelation

JsonPatchDocument

Modèle JSON pour les opérations de correctif JSON

Nom Type Description
from

string

Chemin d’accès à partir duquel copier pour l’opération Déplacer/Copier.

op

Operation

Opération de correctif

path

string

Chemin d’accès de l’opération. Dans le cas d’un tableau, un index de base zéro peut être utilisé pour spécifier la position dans le tableau (par exemple, /biscuits/0/name). Le caractère « - » peut être utilisé à la place d’un index à insérer à la fin du tableau (par exemple, /biscuits/-).

value

object

Valeur de l’opération. Il s’agit d’une primitive ou d’un JToken.

Operation

Opération de correctif

Nom Type Description
add

string

copy

string

move

string

remove

string

replace

string

test

string

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.

WorkItem

Décrit un élément de travail.

Nom Type Description
_links

ReferenceLinks

Lier des références à des ressources REST associées.

commentVersionRef

WorkItemCommentVersionRef

Référence à une version spécifique du commentaire ajouté/modifié/supprimé dans cette révision.

fields

object

Mappage du champ et des valeurs de l’élément de travail.

id

integer

ID de l’élément de travail.

relations

WorkItemRelation[]

Relations de l’élément de travail.

rev

integer

Numéro de révision de l’élément de travail.

url

string

WorkItemCommentVersionRef

Représente la référence à une version spécifique d’un commentaire sur un élément de travail.

Nom Type Description
commentId

integer

ID attribué au commentaire.

createdInRevision

integer

[Interne] Révision de l’élément de travail où ce commentaire a été ajouté à l’origine.

isDeleted

boolean

[Interne] Spécifie si le commentaire a été supprimé.

text

string

[Interne] Texte du commentaire.

url

string

version

integer

Numéro de version.

WorkItemExpand

Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }

Nom Type Description
all

string

Développe tout.

fields

string

L’élément de travail des champs se développe.

links

string

L’élément de travail liens se développe.

none

string

Comportement par défaut

relations

string

Développez l’élément de travail Relations.

WorkItemRelation

Nom Type Description
attributes

object

Collection d’attributs de lien.

rel

string

Type de relation.

url

string

URL du lien.