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. Contengono inoltre proprietà di navigazione correlate tra le entità, fornendo l'accesso ad altre proprietà per la selezione, il filtro e il raggruppamento.

Nota

Il servizio Analytics viene abilitato e supportato automaticamente nell'ambiente di produzione per tutti i Servizi DevOps di Azure. L'integrazione di Power BI e l'accesso al feed OData del servizio di 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 dell'API OData.

Spazi dei nomi dello schema

Il modello di dati di Analisi 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 tipi strutturati denominati con una chiave. Definiscono le proprietà e le relazioni denominate di ogni entità. La chiave di un EntityType oggetto viene 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 Creare query OData per Analytics.

Entità composte

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 in uso.

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 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à composite e relazioni sono state omesse.

Chiavi di relazione

Le relazioni di 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à della data hanno proprietà della chiave di data intera 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 Analisi di Azure Boards.

EntityType/EntitySet	Descrizione	v1.0	v2.0	v3.0 - Anteprima	v4.0-preview
Area/ 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, 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.	✔️	✔️	✔️	✔️
CalendarDate/ Date	Date usate per filtrare e raggruppare altre entità usando relazioni.	✔️	✔️	✔️	✔️
Progetto/ 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 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.		✔️	✔️	✔️
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.	✔️	✔️	✔️	✔️
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à 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).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	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 relativo alle tendenze dei bug.	✔️	✔️	✔️	✔️
WorkItem/ WorkItems	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.	✔️	✔️	✔️	✔️
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à e set di entità di pipeline

I tipi di entità e i set di entità seguenti sono supportati con la versione v3.0-preview o v4.0-preview di Analytics. Per informazioni di riferimento complete, vedere Riferimento ai 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 paralleli della pipeline, vedere Eseguire test in parallelo usando l'attività Test di Visual Studio.		✔️
Pipeline/ Pipeline	Proprietà per una pipeline.	✔️	✔️
PipelineJob/ PipelineJobs	Risultati delle singole esecuzioni 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 della frequenza di passaggio della pipeline.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Log unito di tutte le fasi, passaggi, processi e attività all'interno di una specifica esecuzione 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 usare questo set di entità.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Composito)		✔️

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

I tipi di entità e i set di entità seguenti sono supportati con la versione v3.0-preview o v4.0-preview di Analytics. Per informazioni di riferimento complete, vedere Informazioni di riferimento sui 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 dell'esecuzione singola per un test specifico associato a un TestRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Aggregazione snapshot giornaliera delle esecuzioni TestResult , raggruppate per 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 eseguiti 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 dell'esecuzione singola per un test specifico associato a un TestRun. Per un report di esempio, vedere Report di esempio di tendenza dell'esecuzione di test manuale	✔️	✔️
TestSuite/ TestSuites	Informazioni sui gruppi di test. Per informazioni dettagliate sulla definizione di gruppi di test, vedere Creare piani di test e gruppi di test.	✔️	✔️

Articoli correlati

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