Histórico de itens de trabalho de consulta e campos de discussão

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

O histórico de um item de trabalho registra quem criou o item, o que mudou e por que a alteração ocorreu. Estas informações apoiam a rastreabilidade e a auditoria. Ao adicionar entradas ao campo Histórico, inclua detalhes suficientes para ajudar o próximo proprietário a entender o contexto e as próximas etapas.

Prerequisites

Operadores e macros suportados

• Operadores suportados:

  • Contém palavras
  • Não contém palavras

• Métodos de pesquisa:

  • Frase exata: localize uma sequência exata de palavras.
  • Caractere curinga (*): use apenas no final de uma palavra ou frase parcial.

• Pesquisa de texto completo: o campo Histórico é indexado para pesquisa de texto completo onde o serviço o suporta. (Os Serviços de DevOps do Azure expõem a pesquisa de item de trabalho por padrão; o Servidor de DevOps do Azure no local requer que o recurso Pesquisa/Relatório seja instalado e configurado.)

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 pesquisar itens de trabalho com base no campo Histórico. A pesquisa no campo Histórico retorna apenas itens com conteúdo registrado nesse campo e não inclui alterações estruturadas feitas em outros campos.

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

Use o Editor de Consultas para incluir o campo Histórico em uma cláusula de consulta.

• Conteúdo consultável: comentários inseridos na área de Discussão (Histórico).
• Conteúdo não consultável: metadados de revisão como "Campo X alterado de A para B" não podem ser consultados através do campo Histórico.
• Métodos de pesquisa alternativos: para pesquisar palavras em campos rich-text (Descrição, Passos, Discussão), utilize a pesquisa de itens de trabalho (ver orientações ligadas).
• Filtrar por data de alteração: filtre os itens de trabalho por quando foram alterados ou por um intervalo de datas específico.

Dicas para usar o editor de consultas

• Limite o escopo por intervalo de datas para melhorar o desempenho e retornar resultados relevantes.
• Use palavras completas ou frases exatas:
  • Palavras parciais podem não retornar resultados. Por exemplo, "comportamento reproduzível" corresponde, mas "repro" pode não corresponder.
  • Use curingas no final de palavras ou frases, como repro*.
• Esteja atento às palavras de paragem: palavras comuns podem ser ignoradas pela indexação de texto completo. Consulte as orientações vinculadas para configuração de palavras de parada.
• Execute e valide a sua consulta:
  • Selecione o ícone Executar na barra de ferramentas do editor de consultas para testar a consulta.
  • Se faltarem resultados, ajuste os termos e execute novamente.

Exibir o histórico de itens de trabalho

Uma entrada é acrescentada ao campo Histórico cada vez que você salva um item de trabalho. Para exibir o histórico, abra o item de trabalho e selecione a guia Histórico (ou Detalhes para alguns tipos de item de trabalho).

Os detalhes exatos do histórico variam de acordo com o cliente e a versão.

Campos que suportam histórico, auditoria e acompanhamento de revisões

Use esses campos para filtrar consultas e criar relatórios. Alguns campos são atualizados à medida que um item se move entre estados; outros são atualizados quando o item é modificado. Alguns campos não aparecem no formulário de item de trabalho, mas são rastreados para os WITs mostrados.

Notas de tabela

¹ Esses campos devem ser incluídos na seção de fluxo de trabalho (WORKFLOW) da definição WIT. Por exemplo, para definir automaticamente a Data de Resolução:

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