Consultar histórico de item de trabalho de consulta e campos de discussão

Azure DevOps Services | 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. Essas informações dão suporte à rastreabilidade e à 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 com suporte

• Operadores com suporte:

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

• Métodos de pesquisa:

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

• Pesquisa de texto completo: o campo Histórico é indexado para pesquisa de texto completo em que o serviço dá suporte a ele. (O Azure DevOps Services oferece a pesquisa de item de trabalho por padrão; o Azure DevOps Server localmente requer que o recurso de 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. Pesquisar o 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 que pode ser consultado: comentários inseridos na área discussão (Histórico).
• Conteúdo não acessível: metadados de revisão como "Campo X alterado de A para B" não são consultáveis por meio do campo Histórico.
• Métodos de pesquisa alternativos: para pesquisar palavras em campos rich-text (Descrição, etapas, discussão), use a pesquisa de item de trabalho (consulte as diretrizes vinculadas).
• Filtrar por data de alteração: filtrar itens de trabalho quando eles forem 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.
  • Use curingas no final das palavras ou frases, como repro*.
• Lembre-se das palavras de parada: palavras comuns podem ser ignoradas pela indexação de texto completo. Consulte a orientação relacionada para a configuração de stopwords.
• Execute e valide sua consulta:
  • Selecione o ícone de execução na barra de ferramentas do editor de consultas para testar a consulta.
  • Se os resultados estiverem ausentes, ajuste seus termos e rode novamente.

Exibir o histórico de itens de trabalho

Uma entrada acrescenta ao campo Histórico sempre 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 dão suporte ao histórico, auditoria e rastreio de revisões

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

Notas da tabela

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

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