Eseguire query sulla cronologia degli elementi di lavoro e sui campi di discussione in Azure Boards

  • Articolo

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

La cronologia di un elemento di lavoro indica chi ha aperto l'elemento, cosa è cambiato e perché. Queste informazioni consentono di tenere traccia delle modifiche apportate a un elemento nel tempo. Quando si immettono informazioni nel campo della cronologia, fornire il maggior numero possibile di informazioni per aiutare il proprietario dell'elemento di lavoro successivo a comprendere cosa è successo e cosa devono fare.

Nota

Non esiste alcun campo Discussione per gli elementi di lavoro. Per eseguire query sugli elementi di lavoro con i commenti immessi nell'area Discussione, filtrare il campo Cronologia . Il contenuto completo del testo immesso nella casella di testo Discussione viene aggiunto al campo Cronologia.

Operatori e macro supportati

Le clausole di query che specificano il campo Cronologia possono utilizzare gli operatori Contains Words e Does Not Contain Words. Eseguire una ricerca in base a una frase esatta o usare il carattere jolly * . È possibile usare il carattere jolly solo alla fine di una parola o di una frase parziale.

Il campo Cronologia viene indicizzato automaticamente per la ricerca full-text quando è disponibile la ricerca full-text. Vedere Ricerche full-text e parziali di parole

Eseguire query sulla cronologia di un elemento di lavoro

È possibile usare il portale Web o Team Explorer per visualizzare la cronologia di un elemento di lavoro o trovare elementi di lavoro in base al contenuto del campo Cronologia . Quando si esegue una ricerca sul contenuto del campo Cronologia , vengono restituiti solo gli elementi di lavoro con modifiche registrate in tale campo. Ovvero, non registra le modifiche apportate al testo in altri campi.

Screenshot di Editor di query per cercare elementi in base alle parole contenute nel campo Cronologia.

Elencare gli elementi in base al contenuto del campo Cronologia

Usare l'editor di query per aggiungere il campo Cronologia a una clausola di query. I commenti immessi nell'area Discussione sono querybili. Le voci della cronologia delle modifiche, ad esempio i campi modificati, non possono essere eseguite query. Per trovare rapidamente elementi in base alle parole immesse nell'area Discussione o Descrizione o ad altri campi RTF, è consigliabile usare la ricerca degli elementi di lavoro.

È possibile filtrare gli elementi di lavoro in base alla data in cui sono stati modificati o per un periodo di tempo specifico. Se si limita l'ambito della query, può contribuire alle prestazioni restituendo solo i risultati che soddisfano l'intervallo di date che si desidera includere.

Filtro per

Includere queste clausole di query

Elementi il cui campo Cronologia contiene la parola "riproducibile"

History Contains Words reproducible

Elementi il cui campo Cronologia non contiene la parola "beta"

History Does Not Contain Words beta

Elementi che contengono la frase "analisi dello stack" e sono stati chiusi ma riattivati

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

Elementi chiusi entro un periodo di tempo specificato

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

Elementi a cui sono stati associati

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

Suggerimenti per l'uso dell'editor di query

  • Immettere la parola o la frase completa specificata nel campo Cronologia di tali elementi di lavoro che si desidera trovare.
  • Immettere il testo completo per la parola che si desidera cercare. Il campo Cronologia viene indicizzato per la ricerca full-text. Se si immette solo una parola parziale, la query non restituirà elementi di lavoro che contengono la parola completa. Ad esempio, se il campo Cronologia contiene il comportamento riproducibile della frase e si cerca di riprovare, l'elemento di lavoro non verrà trovato. Tuttavia, se si cerca la parola completa riproducibile, è possibile trovare l'elemento di lavoro. È anche possibile cercare la stringa con un carattere jolly, ad esempio repro*.
  • L'editor di query ignora parole comuni o parole non significative, come definito in Configurare e gestire parole non significative e parole non significative per la ricerca full-text.
  • Sulla barra degli strumenti dell'editor di query scegliere Esegui query o Eseguire query, versione precedente icona e verificare che la query restituisca i risultati previsti.
  • Se non si ricevono i risultati previsti, modificare la parola o la frase immessa ed eseguire di nuovo la query.

Visualizzare la cronologia degli elementi di lavoro

Viene effettuata una voce nel campo Cronologia ogni volta che viene salvato un elemento di lavoro. Per visualizzare la cronologia delle modifiche, aprire un elemento di lavoro esistente e quindi scegliere la icona della scheda cronologia scheda o Cronologia o per alcuni tipi di elemento di lavoro, scegliere la scheda Dettagli .

I dettagli della cronologia visualizzati dipendono dalla piattaforma, dalla versione e dal client.

Screenshot del modulo Elemento di lavoro, portale Web, scheda Scegli cronologia.

Il diagramma della cronologia delle modifiche di stato viene visualizzato per primo. Per visualizzare l'intera cronologia delle modifiche dello stato, scegliere Mostra tutto.

Screenshot del modulo elemento di lavoro, del portale Web, del diagramma cronologia modifiche stato (solo portale Web).

Scegliere una voce nel riquadro sinistro per visualizzare i dettagli delle modifiche apportate.

Screenshot del modulo Elemento di lavoro, della scheda Cronologia, del portale Web, dei dettagli.

Filtrare la visualizzazione cronologia

La scheda Cronologia è progettata per tenere traccia di tutte le modifiche apportate a un elemento di lavoro per supportare la tracciabilità completa. La lunga cronologia delle revisioni che i risultati possono rendere difficile comprendere quando si verificano modifiche a campi specifici. Per trovare rapidamente le revisioni apportate a un campo specifico o a persone specifiche, filtrare la visualizzazione cronologia.

Nota

La funzionalità di filtro Attiva/Disattiva richiede di abilitare la funzionalità di anteprima di New Boards Hub . Per abilitare questa funzionalità, vedere Gestire o abilitare le funzionalità.

Per abilitare la funzionalità di filtro, scegliere Attiva/Disattiva filtro.

Screenshot del modulo Elemento di lavoro, della scheda Cronologia, del portale Web, del filtro cronologia abilitato.

Per esaminare gli aggiornamenti in base a persone specifiche, selezionare i nomi dal menu Aggiornato per .

Screenshot del modulo Elemento di lavoro, scheda Cronologia, Filtro in base a chi ha eseguito gli aggiornamenti.

Per esaminare gli aggiornamenti eseguiti in uno o più campi, selezionare i campi dal menu Campi .

Screenshot del modulo Elemento di lavoro, scheda Cronologia, Filtro per le modifiche apportate al campo Assegnato a.

Campi che supportano la cronologia, il controllo e il rilevamento delle revisioni

È possibile usare i campi seguenti per filtrare le query e creare report. Molti di questi campi vengono popolati con informazioni come avanzamento di un elemento di lavoro da uno stato a un altro. Gli altri campi vengono aggiornati quando l'elemento di lavoro viene modificato. Alcuni campi non vengono visualizzati nel modulo dell'elemento di lavoro, ma vengono rilevati per le connessioni WIT elencate.

Nome campo

Descrizione

Tipo di elemento di lavoro

Modificato da

Nome del membro del team che ha modificato l'elemento di lavoro più di recente.

Reference name=System.ChangedBy, Data type=String

Tutte le date

Modifica data

Data e ora di modifica di un elemento di lavoro.

Reference name=System.ChangedDate, Data type=DateTime

Tutte le date

Data di chiusura 1

Data e ora di chiusura di un elemento di lavoro.
Nome di riferimento=Microsoft.VSTS.Common.ClosedDate, Tipo di dati=DateTime

Tutte le date

Data creazione

Data e ora di creazione di un elemento di lavoro.

Reference name=System.CreatedDate, Data type=DateTime

Tutte le date

Cronologia

Record delle modifiche apportate all'elemento di lavoro dopo la creazione. Ogni volta che l'elemento di lavoro viene aggiornato, le informazioni vengono aggiunte alla cronologia, che specifica la data della modifica, chi ha apportato le modifiche e quali campi sono stati modificati.

Nota

Le query sui campi cronologia restituiscono elementi di lavoro i cui campi Commenti di discussione o Descrizione contengono parole che corrispondono alle parole chiave immesse. Non è possibile usare il campo Cronologia per eseguire query sulle modifiche apportate ad altri campi.

Non è possibile aggiungere testo formattato al campo della cronologia. Dopo aver salvato l'elemento di lavoro, non è possibile modificare la cronologia.
Il History campo, insieme ai Descriptioncampi , Steps to Repro e Title vengono indicizzati automaticamente per la ricerca full-text, come descritto in Campi di query, operatori e macro.

Reference name=System.History, Data type=History

Tutte le date

Data risolta 1

Data e ora di spostamento dell'elemento di lavoro in uno stato risolto.

Nome di riferimento=Microsoft.VSTS.Common.ResolvedDate, Tipo di dati=DateTime

Bug (Agile, CMMI)

Rev

Numero assegnato alla revisione cronologica di un elemento di lavoro.

Nota

Un limite di revisione dell'elemento di lavoro di 10.000 è attivo per gli aggiornamenti eseguiti tramite l'API REST per Azure DevOps Services. Questo limite limita gli aggiornamenti dall'API REST, ma gli aggiornamenti dal portale Web non sono interessati.

Reference name=System.Rev, Data type=Integer

Tutte le date

Data revisione

Data e ora in cui un elemento di lavoro è stato modificato o modificato.

Reference name=System.RevisedDate, Data type=DateTime

Parametro condiviso, passaggio condiviso, test case

Data modifica stato

Data e ora di modifica del valore del campo Stato.

Nome di riferimento=Microsoft.VSTS.Common.StateChangeDate, Tipo di dati=DateTime

Tutte le date

Test Suite Audit

Tiene traccia di altre operazioni eseguite durante la modifica di un gruppo di test, ad esempio l'aggiunta di test a un gruppo di test o la modifica delle configurazioni. Questo campo può essere visualizzato tramite la scheda Cronologia o tramite una query separata. È disponibile una visualizzazione cronologia consolidata, incluse le modifiche apportate al campo degli elementi di lavoro e le modifiche risultanti da elementi correlati, ad esempio punti di test e configurazioni.
Nome di riferimento=Microsoft.VSTS.TCM.TestSuiteAudit, Data type=PlainText

Gruppo di test

Filigrana

Campo gestito dal sistema (non modificabile) che viene incrementato con le modifiche apportate a un elemento di lavoro.
Reference name=System.Watermark, Data type=Integer

Tutte le date

Nota

  1. Affinché questi campi vengano definiti per un WIT, devono essere inclusi nella WORKFLOW sezione della definizione del WIT. Ad esempio, questa sintassi viene inclusa nella definizione durante la FIELDS transizione a uno stato risolto:

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

REST API

Per interagire a livello di codice con le query, vedere una delle risorse dell'API REST seguenti: