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.
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
ou o ícone 
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 
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.
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.
Escolha uma entrada no painel esquerdo para exibir os detalhes das alterações realizadas.
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 escolher
Alternar filtro.
Para examinar as atualizações por pessoas específicas, selecione os nomes no menu Atualizado por.
Para examinar as atualizações feitas em um ou mais campos, selecione os campos no menu Campos.
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
Para que esses campos sejam definidos para um WIT, eles devem ser incluídos na
WORKFLOWseção da definição WIT. Por exemplo, essa sintaxe é incluída na definição ao fazer aFIELDStransição para um estado Resolvido:<FIELD refname="Microsoft.VSTS.Common.ResolvedDate"> <SERVERDEFAULT from="clock" /> </FIELD>
Artigos relacionados
API REST
Para interagir programaticamente com consultas, confira um destes recursos da API REST: