Consulta do histórico de itens de trabalho e campos de discussão no Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

O histórico de um item de trabalho informa quem abriu o item, o que mudou e por quê. Essas informações ajudam você a acompanhar como um item muda ao longo do tempo. Ao inserir informações no campo histórico, forneça o máximo de informações possível para ajudar o próximo proprietário do item de trabalho a entender o que aconteceu e o que ele precisa fazer.

Observação

Não existe um campo de item de trabalho chamado Discussão . Para consultar itens de trabalho com comentários inseridos na área de Discussão, você precisará filtrá-los no campo Histórico. O conteúdo completo do texto inserido na caixa de texto de Discussão é adicionado ao campo Histórico.

Operadores e macros com suporte

As cláusulas de consulta que especificam o campo Histórico podem usar os operadores Contém Palavras e Não Contém Palavras. Pesquise uma frase exata ou use o caractere curinga, *. Você pode usar somente o caractere curinga no final de uma palavra ou frase parcial.

O campo Histórico é automaticamente indexado para pesquisa de texto completo quando a pesquisa de texto completo está disponível. Ver pesquisas de texto completo e de palavras parciais

Consultar o histórico de um item de trabalho

Você pode usar o portal da Web ou o Team Explorer para exibir o histórico de um item de trabalho ou encontrar itens de trabalho com base no conteúdo do campo Histórico. Quando você executa uma pesquisa no conteúdo do campo Histórico, ele retorna apenas itens de trabalho que têm alterações registradas nesse campo. Ou seja, ele não registra alterações feitas no texto em outros campos.

Captura de tela do Editor de Consultas para pesquisar itens com base em palavras contidas no campo Histórico.

Listar itens com base no conteúdo do campo Histórico

Use o editor de consultas para adicionar o campo Histórico a uma cláusula de consulta. Os comentários inseridos na área Discussão são consultáveis. As entradas de histórico de alterações, como quais campos foram alterados, não são consultáveis. Para localizar rapidamente itens com base em palavras inseridas na área Discussão, ou Descrição ou outros campos de rich text, considere usar a pesquisa de item de trabalho.

É possível filtrar itens de trabalho pela data na qual eles foram alterados ou por um período de tempo específico. Se você limitar o escopo de uma consulta, isso pode ajudar no desempenho retornando apenas os resultados que se encaixam no intervalo de datas que deseja incluir.

Filtrar por

Incluir estas cláusulas de consulta


Itens cujo campo Histórico contém a palavra "reproduzível"

History Contains Words reproducible

Itens cujo campo Histórico não contém a palavra "beta"

History Does Not Contain Words beta

Itens que contêm a frase "rastreamentos de pilha" e foram fechados, mas reativados

History Contains Words stack traces And State Was Ever Closed
And State <> Closed

Itens fechados em um período de tempo especificado

State = Done
And Closed Date > 7/1/2015
And Closed Date <= 7/21/2015

Itens com os quais fui associado

History Contains Words MyName
Or Assigned To Was Ever _ @Me


Dicas para usar o editor de consultas

  • Insira a palavra ou frase completa especificada no campo Histórico desses itens de trabalho que você deseja procurar.
  • Insira o texto completo para a palavra que deseja pesquisar. O campo Histórico é indexado para pesquisa de texto completo. Caso somente uma palavra parcial seja inserida, a consulta não retornará itens de trabalho que contenham a palavra inteira. Por exemplo, se o campo Histórico contiver a frase «comportamento reproduzível e você pesquisar por repro, o item de trabalho não será localizado. No entanto, se você pesquisar a palavra completa reproduzível, o item de trabalho poderá ser encontrado. Também é possível pesquisar pela cadeia de caracteres usando um curinga, como repro*.
  • O editor de consultas ignora palavras comuns ou palavras irrelevantes, conforme definido em Configurar e Gerenciar Palavras Irrelevantes e Listas de Palavras Irrelevantes para Pesquisa de Texto Completo.
  • Na barra de ferramentas do editor de consultas, escolha Executar consulta ou o ícone Executar consulta, versão anterior e confirme se a consulta retorna os resultados esperados.
  • Se você não receber os resultados esperados, ajuste a palavra ou a frase que inseriu e execute a consulta novamente.

Exibir o histórico de itens de trabalho

Uma entrada é feita no campo Histórico sempre que um item de trabalho é salvo. Para exibir o histórico de alterações, abra um item de trabalho existente e escolha o ícone da guia histórico ou a guiaHistórico ou, para alguns tipos de item de trabalho, escolha a guia Detalhes.

Os detalhes do histórico exibidos dependem da plataforma, da versão e do cliente.

Captura de tela do formulário de Item de trabalho, Portal da Web, guia Escolher Histórico.

O diagrama de histórico de alterações de estado aparece primeiro. Para ver todo o histórico de alterações de estado, escolha Mostrar tudo.

Captura de tela do formulário de Item de trabalho,Portal da Web, Diagrama de histórico de alterações de estado (somente portal da Web).

Escolha uma entrada no painel esquerdo para exibir os detalhes das alterações realizadas.

Captura de tela do formulário de Item de trabalho, guia Histórico, Portal da Web, Detalhes.

Filtrar a exibição de histórico

A guia Histórico foi projetada para rastrear todas as alterações feitas em um item de trabalho para dar suporte à rastreabilidade completa. O longo histórico de revisões resultante pode dificultar a compreensão de quando ocorrem alterações em campos específicos. Para localizar rapidamente as revisões feitas em um campo específico ou por pessoas específicas, filtre o modo de exibição de histórico.

Observação

O recurso Alternar filtro exige que você habilite o recurso de versão prévia do Hub do Novo Boards. Para habilitar esse recurso, confira Gerenciar ou habilitar recursos.

Habilite o recurso de filtro ao escolherAlternar filtro.

Captura de tela do formulário de Item de trabalho, guia Histórico, filtro histórico habilitado.

Para examinar as atualizações por pessoas específicas, selecione os nomes no menu Atualizado por.

Captura de tela do formulário de item de trabalho, guia Histórico, Filtrar por quem fez atualizações.

Para examinar as atualizações feitas em um ou mais campos, selecione os campos no menu Campos.

Captura de tela do formulário de Item de trabalho, guia Histórico, Filtrar as alterações feitas no campo Atribuído a.

Campos que dão suporte a histórico, auditoria e acompanhamento de revisão

Você pode usar os campos a seguir para filtrar consultas e criar relatórios. Vários desses campos são preenchidos com informações à medida que um item de trabalho progride de um estado para outro. Outros campos são atualizados quando o item de trabalho é modificado. Alguns campos não aparecem no formulário do item de trabalho, mas são rastreados para os WITs listados.

Nome do campo

Descrição

Tipo de item de trabalho


Alterado por

O nome do membro da equipe que modificou o item de trabalho por último.

Reference name=System.ChangedBy, Data type=String

Tudo

Alterar data

A data e a hora em que um item de trabalho foi modificado.

Reference name=System.ChangedDate, Data type=DateTime

Tudo

Data de Encerramento 1

A data e a hora em que um item de trabalho foi fechado.
Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

Tudo

Data de criação

A data e a hora em que um item de trabalho foi criado.

Reference name=System.ChangedDate, Data type=DateTime

Tudo

Histórico

O registro das alterações feitas no item de trabalho após a sua criação. Sempre que o item de trabalho for atualizado, as informações serão anexadas ao histórico, especificando a data da alteração, quem fez as alterações e quais campos foram alterados.

Observação

As consultas do campo Histórico retornam itens de trabalho cujos campos Discussão ou Descrição contêm palavras que correspondem às palavras-chave inseridas. Você não pode usar o campo Histórico para consultar as alterações feitas em outros campos.

Não é possível adicionar texto formatado ao campo Histórico. Depois de salvar o item de trabalho, você não poderá alterar o histórico.
O campo History, juntamente com os campos Description, Steps to Repro e Title são automaticamente indexados para pesquisa de texto completo, conforme descrito em Campos de consulta, operadores e macros.

Reference name=System.History, Data type=History

Tudo

Data de Resolução 1

A data e a hora em que o item de trabalho foi movido para um estado Resolvido.

Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

Bug (Agile, CMMI)

Rev

Um número que é atribuído à revisão histórica de um item de trabalho.

Observação

Um limite de revisão de item de trabalho de 10.000 está em vigor para atualizações feitas por meio da API REST para o Azure DevOps Services. Esse limite restringe as atualizações da API REST, no entanto, as atualizações do portal da Web não são afetadas.

Reference name=System.Rev, Data type=Integer

Tudo

Data de Revisada

A data e a hora em que um item de trabalho foi modificado.

Reference name=System.ChangedDate, Data type=DateTime

Parâmetro Compartilhado, Etapa Compartilhada, Caso de Teste

Data da Alteração de Estado

A data e a hora em que o valor do campo Estado foi alterado.

Reference name=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

Tudo

Controla outras operações executadas ao modificar um conjunto de testes, por exemplo: adicionar testes a um conjunto de testes ou alterar configurações. Esse campo pode ser visualizado por meio da guia Histórico ou de uma consulta separada. Há uma exibição de histórico consolidada, incluindo alterações desempenhadas no campo de itens de trabalho e alterações resultantes de artefatos relacionados, como pontos de teste e configurações.
Reference name=Microsoft.VSTS.TCM.TestSuiteAudit, Data type=PlainText

Conjunto de testes

Um campo gerenciado pelo sistema (não editável) que incrementa com alterações feitas em um item de trabalho.
Reference name=System.Watermark, Data type=Integer

Tudo

Observação

  1. Para que esses campos sejam definidos para um WIT, eles devem ser incluídos na WORKFLOW seção da definição WIT. Por exemplo, essa sintaxe é incluída na definição ao fazer a FIELDS transição para um estado Resolvido:

    <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">  
       <SERVERDEFAULT from="clock" />  
    </FIELD>  
    

API REST

Para interagir programaticamente com consultas, confira um destes recursos da API REST: