Datový model pro analýzu

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Datový model Analytics pro Azure DevOps se skládá ze sad entit, jejichž členové (entity) obsahují vlastnosti, které lze filtrovat, agregovat a sumarizovat. Navíc obsahují navigační vlastnosti , které vzájemně spojují entity a poskytují přístup k dalším vlastnostem pro výběr, filtrování a seskupování.

Poznámka

Služba Analytics je automaticky povolená a podporovaná v produkčním prostředí pro všechny Azure DevOps Services. Integrace Power BI a přístup k datovému kanálu OData analytické služby jsou obecně dostupné. Doporučujeme, abyste ji použili a poskytli nám zpětnou vazbu. Dostupná data závisí na verzi. Nejnovější podporovaná verze je v2.0a nejnovější verze Preview je v4.0-preview. Další informace najdete v tématu Správa verzí rozhraní API OData.

Obory názvů schématu

Datový model Analýzy je založený na dvou oborech názvů schématu:

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

Sady entit a typy entit

Typy entit jsou pojmenované strukturované typy s klíčem. Definují pojmenované vlastnosti a vztahy každé entity. Klíč EntityType je tvořen z podmnožin primitivních vlastností, například WorkItemId, PipelineId, ReleasePipelineId a dalších typů entity.

Sady entit jsou pojmenované kolekce entit. Například WorkItems je sada entit obsahující WorkItem entity. Klíč entity jednoznačně identifikuje entitu v rámci sady entit. Pokud více sad entit používá stejný typ entity, může se stejná kombinace hodnot klíčů objevit ve více než jedné sadě entit a identifikuje různé entity ( jednu pro každou sadu entit, kde se tato kombinace klíčů vyskytuje. Každá z těchto entit má jiné id entity. Sady entit poskytují vstupní body do datového modelu.

Sady entit jsou popsané v metadatech OData a liší se podle projektu. Úplný seznam sad entit, typů entit a vlastností můžete prozkoumat vyžádáním metadat OData pro váš projekt. Postup najdete v tématu Vytváření dotazů OData pro analýzy.

Složené entity

Složené entity podporují konkrétní scénáře. Skládají se z jednodušších entit, často vyžadují k vygenerování více výpočetních prostředků a můžou vracet větší sady výsledků. Pokud chcete dosáhnout nejlepšího výkonu a vyhnout se zbytečnému omezování, ujistěte se, že dotazujete správnou entitu pro váš scénář.

Například kombinuje WorkItemRevisions a Dates tak, WorkItemSnapshot že každé datum má jednu revizi pro každou pracovní položku. Tato reprezentace podporuje dotazy OData, které se zaměřují na data trendu pro filtrovanou sadu pracovních položek. Tuto složenou entitu byste ale neměli používat k dotazování na aktuální stav pracovních položek. Místo toho byste měli použít WorkItems sadu entit k vygenerování rychleji běžícího dotazu.

Podobně některé entity můžou obsahovat všechny historické hodnoty, zatímco jiné můžou obsahovat jenom aktuální hodnoty. WorkItemRevisions obsahuje veškerou historii pracovních položek, kterou byste neměli používat ve scénářích, kde jsou aktuální hodnoty zajímavé.

Relace

Pokud chcete generovat složitější výsledky dotazů, můžete kombinovat entity pomocí relací. Relace můžete použít k rozbalení, filtrování nebo sumarizace dat.

Některé navigační vlastnosti mají za následek jednu entitu, zatímco jiné mají za následek kolekci entit. Následující diagram znázorňuje vybrané entity a jejich navigační vlastnosti. Kvůli přehlednosti byly některé složené entity a relace vynechány.

Klíče relací

Relace entit jsou také reprezentovány jako cizí klíče, aby externí nástroje mohly spojovat entity. Tyto vlastnosti mají příponu SK a jsou datové typy typu integer nebo GUID. Vlastnosti data mají odpovídající celočíselné vlastnosti klíče data v následujícím formátu: RRRRMMDD.

Typy entit a sady entit pro sledování práce

Uvedené verze rozhraní API podporují následující typy entit a sady entit. Kompletní referenční informace najdete v tématu Referenční informace o metadatech sledování práce pro Azure Boards Analytics.

EntityType/EntitySet	Description	v1.0	v2.0	v3.0-preview	verze 4.0 preview
Oblasti/ Oblasti	Pracovní položka Cesty oblastí s vlastnostmi pro seskupení a filtrování podle hierarchie oblastí.	✔️	✔️	✔️	✔️
Iterace/ Iterace	Pracovní položka Iterační cesty s vlastnostmi pro seskupení a filtrování podle hierarchie iterací.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Umístění buněk na panelu Kanbanu podle sloupce panelu, plavecké dráhy a rozdělení zahrnuje nastavení historické desky. Popis jednotlivých polí panelu Kanbanu najdete v tématech Pracovní postup a Pole panelu Kanban.	✔️	✔️	✔️	✔️
Datum kalendáře/ Datum	Data používaná k filtrování a seskupení jiných entit pomocí relací.	✔️	✔️	✔️	✔️
Project/ Projekty	Všechny projekty definované pro organizaci (cloud) nebo kolekci projektů (místní).	✔️	✔️	✔️	✔️
Proces/ Procesy	Informace o backlogu používané k rozbalení nebo filtrování pracovních položek a typů pracovních položek Příklad, který používá procesy k filtrování sestavy, najdete v tématu Ukázková sestava sledování požadavků.		✔️	✔️	✔️
Značku/ Značky	Všechny značky pracovních položek pro každý projekt Příklad, který používá značky k filtrování sestavy, najdete v tématu Ukázková sestava vydaného burndownu.	✔️	✔️	✔️	✔️
Tým/ Teams	Všechny týmy definované pro projekt Příklad, který používá Teams k filtrování sestavy, najdete v tématu Přidání týmového průřezu do sestavy Power BI.	✔️	✔️	✔️	✔️
Uživatele/ Uživatelé	Informace o uživateli, které slouží k rozbalení nebo filtrování různých vlastností pracovní položky, například Přiřazeno, Autor.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(složené) Stav každé pracovní položky v jednotlivých kalendářních datech, včetně umístění panelu Kanban, který se používá ke generování sestav trendů. Ukázkovou sestavu najdete v ukázkové sestavě kumulativního vývojového diagramu (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Propojení mezi pracovními položkami, například Podřízený, Nadřazený a Související. Zahrnuje pouze nejnovější revizi odkazů, bez historie. Hypertextové odkazy nejsou zahrnuté.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Všechny revize historických pracovních položek, včetně aktuální revize. Nezahrnuje odstraněné pracovní položky.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(složené) Stav každé pracovní položky v jednotlivých kalendářních datech, který se používá k podpoře generování sestav trendů. Ukázkovou sestavu najdete v ukázkové sestavě trendů chyb.	✔️	✔️	✔️	✔️
Workitem/ Pracovní položky	Aktuální stav pracovních položek. Používá se k podpoře zpráv o stavu. Ukázkovou sestavu najdete v tématu Souhrn hodnot podřízených pracovních položek do nadřazené ukázkové sestavy.	✔️	✔️	✔️	✔️
Pole WorkItemTypeField/ Pole WorkItemTypeFields	Vlastnosti pracovní položky pro každý typ a proces pracovní položky. Používá se k podpoře vytváření sestav.	✔️	✔️	✔️	✔️

Typy entit kanálů a sady entit

Následující typy entit a sady entit jsou podporovány ve verzi v3.0-preview nebo v4.0-preview Analytics. Kompletní referenční informace najdete v tématu Referenční informace k metadatem kanálu .

EntityType/EntitySet	Description	v3.0-preview	v4.0-preview
Pobočka/ Větve	Základní informace o větvích používaných v testech nebo kanálech Ukázkovou sestavu najdete v ukázkové sestavě stavu průběhu.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(složené) Podporuje porozumění paralelní spotřebě kanálu. Další informace o paralelních testech kanálů najdete v tématu Paralelní spouštění testů pomocí úlohy Visual Studio Test.		✔️
Potrubí/ Pipelines	Vlastnosti kanálu.	✔️	✔️
Úloha kanálu/ Úlohy kanálu	Jednotlivé výsledky spuštění konkrétního testu přidruženého k testovacímu spuštění	✔️	✔️
Spuštění kanálu/ Spuštění kanálu	Informace o spuštění pro kanály Ukázkovou sestavu najdete v tématu Ukázková sestava trendu rychlosti průchodu kanálu.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Sloučený protokol všech fází, kroků, úloh a úkolů v rámci konkrétního spuštění kanálu Ukázkovou sestavu najdete v tématu Ukázková sestava doby trvání úlohy kanálu.	✔️	✔️
PipelineTask/ PipelineTasks	Vlastnosti pro úlohy, které se používají v rámci kanálu.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(složené) Podporuje pochopení velikosti fondu, úloh kanálů a souběžnosti. Historický graf pro fondy agentů ukazuje, jak lze tuto sadu entit použít.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(složené)		✔️

Testování typů entit a sad entit

Následující typy entit a sady entit jsou podporovány ve verzi v3.0-preview nebo v4.0-preview Analytics. Kompletní referenční informace najdete v referenčních informacích k metadatem testů.

EntityType/EntitySet	Description	v3.0-preview	v4.0-preview
Konfigurace testu/ TestConfigurations	Informace o konfiguraci testovacího plánu Podrobnosti o konfiguraci testů najdete v tématu Testování různých konfigurací.	✔️	✔️
TestResult/ TestResults	Jednotlivé výsledky spuštění konkrétního testu přidruženého k testovacímu spuštění.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Denní snímek agregace spuštění TestResult seskupené podle Test (ne TestRun). Ukázkovou sestavu najdete v tématu Ukázková sestava souhrnného trendu testování.	✔️	✔️
Testovací spuštění/ Testovací spuštění	Informace o spuštění testů spuštěných v kanálu s agregovaným testResultem	✔️	✔️
Test/ Testy	Vlastnosti testovacího případu, jako je název testu a vlastník testu. Podrobnosti o definování testovacích případů najdete v tématu Vytvoření ručních testovacích případů.	✔️	✔️
TestPoint/ Testovací body	Informace o spuštění pro testovací body Testovací bod je jedinečná kombinace testovacího případu, sady testů, konfigurace a testera. Ukázkovou sestavu najdete v ukázkové sestavě stavu průběhu.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(složené) Jednotlivé výsledky spuštění konkrétního testu přidruženého k testovacímu spuštění. Ukázkovou sestavu najdete v ukázkové sestavě trendu ručního provádění testů.	✔️	✔️
TestSuite/ TestSuites	Informace o testovacích sadách Podrobnosti o definování testovacích sad najdete v tématu Vytvoření testovacích plánů a testovacích sad.	✔️	✔️

Související články

• Pokyny k dotazům OData Analytics
• Analýza WIT
• Agregace dat
• Zkoumání metadat OData analytics
• Sledování práce, pracovní procesy a limity projektů
• Návrh datové sady zobrazení analýz