Compartilhar via

Atualização em lote do item de trabalho

Serviço : Versão da API de Acompanhamento de Item de Trabalho: 4.1 executa várias solicitações de Atualização de Item de Trabalho. A resposta contém respostas individuais para cada uma das solicitações no lote. As solicitações com falha não afetam as solicitações subsequentes no lote.

Estrutura do Item de Trabalho

Um item de trabalho pode ser visualizado em uma estrutura de arquivo a seguir

WorkItem(id, rev)
|__Fields
|   |__ReferenceName
|__Relations
    |__WorkItemLinkReferenceNames
    |__ArtifactLink
    |__AttachedFile
    |__Hyperlink

SEMÂNTICA DA API REST

PATCH : https://dev.azure.com/{organization}/_apis/wit/$batch?api-version=4.1

Parâmetros de URI

Nome Em Obrigatório Tipo Descrição
accountName Caminho Verdade corda O nome da conta do Azure DevOps Services.
api-version consulta corda Versão da API a ser usada. Isso deve ser definido como '4.1' para usar esta versão da api.
bypassRules consulta boolean Não imponha as regras de tipo de item de trabalho nesta atualização.
suppressNotifications consulta boolean Não acione nenhuma notificação para essa alteração.

Corpo da Solicitação

Tipo de mídia : "application/json-patch+json" Cada solicitação é uma coleção de solicitações individuais em diferentes itens de trabalho. Cada solicitação individual consiste em três chaves principais.

  1. op: operação a ser executada em um item de trabalho (pode ser adicionar/remover/atualizar etc.)
  2. caminho: em que a operação deve ser executada em uma estrutura de arquivo de item de trabalho.
  3. valor: valor da operação fornecida.

Operação A operação de patch

Nome Tipo
copiar corda
move corda
retirar corda
replace corda
teste corda

Exemplos

  1. Adicionar/atualizar um campo.
  2. Adicione um link de item de trabalho.
  3. Adicione um hiperlink.
  4. Adicione um arquivo anexado.
  5. Adicione um artifactlink.(por exemplo, build, pullrequest, commit etc.)
  6. Remova um link de item de trabalho.
  7. Remova um link de artefato.
  8. Remova um hiperlink.
  9. Remova um remotelink.
  10. Remova um anexo.
  11. Caso em que a solicitação única na API em lote falhe.
  12. Crie vários itens de trabalho.

    Tipos

    Relação de Item de Trabalho

    Nome Tipo Descrição
    attributes <cadeia de caracteres, objeto> Coleção de atributos de link.
    Rel corda Tipo de relação.
    url corda Url do link.

    Objeto De Item de Trabalho

    Nome Tipo Descrição
    _Links [ReferenceLinks] Vincular referências a recursos REST relacionados.
    fields <cadeia de caracteres, objeto> Mapa de campos e valores para o item de trabalho.
    id número inteiro A ID do item de trabalho.
    relations WorkItemRelation Relações do item de trabalho.
    Rev número inteiro Número de revisão do item de trabalho.
    url corda url para este item de trabalho