Informazioni di riferimento sui metadati per Azure Boards Analitica

  • Articolo

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

Il servizio Analitica raccoglie tutte le attività di rilevamento del lavoro definite e aggiornate tramite Azure Boards. Analitica archivia come proprietà tutti i campi di rilevamento del lavoro, ad eccezione dei campi HTML/RTF e Cronologia. Le proprietà personalizzate per i campi personalizzati vengono aggiunte automaticamente a Analitica.

Questo articolo descrive la maggior parte delle proprietà che è possibile usare per generare un report Analitica per il rilevamento del lavoro. Si usa una combinazione di proprietà per filtrare una query, aggregare i dati o compilare un report. È possibile eseguire queste query direttamente nel browser. Per altre informazioni, vedere Definire query di base usando Analitica OData. Se non si ha familiarità con il rilevamento del lavoro e Azure Boards, è consigliabile consultare gli articoli seguenti:

Nota

Vengono fornite descrizioni delle entità, delle proprietà e dei tipi enumerati supportati dal modello di dati Analitica. Si tratta di una bozza anticipata. Inviare commenti e suggerimenti sulle aree in cui si vogliono avere altre informazioni. Per eseguire query sul modello di dati, vedere Costruire query OData per Analitica.

Panoramica dei set di entità

Quando si eseguono query su Analitica per i dati di rilevamento del lavoro, usare uno dei tipi di entità o dei set di entità seguenti.

  • Eseguire una query WorkItems per generare report di stato e rollup
  • Query WorkItemSnapshot per generare report di tendenza, burndown e burnup

Usare altri tipi di entità, ad esempio Area, ProjectIteration, , Teamo altre entità per filtrare i dati o selezionare le proprietà da segnalare. Per un riepilogo dei report di esempio, vedere Report di esempio e indice di riferimento rapido.

Nota

Per generare report sullo stato e sulle tendenze sui tipi di elemento di lavoro specifici del test, eseguire una query sui WorkItems tipi di entità e WorkItemSnapshot e filtrare in base al tipo di elemento di lavoro. Per informazioni sulle esecuzioni di test, i risultati dei test o altri dati di test, eseguire una query sui TestRunstipi di entità , TestPointsTestResultsDaily, TestSuite o TestPointHistorySnapshot . Per altre informazioni, vedere Informazioni di riferimento sui metadati di test per Azure DevOps.

EntitySet EntityType Descrizione
Aree Area Percorsi dell'area dell'elemento di lavoro, con proprietà per il raggruppamento e il filtro in base alla gerarchia di aree.
Date CalendarDate Date usate per filtrare e raggruppare altre entità usando relazioni.
Iterazioni Iterazione Percorsi di iterazione dell'elemento di lavoro, con proprietà per il raggruppamento e il filtro in base alla gerarchia di iterazione.
BoardLocations BoardLocation Le posizioni delle celle della lavagna, identificate dalla colonna di bordo, dalla corsia e dalla divisione, includono le impostazioni della tavola storica. Per una descrizione di ogni campo scheda, vedere Campi flusso di lavoro e scheda.
Processi Processo Informazioni sul backlog usate per espandere o filtrare gli elementi di lavoro e i tipi di elemento di lavoro. Per un esempio che usa Processi per filtrare un report, vedere Report di esempio di rilevamento dei requisiti. Supportato per Analitica versione 2.0 e successive.
Progetti Progetto Tutti i progetti definiti per un'organizzazione (cloud) o una raccolta di progetti (locale).
Tag Tag Tutti i tag degli elementi di lavoro per ogni progetto. Per un esempio che usa tag per filtrare un report, vedere Rilasciare un report di esempio di burndown.
Teams Team Tutti i team definiti per il progetto. Per un esempio che usa Teams per filtrare un report, vedere Aggiungere un filtro dei dati team a un report di Power BI.
Utenti Utente Informazioni utente utilizzate per espandere o filtrare varie proprietà dell'elemento di lavoro, ad esempio Assigned To, Created By.
WorkItemBoardSnapshot WorkItemBoardSnapshot (Composito) Stato di ogni elemento di lavoro in ogni data del calendario, inclusa la posizione della bacheca, utilizzata per generare report di tendenza. Per un report di esempio, vedere Il report di esempio del diagramma di flusso cumulativo (CFD).
WorkItemLinks WorkItemLink Collegamenti tra elementi di lavoro, ad esempio Child, Parent e Related. Include solo la revisione più recente dei collegamenti, nessuna cronologia. I collegamenti ipertestuali non sono inclusi.
WorkItemRevisions WorkItemRevision Tutte le revisioni degli elementi di lavoro cronologici, inclusa la revisione corrente. Non include elementi di lavoro eliminati.
WorkItemSnapshot WorkItemSnapshot (Composito) Stato di ogni elemento di lavoro in ogni data del calendario, utilizzato per supportare la creazione di report di tendenza. Per un report di esempio, vedere Report di esempio relativo alle tendenze dei bug.
WorkItems WorkItem Stato corrente degli elementi di lavoro. Usato per supportare i report di stato. Per un report di esempio, vedere Rollup child work item values to parent sample report .For a sample report, see Rollup child work item values to parent sample report.
WorkItemTypeFields WorkItemTypeField Proprietà dell'elemento di lavoro per ogni tipo di elemento di lavoro e processo. Usato per supportare la creazione di report.

Informazioni sugli snapshot

Esistono due set di entità snapshot di rilevamento del lavoro: WorkItemSnapshot e WorkItemBoardSnapshot.

Uno snapshot fornisce un record dei valori definiti per un elemento di lavoro ogni giorno. Il record viene scritto in Analitica una volta al giorno ogni giorno. Gli snapshot vengono usati quando si desidera generare un report di tendenza. Per impostazione predefinita, tutte le tabelle snapshot vengono modellate come tabelle dei fatti dello snapshot giornaliero. Se si esegue una query per un intervallo di tempo, si otterrà un valore per ogni giorno. Gli intervalli di tempo lunghi comportano un numero elevato di record. Se non è necessaria una precisione così elevata, è possibile usare snapshot settimanali o persino mensili.

Per altre informazioni, vedere Linee guida per le query OData, Usare snapshot settimanali o mensili per le query di tendenza che durano un lungo periodo di tempo.

Informazioni sulle revisioni degli elementi di lavoro

Ogni volta che si aggiorna un elemento di lavoro, il sistema crea una nuova revisione e registra questa azione nel System.RevisedDate campo, che rende utile specificare un filtro di cronologia. La data modificata è rappresentata dalle RevisedDate proprietà (DateTime) e RevisedDateSK (Int32). Per ottenere prestazioni ottimali, usare la chiave surrogata di quest'ultima data. Rappresenta la data in cui è stata creata una revisione o ha null per le revisioni attive o incomplete.

Se si desidera che tutte le date dall'inclusione {startDate} corrispondano, aggiungere il filtro seguente alla query.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Usare il WorkItemRevisions set di entità per caricare tutte le revisioni per un determinato elemento di lavoro. La query restituisce tutte le revisioni cronologiche degli elementi di lavoro, inclusa la revisione corrente, per gli elementi di lavoro filtrati. Non include elementi di lavoro eliminati.

Proprietà condivise tra diversi tipi di entità

Le proprietà che è possibile selezionare in una visualizzazione Analitica corrispondono ai normali campi di rilevamento del lavoro e selezionare Analitica proprietà, ad esempio Giorni di tempo ciclo e giorni di lead time. Queste proprietà, la maggior parte delle quali sono elencate e descritte nella tabella seguente, sono definite per i tipi di entità seguenti, se non diversamente specificato.

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Nota

Il servizio Analitica non archivia dati per i campi di testo lunghi assegnati al tipo di dati HTML o RTF. Sono inclusi i campi Descrizione e Cronologia . Analitica non archivia né i conteggi dei file collegati. Per un elenco completo dei campi definiti nei modelli di processo predefiniti, vedere Indice dei campi elemento di lavoro. Per le descrizioni di ogni tipo di dati, vedere Campi, operatori e macro di query.
Nella tabella seguente non sono incluse tutte le proprietà associate ai campi specifici del processo Scrum e CMMI. Per un elenco di questi campi, vedere Descrizioni dei campi per i campi predefiniti e degli elementi di lavoro usati nei modelli di processo, Campi usati per tenere traccia degli elementi di lavoro CMMI.

Molte proprietà sono basate su data o basate sull'utente. Queste proprietà sono associate ai set di entità CalendarDate e User descritti in Riferimento ai metadati calendar, Project e User.

Nome visualizzato
Property name		 Tipo di dati Descrizione
Reference name
Accettato da
Microsoft_VSTS_CodeReview_AcceptedBy		 UserSK Nome della persona che ha risposto a una revisione del codice. (processo CMMI)
Microsoft.VSTS.CodeReview.AcceptedBy
Data di accettazione
AcceptedDate		 Data/Ora Data e ora in cui la persona ha risposto alla revisione del codice. (processo CMMI)
Microsoft.VSTS.CodeReview.AcceptedDate
Attivato da
ActivatedBy
ActivatedByUserSK		 UserSK Nome del membro del team che ha attivato o riattivato l'elemento di lavoro.
Microsoft.VSTS.Common.ActivatedBy
Data di attivazione
ActivatedDate		 Data/Ora Data e ora in cui un membro del team ha attivato o riattivato un bug o un elemento di lavoro.
Microsoft.VSTS.CodeReview.ActivatedDate
Attività
Activity		 String Tipo di attività necessaria per eseguire un'attività.
Microsoft.VSTS.Common.Activity

Tipo di attività o disciplina assegnato a un'attività. I valori consentiti sono: Distribuzione, Progettazione, Sviluppo, Documentazione, Requisiti e Test. (Processo Agile, Scrum e Basic)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Dati e ora dell'ultimo aggiornamento dell'entità.
Tipo di applicazione String Tipo di applicazione su cui gli stakeholder forniranno commenti e suggerimenti. I valori predefiniti sono Applicazione Web, Computer remoto e Applicazione client. I tipi validi vengono specificati nel file di configurazione del processo per i progetti che usano un processo XML locale.
Microsoft_VSTS_Feedback_ApplicationType
Percorso area
AreaPath
AreaSK		 String Raggruppa gli elementi di lavoro nelle aree del prodotto o del team. L'area deve essere un nodo valido nella gerarchia del progetto.
System.AreaPath
Assegnato a
AssignedTo
AssignedToUserSK		 UserSK Nome del membro del team proprietario dell'elemento di lavoro.
System.AssignedTo
ID test automatizzato
AutomatedTestId		 String ID del test che automatizza il test case.
Microsoft.VSTS.TCM.AutomatedTestId
Nome test automatizzato
AutomatedTestName		 String Nome del membro del team che ha attivato o riattivato l'elemento di lavoro.
Microsoft.VSTS.TCM.AutomatedTestName
Archiviazione di test automatizzata
AutomatedTestStorage		 String Assembly contenente il test che automatizza il test case.
Microsoft.VSTS.TCM.AutomatedTestStorage
Tipo di test automatizzato
AutomatedTestType		 String Tipo di test che automatizza il test case.
Microsoft.VSTS.TCM.AutomatedTestType
Stato automazione
AutomatedStatus		 String Stato di un test case con i valori accettati seguenti: Automatizzato, Non automatizzato o Pianificato.
Microsoft.VSTS.TCM.AutomationStatus
Priorità backlog
BacklogPriority		 Double Numero assegnato da un processo in background di sistema usato per classificare o tenere traccia della sequenza di elementi in un backlog o una scheda. (Processo scrum)
Microsoft.VSTS.Common.BacklogPriority
Bloccati
Blocked		 String Indica che non è possibile eseguire ulteriori operazioni sull'elemento di lavoro. I valori validi sono Sì o No. (processo CMMI)
Microsoft.VSTS.CMMI.Blocked
Valore aziendale
BusinessValue		 Double Unità soggettiva di misura che acquisisce il valore aziendale relativo di un elemento o di una funzionalità del backlog del prodotto rispetto ad altri elementi dello stesso tipo. Un elemento assegnato a un numero maggiore deve essere considerato come avere un valore di business maggiore rispetto a un elemento assegnato a un numero inferiore.
Microsoft.VSTS.Common.BusinessValue
Modificato da
ChangedBy
ChangedByUserSK		 UserSK Nome della persona che ha modificato l'elemento di lavoro più di recente.
System.ChangedBy
Data modificata
ChangedDate		 Data/Ora Data e ora di modifica dell'elemento di lavoro.
System.ChangedDate
ChangedDateSK Int32 Data di modifica dell'elemento di lavoro, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione. Usato dagli strumenti esterni per unire entità correlate.
ChangedOn Navigazione Proprietà di navigazione all'entità Date per la data di modifica dell'elemento di lavoro, nel fuso orario definito per l'organizzazione. Comunemente usato per fare riferimento alle proprietà dell'entità Date nelle groupby istruzioni .
Chiuso da
ClosedBy
ClosedByUserSK		 UserSK Nome della persona che ha chiuso un elemento di lavoro.
Microsoft.VSTS.Common.ClosedBy
Data di chiusura
ClosedDate
ClosedDateSK
ClosedOn		 Data/Ora Data e ora di chiusura di un elemento di lavoro.
Microsoft.VSTS.Common.ClosedDate
Conteggio commenti
CommentCount		 Int32 Numero di commenti aggiunti alla sezione Discussione dell'elemento di lavoro.
System.CommentCount
Impegnato
Committed		 String Indica se il commit del requisito viene eseguito nel progetto. I valori validi sono Sì o No. (processo CMMI)
Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Data della proprietà di navigazione acquisita da Analitica che archivia quando l'elemento di lavoro ha immesso uno stato del flusso di lavoro associato alla categoria Stato flusso di lavoro Completato.
CompletedOn Navigazione Proprietà di navigazione all'entità Date per la data in cui l'elemento di lavoro ha immesso uno stato del flusso di lavoro associato alla categoria Stato flusso di lavoro completato, nel fuso orario definito per l'organizzazione. Comunemente usato per fare riferimento alle proprietà dell'entità Date nelle groupby istruzioni .
Lavoro completato
CompletedWork		 Double Misura della quantità di lavoro impiegato per un'attività.
Microsoft.VSTS.Scheduling.CompletedWork
Creata da
CreatedBy
CreatedByUserSK		 UserSK Nome della persona che ha creato l'elemento di lavoro.
Microsoft.VSTS.Common.CreatedBy
Data creazione
CreatedDate
CreatedDateSK		 Data/Ora Data di creazione dell'elemento di lavoro, espressa nel fuso orario definito per l'organizzazione. Comunemente usato per filtrare e per la visualizzazione.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Data di creazione dell'elemento di lavoro, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione. Usato dagli strumenti esterni per unire entità correlate.
CreatedOn Navigazione Proprietà di navigazione all'entità Date per la data di creazione dell'elemento di lavoro, nel fuso orario definito per l'organizzazione. Comunemente usato per fare riferimento alle proprietà dell'entità Date nelle groupby istruzioni .
Giorni di tempo ciclo
CycleTimeDays		 Double L'ora del ciclo viene calcolata dalla prima immissione di una categoria di stato In corso o Risolta per immettere una categoria Stato completato . Per altre informazioni, vedere Widget Lead Time e Cycle Time.
Disciplina
Discipline		 String Tipo di attività o disciplina assegnato a un'attività. I valori consentiti sono: Analysis*, Development, Test, User Education e User Experience. (processo CMMI)
Microsoft.VSTS.Common.Activity
Data di scadenza
DueDate		 Data/Ora Data di scadenza prevista entro la quale verrà risolto un problema o un elemento di lavoro. (Processo Agile)
Microsoft.VSTS.Scheduling.DueDate
Sforzo
Effort		 Double Una stima della quantità di lavoro necessaria per implementare un elemento di backlog del prodotto (processo Scrum) o un problema (processo di base).
Microsoft.VSTS.Scheduling.Effort
Data fine
FinishDate		 Data/Ora Data e ora in cui la pianificazione indica che un elemento di lavoro verrà completato.
Microsoft.VSTS.Scheduling.FinishDate
Trovato in
FoundIn		 String Numero di build del prodotto, noto anche come revisione, in cui è stato trovato un bug.
Microsoft.VSTS.Build.FoundIn
Data InProgress
InProgressDate		 Data/Ora Analitica data archiviata che acquisisce la data in cui un elemento di lavoro è stato spostato in uno stato appartenente alla categoria stato In corso.
InProgressDateSK Int32 Data in cui l'elemento di lavoro è stato spostato in uno stato appartenente alla categoria stato In corso, espresso come YYYYMMDD nel fuso orario definito per l'organizzazione. Usato dagli strumenti esterni per unire entità correlate.
Compilazione integrazione
IntegrationBuild		 String Numero di build del prodotto che incorpora il codice o corregge un bug.
Microsoft.VSTS.Build.IntegrationBuild
È corrente
IsCurrent		 Booleano Supporta il filtro dei dati per visualizzare lo snapshot più recente del set filtrato di elementi di lavoro impostando il valore su True.
Valido per questi tipi di entità: WorkItemRevision, WorkItemBoardSnapshote BoardLocation.
Ultima revisione del giorno
IsLastRevisionOfDay		 Booleano Indica che lo snapshot rappresenta l'ultima revisione del giorno in cui è impostata su True.
Ultima revisione del periodo
IsLastRevisionOfPeriod		 Booleano Indica che lo snapshot rappresenta l'ultima revisione del periodo quando è impostata su True.
Problema
Issue		 String Indica che il passaggio condiviso è associato a un risultato previsto. I valori consentiti sono Sì e No.
Microsoft.VSTS.Common.Issue
Giorni di lead time
LeadTimeDays		 Double Il lead time viene calcolato dalla creazione dell'elemento di lavoro o dall'immissione di una categoria Stato proposto per l'immissione di una categoria stato Completato . Per altre informazioni, vedere Widget Lead Time e Cycle Time.
Stima originale
OriginalEstimate		 Double Misura della quantità di lavoro necessaria per completare un'attività.
Microsoft.VSTS.Scheduling.OriginalEstimate
ID elemento di lavoro padre
ParentWorkItemId		 Int32 ID univoco che identifica l'elemento di lavoro collegato a come elemento padre. Utile per generare report di rollup. Il campo Padre è disponibile in Azure DevOps Server 2020 e versioni successive. Valido per questi tipi di entità: WorkItemRevision e WorkItem.
System.Parent
Priorità
Priority		 Int32 Valutazione soggettiva del bug, del problema, dell'attività o del test case in relazione all'azienda. I valori includono: - 1, 2 o 3.
Microsoft.VSTS.Common.Priority
Nome progetto
ProjectName		 Navigazione Nome del progetto a cui appartiene l'elemento di lavoro. Per informazioni dettagliate, vedere La data del calendario, il riferimento ai metadati di Project e user, Project properties.
System.TeamProject
ProjectSK GUID GUID assegnato al progetto a cui appartiene l'elemento di lavoro.
Rating
Reason		 String Numero di stelle ricevute da un revisore in un sistema di classificazione basato su stelle. (Risposta feedback) Il numero viene archiviato nel sistema e scritto come segue: - 0 - Non valutato, 1 - Povero, 2 - Fair, 3 - Buono, 4 - Molto buono e 5 - Eccellente. Valido per questi tipi di entità: WorkItemRevision e WorkItem.
Microsoft.VSTS.Common.Rating
Motivo
Reason		 String Motivo per cui l'elemento di lavoro è nello stato corrente. Ogni transizione da uno stato del flusso di lavoro a un altro è associata a un motivo corrispondente.
System.Reason
Lavoro rimanente
RemainingWork		 Double Misura della quantità di lavoro che rimane per completare un'attività.
Microsoft.VSTS.Scheduling.RemainingWork
Risolto da
ResolvedBy
ResolvedByUserSK		 UserSK Nome del membro del team che ha risolto il bug o la storia utente.
Microsoft.VSTS.Common.ResolvedBy
Data risolta
ResolvedDate		 Data/Ora Data e ora in cui è stato risolto il bug o la storia utente.
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Data in cui l'elemento di lavoro è stato risolto, espresso come YYYYMMDD nel fuso orario definito per l'organizzazione. Usato dagli strumenti esterni per unire entità correlate.
ResolvedOn Navigazione Proprietà di navigazione all'entità Date per la data in cui l'elemento di lavoro è stato risolto, nel fuso orario definito per l'organizzazione. Comunemente usato per fare riferimento alle proprietà dell'entità Date nelle groupby istruzioni .
Motivo risolto
ResolvedReason		 String Motivo per cui il bug è stato risolto (ad esempio, è stato risolto).
Microsoft.VSTS.Common.ResolvedReason
Revisione
Revision		 Int32 Numero assegnato alla revisione cronologica di un elemento di lavoro.
System.Rev
Data revisione
RevisedDate		 Data/Ora Data e ora in cui un elemento di lavoro è stato modificato o aggiornato.
RevisedDateSK Int32 Data di revisione dell'elemento di lavoro, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione. Usato dagli strumenti esterni per unire entità correlate.
RevisedOn Navigazione Proprietà di navigazione all'entità Date per la data di revisione dell'elemento di lavoro, nel fuso orario definito per l'organizzazione. Comunemente usato per fare riferimento alle proprietà dell'entità Date nelle groupby istruzioni .
Rischio
Risk		 Double Valutazione soggettiva dell'incertezza relativa sul completamento riuscito della storia utente. I valori validi includono: 1 - Alto, 2 - Medio e 3 - Basso.
Microsoft.VSTS.Common.Risk
Gravità
Severity		 Double Classificazione soggettiva dell'effetto di un bug, un problema o un rischio per il progetto. I valori validi includono: 1 - Critico, 2 - Alto, 3 - Medio e 4 - Basso.
Microsoft.VSTS.Common.Severity
Dimensione
Size		 Double Stima della quantità di lavoro necessaria per implementare un requisito (processo CMMI).
Microsoft.VSTS.Scheduling.Size
Stack Rank
StackRank		 Double Numero assegnato da un processo in background di sistema usato per classificare o tenere traccia della sequenza di elementi in un backlog o una scheda. (Processi Agile, Scrum e Basic)
Microsoft.VSTS.Common.StackRank
Data di inizio
StartDate		 Data/Ora Data e ora assegnate a un elemento di lavoro per l'avvio del lavoro.
Microsoft.VSTS.Scheduling.StartDate
Stato
State		 String Stato corrente dell'elemento di lavoro. I valori validi per lo stato sono specifici di ogni tipo di elemento di lavoro e personalizzazioni apportate.
System.State
Categoria Stato
StateCategory		 String Le categorie di stato determinano il modo in cui Azure Boards e seleziona i widget del dashboard gestiscono ogni stato del flusso di lavoro. Le categorie di stato in uso includono: Proposta, In corso, Risolta, Rimossa e Completata. Per altre informazioni, vedere Come usare gli stati del flusso di lavoro e le categorie di stato. Valido solo per il WorkItemRevision tipo di entità.
Data modifica stato
StateChangeDate		 Data/Ora Data e ora di modifica del valore del campo Stato .
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Data di modifica dello stato per un elemento di lavoro, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione. Usato dagli strumenti esterni per unire entità correlate.
StateChangeOn Navigazione Proprietà di navigazione all'entità Date per la data di modifica dello stato per un elemento di lavoro, nel fuso orario definito per l'organizzazione. Comunemente usato per fare riferimento alle proprietà dell'entità Date nelle groupby istruzioni .
Punti storia
StoryPoints		 Double Stima della quantità di lavoro richiesta da un brano utente (processo Agile) da implementare, comunemente aggregato come somma.
Microsoft.VSTS.Scheduling.StoryPoints
Tag
TagNames		 String Elenco delimitato da punto e virgola di tag assegnati a uno o più elementi di lavoro ai fini del filtro o dell'esecuzione di query.
System.Tags
Data di destinazione
TargetDate		 Data/Ora Data di scadenza prevista entro la quale verrà risolto o completato un problema o un altro elemento di lavoro.
Microsoft.VSTS.Scheduling.TargetDate
Tipo di gruppo di test String Specifica il tipo di gruppo di test. I valori validi includono: Basato su query, Basato sui requisiti e Statico.
Microsoft_VSTS_TCM_TestSuiteType
ID tipo gruppo di test Int64 Numero assegnato dal sistema che corrisponde alla categoria del gruppo di test e applicabile solo ai gruppi di test. I valori assegnati sono: 1 (statico), 2 (basato su query) e 3 (basato sui requisiti).
Microsoft_VSTS_TCM_TestSuiteTypeId
Criticità temporale
TimeCriticality		 Double Unità soggettiva di misura che acquisisce il modo in cui il valore aziendale diminuisce nel tempo. I valori più alti indicano che l'epica o la funzionalità è intrinsecamente più critica del tempo rispetto a quelli con valori inferiori.
Microsoft.VSTS.Common.TimeCriticality
Title
Title		 String Breve descrizione che riepiloga l'elemento di lavoro e aiuta i membri del team a distinguerlo da altri elementi di lavoro in un elenco.
System.Title
Area valore
ValueArea		 String Area del valore del cliente indirizzato dall'elemento epico, della funzionalità o del backlog. I valori includono: Architettura o Business.
Microsoft.VSTS.Common.ValueArea
Filigrana
Watermark		 String Campo gestito dal sistema che viene incrementato con le modifiche apportate a un elemento di lavoro. Valido per questi tipi di entità: WorkItemRevision e WorkItem.
System.Watermark
ID elemento di lavoro
WorkItemId		 Int32 Identificatore univoco assegnato a un elemento di lavoro. Gli ID elemento di lavoro sono univoci in tutti i progetti e all'interno di un'organizzazione o di una raccolta di progetti.
System.Id
WorkItemRevisionSK Int32 Chiave univoca Analitica per la revisione dell'elemento di lavoro usata dagli strumenti esterni per unire entità correlate.
Tipo di elemento di lavoro
WorkItemType		 String Nome del tipo di elemento di lavoro. I tipi di elemento di lavoro vengono definiti in base al processo usato durante la creazione del progetto. Per altre informazioni, vedere Informazioni sui processi e sui modelli di processo.
System.WorkItemType

Le proprietà di navigazione in OData sono gli attributi di riferimento di un'entità che punta a un'altra entità. Nella tabella seguente viene fornito un riepilogo delle proprietà di navigazione, dei relativi vincoli referenziale e dei tipi di entità per i quali sono validi.

Nome visualizzato Nome
Vincolo referenziale e proprietà		 Valido per i tipi di entità
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ClosedOn
ClosedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
CreatedOn
CreatedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedOn
ResolvedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
StateChangeOn
StateChangeDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
InProgressOn
InProgressDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
CompletedOn
CompletedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
RevisedOn
RevisedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot
Date
DateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Aree Area
AreaSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
BoardLocation WorkItemRevision, WorkItem, WorkItemBoardSnapshot
Iterazioni Iteration
IterationSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
Assegnato a AssignedTo
AssignedToUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
Modificato da ChangedBy
ChangedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
Creata da CreatedBy
CreatedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
Attivato da ActivatedBy
ActivatedByUserSK, UserSK		 WorkItemRevision,WorkItem , WorkItemSnapshot, WorkItemBoardSnapshot
Chiuso da ClosedBy
ClosedBySK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshotWorkItemBoardSnapshot
ResolvedBy ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Teams Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshotWorkItemBoardSnapshot
Tag WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Progetto Project
ProjectSK, ProjectSK		 Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevisionWorkItemSnapshot, , WorkItemTypeField
Processi WorkItemRevision, WorkItem, WorkItemSnapshot
Revisioni WorkItem
Collegamenti WorkItem
Children WorkItem
Parent WorkItem
Descendants WorkItem
WorkItem WorkItemId WorkItemRevision

Stimare le funzioni

Per l'entità WorkItem sono supportate le due funzioni seguenti. Queste funzioni vengono usate per supportare le tendenze predittive su Analitica report e widget predefiniti.

  • PredictTags
  • Predict

BoardLocation e WorkItemBoardSnapshot

Le proprietà elencate e descritte nella tabella seguente sono definite per i tipi di entità seguenti, a meno che non siano specificate in modo specifico. Con questi campi, è possibile filtrare i dati degli elementi di lavoro in base allo stato di un elemento di lavoro all'interno della colonna della lavagna, della corsia o del backlog di un team.

  • BoardLocation
  • WorkItemBoardSnapshot

Per un esempio che esegue una query sul WorkItemBoardSnapshot set di entità, vedere Il report di esempio Diagramma di flusso cumulativo (CFD).

Nome visualizzato
Property name		 Tipo di dati Descrizione
Reference name
ID scheda
BoardId		 GUID GUID univoco assegnato a una scheda. Ogni team è associato a una o più bacheche.
Nome riferimento categoria scheda
BoardCategoryReferenceName		 String Nome assegnato alla categoria dei tipi di elemento di lavoro usati per popolare una scheda. Ad esempio, la scheda backlog del prodotto è associata alla categoria Requisiti. Per altre informazioni, vedere Personalizzare i backlog o le bacheche (processo di ereditarietà).
Nome scheda
BoardName		 String Nome assegnato alla scheda. Ad esempio, Storie, Elementi backlog, Funzionalità ed Epiche.
Livello scheda
BoardLevel		 Int32 Numero assegnato alla lavagna in base alla posizione all'interno della gerarchia delle schede.
Tipo backlog
BacklogType		 String Nome del tipo di backlog. Ad esempio, Iterazione, Requisito o Portfolio.
Nome colonna
ColumnName		 String Nome della colonna della scheda a cui è attualmente assegnato un elemento di lavoro, ad esempio Active, Closed, Committed, Done o un'altra etichetta di colonna personalizzata.
System.BoardColumn
Ordine colonne
ColumnOrder		 Int32 Numero assegnato alla colonna della scheda in termini di sequenza all'interno della scheda.
Completato
Done		 Enumerated Indica la posizione della colonna divisa. I valori validi sono elencati di seguito per BoardColumnSplit.
Limite di elementi di colonna
ColumnItemLimit		 Int32 Numero assegnato alla colonna della scheda in termini di sequenza.
Scheda visibile
IsBoardVisible		 Booleano Indica se il team ha scelto di rendere visibile o meno una bacheca.
Suddivisione colonna
IsColumnSplit		 Booleano Indica se una colonna è stata suddivisa in colonne In corso e Fine , come descritto in Dividere le colonne nella scheda per visualizzare il lavoro in corso.
È corrente
IsCurrent		 Booleano Proprietà che supporta il filtro dei dati per visualizzare lo snapshot più recente del set filtrato di elementi di lavoro impostando il valore su True.
Corsia predefinita
IsDefaultLane		 Booleano Proprietà che indica che l'elemento di lavoro viene assegnato alla corsia predefinita (True) o meno (False).
Operazione completata
IsDone		 Booleano Assegnazione corrente dell'elemento di lavoro a In corso (False) o Done (True) all'interno di una colonna. Assegnato solo quando le colonne suddivise sono abilitate per una colonna della scheda.
System.BoardColumnDone
ID corsia
LaneId		 GUID GUID univoco assegnato a una corsia da bagno a bordo. Ogni squadra può aggiungere una o più corsie di nuoto a una tavola. Per altre informazioni sulle corsie, vedi Velocizzare il lavoro della squadra usando le corsie a bordo.
Nome corsia
LaneName		 String Nome assegnato alla corsia di bordo.
System.BoardLane
Ordine corsia
LaneOrder		 Int32 Numero assegnato alla corsia a bordo in termini di sequenza.

Membri enumerati BoardColumnSplit

Nella tabella seguente sono elencati i nomi dei membri per il BoardColumnSplit tipo enumerato, che può essere usato per filtrare in base agli elementi di lavoro nella colonna Della scheda In corso o Completato .

Nome del membro valore Nome visualizzato
Doing 0 In corso
Done 1 Fatto
Unknown 2 Sconosciuto (non diviso)

Per altre informazioni sulle colonne della scheda per un team, vedere gli articoli seguenti:

Aree

Le proprietà seguenti sono valide per il set di entità Areas , associato al campo Percorso area. Le chiavi surrogate associate all'area includono AreaSK e ProjectSK. È possibile usare queste proprietà per filtrare o creare report sui dati di rilevamento del lavoro in base alle assegnazioni di percorso di area.

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Filigrana che indica l'ultima volta che i dati Analitica sono stati aggiornati.
Number Int32 Valore intero assegnato a un nodo Percorso area al momento della creazione.
Livello di annidamento Depth Int32 Livello in base al quale il percorso area viene definito in base alla profondità dal livello radice.
Area Id AreaId GUID Identificatore univoco assegnato a un percorso di area al momento della creazione.
Livello di area da 1 a
Livello area 14		 AreaLevel1 attraverso
AreaLevel14		 String Nome associato al livello del nodo di un percorso di area. Sono supportati fino a 14 livelli annidati. Ad esempio, il livello di area 1 corrisponde sempre al nodo radice e al nome del progetto.
Nome area AreaName String Nome definito per il percorso area al momento della creazione.
Percorso area AreaPath String Percorso completo del percorso area che inizia con il nodo radice.

Importante

  • L'eliminazione di percorsi di area o la riconfigurazione dei percorsi di iterazione causa una perdita irreversibile dei dati. Ad esempio, i grafici dei widget burndown e burnup, il burndown sprint e i grafici di velocità per i team con percorsi di area modificati non visualizzerà dati accurati. I grafici di tendenza cronologici fanno riferimento al percorso area e al percorso di iterazione, così come sono stati definiti al momento per ogni elemento di lavoro. Dopo l'eliminazione, non è possibile recuperare i dati cronologici per questi percorsi.
  • È possibile eliminare solo percorsi di area e iterazione non più utilizzati da elementi di lavoro.

Le proprietà di navigazione per il tipo di entità Area e il set di entità Aree includono Project e Teams.

Per altre informazioni sui percorsi di area, vedere gli articoli seguenti:

Iterazioni

Le proprietà seguenti sono valide per il set di entità Iterazioni , associato al campo Percorso iterazione. Le chiavi surrogate associate all'iterazione includono IterationSK e ProjectSK. È possibile usare queste proprietà per filtrare o creare report sui dati di rilevamento del lavoro in base alle assegnazioni percorso di iterazione.

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Filigrana che indica l'ultima volta che i dati Analitica sono stati aggiornati.
Number Int32 Valore intero assegnato a un nodo Percorso di iterazione al momento della creazione.
Livello di annidamento Depth Int32 Livello in base al quale viene definito il percorso di iterazione in base alla profondità del livello radice.
Data di fine EndDate Data/Ora Data di fine definita per il percorso di iterazione.
IsEnded IsEnded Booleano Se impostato su True, indica che la data di fine del percorso di iterazione è precedente.
ID iterazione IterationId GUID Identificatore univoco assegnato a un percorso di iterazione al momento della creazione.
Livello di iterazione da 1 a
Livello di iterazione 14		 IterationLevel1 attraverso
IterationLevel14		 String Nome associato al livello del nodo di un percorso di iterazione. Sono supportati fino a 14 livelli annidati. Ad esempio, il livello di iterazione 1 corrisponde sempre al nodo radice e al nome del progetto.
Nome iterazione IterationName String Nome definito per un percorso di iterazione al momento della creazione.
Percorso iterazione IterationPath String Percorso completo del percorso di iterazione a partire dal nodo radice. L'iterazione deve essere un nodo valido nella gerarchia del progetto.
System.IterationPath
Data di inizio StartDate Data/Ora Data di inizio definita per il percorso di iterazione.

Importante

  • L'eliminazione di percorsi di area o la riconfigurazione dei percorsi di iterazione causa una perdita irreversibile dei dati. Ad esempio, i grafici dei widget burndown e burnup, il burndown sprint e i grafici di velocità per i team con percorsi di area modificati non visualizzerà dati accurati. I grafici di tendenza cronologici fanno riferimento al percorso area e al percorso di iterazione, così come sono stati definiti al momento per ogni elemento di lavoro. Dopo l'eliminazione, non è possibile recuperare i dati cronologici per questi percorsi.
  • È possibile eliminare solo percorsi di area e iterazione non più utilizzati da elementi di lavoro.

Le proprietà di navigazione per il tipo di entità iterazione e il set di entità iterazioni includono Project e Teams.

Per altre informazioni sui percorsi di iterazione, vedere gli articoli seguenti:

Processi

Le proprietà seguenti sono valide per il tipo di entità Process e il set di entità Processi . Le chiavi surrogate associate al processo includono ProcessSK, ProjectSKe TeamSK. È possibile usare queste proprietà per filtrare o creare report sui dati di rilevamento del lavoro in base ai tipi di elemento di lavoro usati da un progetto o da un team.

Nota

Il tipo di entità Process e il set di entità Processi sono supportati con le versioni v-2.0, v3.0-preview e v4.0-preview di Analitica.

È possibile usare queste proprietà per filtrare i dati di rilevamento del lavoro in base a un livello di backlog

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Filigrana che indica l'ultima volta che i dati Analitica sono stati aggiornati.
ProjectSK GUID Chiave di progetto associata al processo.
TeamSK GUID Chiave del team associata al processo.
Nome riferimento categoria backlog BacklogCategoryReferenceName String Nome del riferimento di categoria assegnato al backlog associato al tipo di elemento di lavoro. Gli esempi includono Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, Microsoft.TaskCategory.
Nome backlog BacklogName Booleano Nome di riferimento assegnato al backlog associato al tipo di elemento di lavoro
Tipo backlog BacklogType GUID Identificatore univoco assegnato a un percorso di iterazione al momento della creazione.
Livello backlog BacklogLevel String Specifica il livello di backlog associato al tipo di elemento di lavoro. Se il tipo di elemento di lavoro non è associato a un livello di backlog, il valore restituito è null.
Tipo di elemento di lavoro WorkItemType String Nome definito per un tipo di elemento di lavoro.
Has Backlog HasBacklog String Indica se il tipo di elemento di lavoro appartiene a un backlog.
Tipo nascosto IsHiddenType Booleano Indica se il tipo di elemento di lavoro è stato disabilitato.
Tipo di bug IsBugType Booleano Indica se il tipo di elemento di lavoro appartiene alla categoria Bug.
Eliminazione IsDeleted Booleano Indica se il tipo di elemento di lavoro è stato eliminato.

Per altre informazioni sui backlog di elaborazione e sui tipi di elemento di lavoro, vedere gli articoli seguenti:

Tipi di elementi di lavoro personalizzati e categorie di backlog personalizzate

I dati per i tipi di elementi di lavoro personalizzati vengono aggiunti automaticamente al servizio Analitica.

Una categoria personalizzata viene creata quando vengono definiti un tipo di elemento di lavoro personalizzato e un livello di backlog. Custom_ è preceduto dal GUID della categoria. Ad esempio, per il tipo di elemento di lavoro personalizzato Portfolio con un backlog Portfolios , un GUID viene assegnato alla categoria personalizzata, ad esempio Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

Tag

Le proprietà seguenti sono valide per il set di entità Tags . Le chiavi surrogate associate al tag includono TagSK e ProjectSK. Le proprietà di navigazione includono Project e il relativo vincolo ProjectSKreferenziale . Per altre informazioni sull'uso dei tag, vedere Aggiungere tag di elementi di lavoro per classificare e filtrare elenchi e bacheche.

È possibile usare queste proprietà per filtrare o creare report sui dati di rilevamento del lavoro.

Nome visualizzato Nome Tipo di dati Descrizione
Tag Id TagId GUID ID univoco assegnato al tag al momento della creazione.
Nome tag TagName String Nome tag.

Teams

Le proprietà seguenti sono valide per il tipo di entità Team e il set di entità Teams. Le chiavi surrogate associate al team includono TeamSK e ProjectSK. È possibile usare queste proprietà per filtrare o creare report sui dati di rilevamento del lavoro in base alle assegnazioni del team. Per informazioni sull'uso e l'aggiunta di team, vedere Informazioni sui team e sugli strumenti Agile e Creare o aggiungere un team.

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Filigrana che indica l'ultima volta che i dati Analitica sono stati aggiornati.
Team Id TeamId GUID ID univoco assegnato al team al momento della creazione.
Nome team TeamName String Nome del team.

Le proprietà di navigazione per il set di entità di Teams includono Projects, Arease Iterations.

Le proprietà seguenti sono valide per il set di entità WorkItemLinks . La chiave surrogata di riferimento alla proprietà è WorkItemLinkSK. Eseguire query su WorkItemLinks per creare report su padre/figlio, correlato, predecessore/successore o altri tipi di collegamento.

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Filigrana che indica l'ultima volta che i dati Analitica sono stati aggiornati.
WorkItemLinkSK Int32 Chiave surrogata assegnata all'entità WorkItemLink .
Data creazione CreatedDate GUID Data di creazione del collegamento.
Commento Comment String Commento aggiunto al momento della creazione del collegamento.
Data eliminata DeletedDate String Data di eliminazione del collegamento.
ID tipo di collegamento LinkTypeId Int32 ID assegnato all'elemento di lavoro di destinazione collegato.
Nome tipo di collegamento LinkTypeName String Nome descrittivo assegnato al tipo di collegamento.
Nome riferimento tipo collegamento LinkTypeReferenceName String Nome di riferimento assegnato al tipo di collegamento.
Il tipo di collegamento è aciclico LinkTypeIsAcyclic Booleano Il valore dell'attributo del tipo di collegamento che indica che il tipo di collegamento consente relazioni circolari quando il valore è impostato su True. Ad esempio, i collegamenti di tipo albero limitano le relazioni circolari.
Il tipo di collegamento è direzionale LinkTypeIsDirectional Booleano Il valore dell'attributo del tipo di collegamento che indica che il tipo di collegamento è direzionale. I tipi di collegamento direzionale vengono definiti in coppia con un componente in avanti e inverso.
ID elemento di lavoro di origine SourceWorkItemId Int32 ID assegnato all'elemento di lavoro di origine collegato.
ID elemento di lavoro di destinazione TargetWorkItemId Int32 ID assegnato all'elemento di lavoro di destinazione collegato.

Le proprietà di navigazione per il tipo di entità WorkItemLink includono Projects, SourceWorkIteme TargetWorkItem.

Per altre informazioni sui collegamenti e sui tipi di collegamento, vedere gli articoli seguenti:

WorkItemTypeFields

Le proprietà seguenti sono valide per il set di entità WorkItemTypeFields . Le chiavi di riferimento delle proprietà sono FieldName, ProjectSKe WorkItemType.

Nome visualizzato Nome Tipo di dati Descrizione
Nome campo FieldName String Nome descrittivo assegnato a un campo dal sistema o quando viene creato.
Nome riferimento campo FieldReferenceName String Nome di riferimento assegnato a un campo dal sistema o quando viene creato un campo personalizzato.
Tipo di campo FieldType String Tipo di dati assegnato a un campo.
Tipo di elemento di lavoro WorkItemType String Nome dei tipi di elemento di lavoro per cui è definito un campo.

Le proprietà di navigazione includono Project.

Per un indice di tutti i campi definiti per un progetto, vedere Descrizioni dei campi per gli elementi di lavoro. Per ulteriori informazioni, vedi gli articoli seguenti:

Custom properties

I campi personalizzati vengono aggiunti automaticamente al servizio Analitica come proprietà personalizzata. Custom_ oppure Custom. viene anteporto al nome della proprietà. Controllare i metadati della raccolta come descritto in Costruire query OData per Analitica, componenti URL per eseguire query sui metadati. Nell'esempio seguente viene fornita la sintassi dei metadati per il campo personalizzato, Opportunità di rischio.

<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>