Work Items - Create

Referência

Serviço:: Work Item Tracking

Versão da API:: 7.1

Cria um único item de trabalho.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
type	path	True	string	O tipo de item de trabalho do item de trabalho a ser criado
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.
$expand	query		WorkItemExpand	Os parâmetros de expansão para atributos de item de trabalho. As opções possíveis são { None, Relations, Fields, Links, All }.
bypassRules	query		boolean	Não impor as regras de tipo de item de trabalho nesta atualização
suppressNotifications	query		boolean	Não acione nenhuma notificação para essa alteração
validateOnly	query		boolean	Indique se você só deseja validar as alterações sem salvar o item de trabalho

Corpo da solicitação

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

Nome	Tipo	Description
from	string	O caminho a ser copiado para a operação Mover/Copiar.
op	Operation	A operação de patch
path	string	O caminho para a operação. No caso de uma matriz, um índice baseado em zero pode ser usado para especificar a posição na matriz (por exemplo, /biscuits/0/name). O caractere "-" pode ser usado em vez de um índice para inserir no final da matriz (por exemplo, /cookies/-).
value	object	O valor da operação. Isto é um primitivo ou um JToken.

Respostas

Nome	Tipo	Description
200 OK	WorkItem	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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

Escopos

Nome	Description
vso.work_write	Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler área e iterações caminhos de outros metadados relacionados ao item de trabalho, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

Create work item

Solicitação de exemplo

HTTP

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

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

Resposta de exemplo

Código de status:: 200

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

Definições

Nome	Description
JsonPatchDocument	O modelo JSON para operações de patch JSON
Operation	A operação de patch
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
WorkItem	Descreve um item de trabalho.
WorkItemCommentVersionRef	Representa a referência a uma versão específica de um comentário em um Item de Trabalho.
WorkItemExpand	Os parâmetros de expansão para atributos de item de trabalho. As opções possíveis são { None, Relations, Fields, Links, All }
WorkItemRelation

JsonPatchDocument

Objeto

O modelo JSON para operações de patch JSON

Nome	Tipo	Description
from	string	O caminho a ser copiado para a operação Mover/Copiar.
op	Operation	A operação de patch
path	string	O caminho para a operação. No caso de uma matriz, um índice baseado em zero pode ser usado para especificar a posição na matriz (por exemplo, /biscuits/0/name). O caractere "-" pode ser usado em vez de um índice para inserir no final da matriz (por exemplo, /cookies/-).
value	object	O valor da operação. Isto é um primitivo ou um JToken.

Operation

Enumeração

A operação de patch

Valor	Description
add
copy
move
remove
replace
test

ReferenceLinks

Objeto

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

WorkItem

Objeto

Descreve um item de trabalho.

Nome	Tipo	Description
_links	ReferenceLinks	Vincular referências a recursos REST relacionados.
commentVersionRef	WorkItemCommentVersionRef	Referência a uma versão específica do comentário adicionado/editado/excluído nesta revisão.
fields	object	Mapa de campos e valores para o item de trabalho.
id	integer (int32)	A ID do item de trabalho.
relations	WorkItemRelation[]	Relações do item de trabalho.
rev	integer (int32)	Número de revisão do item de trabalho.
url	string

WorkItemCommentVersionRef

Objeto

Representa a referência a uma versão específica de um comentário em um Item de Trabalho.

Nome	Tipo	Description
commentId	integer (int32)	A ID atribuída ao comentário.
createdInRevision	integer (int32)	[Interno] A revisão do item de trabalho em que esse comentário foi adicionado originalmente.
isDeleted	boolean	[Interno] Especifica se o comentário foi excluído.
text	string	[Interno] O texto do comentário.
url	string
version	integer (int32)	O número da versão.

WorkItemExpand

Enumeração

Os parâmetros de expansão para atributos de item de trabalho. As opções possíveis são { None, Relations, Fields, Links, All }

Valor	Description
all	Expande tudo.
fields	Os campos do item de trabalho se expandem.
links	Os links do item de trabalho se expandem.
none	Comportamento padrão.
relations	O item de trabalho de relações é expandido.

WorkItemRelation

Objeto

Nome	Tipo	Description
attributes	object	Coleção de atributos de link.
rel	string	Tipo de relação.
url	string	Url do link.

Partilhar via

Work Items - Create

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

oauth2

Escopos

Exemplos

Create work item

Solicitação de exemplo

Resposta de exemplo

Definições

JsonPatchDocument

Operation

ReferenceLinks

WorkItem

WorkItemCommentVersionRef

WorkItemExpand

WorkItemRelation