Modello di dati per Analytics

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

Il modello di dati di Analisi per Azure DevOps è costituito da set di entità, i cui membri (entità) contengono proprietà che possono essere filtrate, aggregate e riepilogate. Inoltre, contengono proprietà di navigazione che riguardano le entità tra loro, fornendo l'accesso ad altre proprietà per la selezione, il filtro e il raggruppamento.

Nota

Il servizio Analytics viene abilitato automaticamente e supportato nell'ambiente di produzione per tutti i Azure DevOps Services. L'integrazione di Power BI e l'accesso al feed OData del servizio Analisi sono disponibili a livello generale. Ti invitiamo a usarlo e a inviare commenti e suggerimenti. I dati disponibili dipendono dalla versione. La versione supportata più recente è v2.0e la versione di anteprima più recente è v4.0-preview. Per altre informazioni, vedere Controllo delle versioni delle API OData.

Spazi dei nomi dello schema

Il modello di dati di Analytics si basa su due spazi dei nomi dello schema:

• Microsoft.VisualStudio.Services.Analytics.Model
• Microsoft.VisualStudio.Services.Analytics.

Set di entità e tipi di entità

I tipi di entità sono denominati tipi strutturati con una chiave. Definiscono le proprietà e le relazioni denominate di ogni entità. La chiave di un EntityType oggetto è formata da un subset delle proprietà primitive, ad esempio WorkItemId, PipelineId, ReleasePipelineId e altro ancora del tipo di entità.

I set di entità sono raccolte denominate di entità. Ad esempio, WorkItems è un set di entità contenente WorkItem entità. La chiave di un'entità identifica in modo univoco l'entità all'interno di un set di entità. Se più set di entità usano lo stesso tipo di entità, la stessa combinazione di valori di chiave può essere visualizzata in più set di entità e identifica entità diverse, una per ogni set di entità in cui viene visualizzata questa combinazione di chiavi. Ognuna di queste entità ha un ID entità diverso. I set di entità forniscono punti di ingresso nel modello di dati.

I set di entità sono descritti nei metadati OData e variano in base al progetto. È possibile esplorare l'elenco completo di set di entità, tipi di entità e proprietà richiedendo i metadati OData per il progetto. Per informazioni su come, vedere Costruire query OData per Analytics.

Entità composite

Le entità composite supportano scenari specifici. Sono costituiti da entità più semplici, spesso richiedono più risorse di calcolo da generare e possono restituire set di risultati più grandi. Per ottenere prestazioni ottimali ed evitare limitazioni non necessarie, assicurarsi di eseguire una query sull'entità corretta per lo scenario.

Ad esempio, WorkItemSnapshot combina WorkItemRevisions e Dates in modo che ogni data abbia una revisione per ogni elemento di lavoro. Questa rappresentazione supporta le query OData che si concentrano sui dati di tendenza per un set filtrato di elementi di lavoro. Tuttavia, non è consigliabile usare questa entità composita per eseguire una query sullo stato corrente degli elementi di lavoro. È invece consigliabile usare il WorkItems set di entità per generare una query con esecuzione più rapida.

Analogamente, alcune entità possono contenere tutti i valori cronologici, mentre altri possono contenere solo valori correnti. WorkItemRevisions contiene tutta la cronologia degli elementi di lavoro, che non è consigliabile usare negli scenari in cui i valori correnti sono di interesse.

Relazioni

Per generare risultati di query più complessi, è possibile combinare le entità usando le relazioni. È possibile usare le relazioni per espandere, filtrare o riepilogare i dati.

Alcune proprietà di navigazione generano una singola entità, mentre altre generano una raccolta di entità. Il diagramma seguente mostra le entità selezionate e le relative proprietà di navigazione. Per maggiore chiarezza, alcune entità e relazioni composite sono state omesse.

Chiavi di relazione

Le relazioni tra entità sono rappresentate anche come chiavi esterne in modo che gli strumenti esterni possano unire entità. Queste proprietà hanno il suffisso "SK" e sono tipi di dati integer o GUID. Le proprietà date hanno proprietà chiave di data integer corrispondenti con il formato seguente: AAAAMMGG.

Tipi di entità e set di entità di rilevamento del lavoro

I tipi di entità e i set di entità seguenti sono supportati con le versioni API indicate. Per informazioni di riferimento complete, vedere Informazioni di riferimento sui metadati di rilevamento del lavoro per Azure Boards Analytics.

EntityType/EntitySet	Descrizione	v1.0	v2.0	v3.0 - Anteprima	v4.0-preview
Zona/ Aree	Percorsi dell'area dell'elemento di lavoro, con proprietà per il raggruppamento e il filtro in base alla gerarchia di aree.	✔	✔	✔	✔
Iterazione/ Iterazioni	Percorsi di iterazione dell'elemento di lavoro, con proprietà per il raggruppamento e il filtro in base alla gerarchia di iterazione.	✔	✔	✔	✔
BoardLocation/ BoardLocations	Le posizioni delle celle della lavagna Kanban, identificate dalla colonna della lavagna, dalla corsia e dalla divisione, includono le impostazioni della scheda storica. Per una descrizione di ogni campo della scheda Kanban, vedere Campi della scheda Kanban e flusso di lavoro.	✔	✔	✔	✔
CalendarDate/ Date	Date utilizzate per filtrare e raggruppare altre entità usando le relazioni.	✔	✔	✔	✔
Project/ Progetti	Tutti i progetti definiti per un'organizzazione (cloud) o una raccolta di progetti (locale).	✔	✔	✔	✔
Processo/ Processi	Informazioni sul backlog usate per espandere o filtrare elementi di lavoro e tipi di elemento di lavoro. Per un esempio che usa Processi per filtrare un report, vedere Report di esempio di rilevamento dei requisiti.		✔	✔	✔
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 burn-down.	✔	✔	✔	✔
Team/ Teams	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.	✔	✔	✔	✔
Utente/ Utenti	Informazioni utente utilizzate per espandere o filtrare varie proprietà degli elementi di lavoro, ad esempio Assegnato a, Creato da.	✔	✔	✔	✔
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Composito) Stato di ogni elemento di lavoro in ogni data del calendario, inclusa la posizione della bacheca Kanban, utilizzata per generare report di tendenza. Per un report di esempio, vedere Report di esempio diagramma di flusso cumulativo (CFD).	✔	✔	✔	✔
WorkItemLink/ WorkItemLinks	I 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.	✔	✔	✔	✔
WorkItemRevision/ WorkItemRevisions	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 tendenze di bug.	✔	✔	✔	✔
Workitem/ WorkItems	Stato corrente degli elementi di lavoro. Usato per supportare i report sullo 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.	✔	✔	✔	✔
WorkItemTypeField/ WorkItemTypeFields	Proprietà dell'elemento di lavoro per ogni tipo di elemento di lavoro e processo. Usato per supportare la creazione di report.	✔	✔	✔	✔

Tipi di entità pipeline e set di entità

I tipi di entità e i set di entità seguenti sono supportati con la versione di Analytics v3.0-preview o v4.0-preview . Per un riferimento completo, vedere Informazioni di riferimento sui metadati della pipeline .

EntityType/EntitySet	Descrizione	v3.0 - Anteprima	v4.0-preview
Ramo/ Rami	Informazioni di base sui rami usati nei test o nelle pipeline. Per un report di esempio, vedere Report di esempio sullo stato di avanzamento.	✔	✔
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(composito) Supporta la comprensione del consumo di pipeline parallele. Per altre informazioni sui test della pipeline parallela, vedere Eseguire test in parallelo usando l'attività Test di Visual Studio.		✔
Pipeline/ Pipeline	Proprietà per una pipeline.	✔	✔
PipelineJob/ PipelineJobs	Risultati dell'esecuzione individuale per un test specifico associato a un TestRun	✔	✔
PipelineRun/ PipelineRuns	Informazioni sull'esecuzione per le pipeline. Per un report di esempio, vedere Report di esempio di tendenza del passaggio della pipeline.	✔	✔
PipelineRunActivityResult/ PipelineRunActivityResults	Log unito di tutte le fasi, passaggi, processi e attività all'interno di un'esecuzione specifica della pipeline. Per un report di esempio, vedere Report di esempio sulla durata dell'attività della pipeline.	✔	✔
PipelineTask/ PipelineTasks	Proprietà per le attività usate all'interno di una pipeline.	✔	✔
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(composito) Supporta la comprensione delle dimensioni del pool, dei processi della pipeline e della concorrenza. Il grafico cronologico per i pool di agenti illustra come è possibile usare questo set di entità.		✔
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(composito)		✔

Testare i tipi di entità e i set di entità

I seguenti tipi di entità e set di entità sono supportati con la versione v3.0-preview o v4.0-preview Analytics. Per un riferimento completo, vedere Riferimento ai metadati di test.

EntityType/EntitySet	Descrizione	v3.0 - Anteprima	v4.0-preview
TestConfiguration/ TestConfigurations	Informazioni sulla configurazione del piano di test. Per informazioni dettagliate sulla configurazione dei test, vedere Testare configurazioni diverse	✔	✔
TestResult/ TestResults	Risultati delle singole esecuzioni per un test specifico associato a un TestRun.	✔	✔
TestResultsDaily/ TestResultsDaily	Aggregazione giornaliera di snapshot delle esecuzioni testResult raggruppate da Test (non TestRun). Per un report di esempio, vedere Report di esempio di tendenza di riepilogo dei test.	✔	✔
Testrun/ TestRuns	Informazioni sull'esecuzione per i test eseguite in una pipeline con TestResult aggregato.	✔	✔
Test/ Test	Proprietà per un test case, ad esempio il nome del test e il proprietario del test. Per informazioni dettagliate sulla definizione dei test case, vedere Creare test case manuali.	✔	✔
TestPoint/ TestPoint	Informazioni sull'esecuzione per i punti di test. Un punto di test è una combinazione univoca di test case, gruppo di test, configurazione e tester. Per un report di esempio, vedere Report di esempio sullo stato di avanzamento.	✔	✔
TestPointHistorySnapshot/ TestPointHistorySnapshots	(composito) Risultati delle singole esecuzioni per un test specifico associato a un TestRun. Per un report di esempio, vedere Report di esempio di tendenza dell'esecuzione dei test manuale	✔	✔
TestSuite/ TestSuites	Informazioni sui gruppi di test. Per informazioni dettagliate sulla definizione di gruppi di test, vedere Creare piani di test e pacchetti di test.	✔	✔

Articoli correlati

• Linee guida per le query OData Analytics
• Analisi WIT
• Aggregare i dati
• Esplorazione dei metadati OData di Analisi
• Limiti di progetti, processi e rilevamento del lavoro
• Progettazione dei set di dati delle visualizzazioni di Analisi