Partilhar via


Reporting Work Item Revisions

Essa API fornece acesso a todas as revisões de item de trabalho em seu projeto ou coleção e permite que você crie um warehouse.

A resposta da API contém um lote de revisões de item de trabalho ("valores"), uma URL para o próximo lote de revisões de item de trabalho("nextLink") e um booliano que informa se você leu todas as revisões de item de trabalho disponíveis no momento("isLastBatch").

O fluxo de trabalho para a criação do warehouse é o seguinte:

  1. Fazer uma solicitação à API sem fornecer um parâmetro continuationToken
  2. Processar as revisões de item de trabalho retornadas pela API
  3. Persista "nextLink" e marcar "isLastBatch"
    • Se "isLastBatch" for true, pause por um período de tempo (varia dependendo da latência de destino)
  4. Faça a próxima solicitação usando a URL de "nextLink"
  5. Ir para a etapa 2

Observação

Os resultados dessa API são afetados ao usar os recursos Mover Item de Trabalho e/ou Alterar Tipo de Item de Trabalho em conjunto com "project" na URL e/ou "tipos" na cadeia de caracteres de consulta.

  • As solicitações no escopo do projeto só retornarão revisões de item de trabalho do projeto especificado.
  • As solicitações no escopo de tipos só retornarão revisões de item de trabalho dos tipos especificados

Projetos de exemplo

Exemplo de C#

Operations

Read Reporting Revisions Get

Obter um lote de revisões de item de trabalho com a opção de incluir itens excluídos

Read Reporting Revisions Post

Obtenha um lote de revisões de item de trabalho. Essa solicitação poderá ser usada se sua lista de campos for grande o suficiente para que ela possa executar a URL acima do limite de comprimento.