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é je možné filtrovat, agregovat a sumarizovat. Kromě toho obsahují navigační vlastnosti , které souvisejí s entitami, a poskytují přístup k dalším vlastnostem pro výběr, filtrování a seskupení.
Poznámka:
Služba Analytics je automaticky povolená a podporovaná v produkčním prostředí pro všechny služby Azure DevOps Services. Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou obecně dostupné. Doporučujeme, abyste ho používali a poskytli nám zpětnou vazbu.
Dostupná data jsou závislá 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.
Poznámka:
Služba Analytics se automaticky nainstaluje a podporuje v produkčním prostředí pro všechny nové kolekce projektů pro Azure DevOps Server 2020 a novější verze. Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou obecně dostupné. Doporučujeme, abyste ho používali a poskytli nám zpětnou vazbu. Pokud jste upgradovali z Azure DevOps Serveru 2019, můžete během upgradu nainstalovat službu Analytics.
Dostupná data jsou závislá 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.
Poznámka:
Služba Analytics je ve verzi Preview pro Azure DevOps Server 2019. Můžete ji povolit nebo nainstalovat pro kolekci projektů. Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou ve verzi Preview. Doporučujeme, abyste ho používali a poskytli nám zpětnou vazbu.
Dostupná data jsou závislá 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ýza je založený na dvou oborech názvů schématu:
Microsoft.VisualStudio.Services.Analytics.ModelMicrosoft.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íč objektu je EntityType vytvořen z podmnožina primitivních vlastností, například WorkItemId, PipelineId, ReleasePipelineId a dalších typů entit.
Sady entit jsou pojmenované kolekce entit. Jedná se například WorkItems o sadu entit obsahující WorkItem entity. Klíč entity jednoznačně identifikuje entitu v rámci sady entit. Pokud používá více sad entit stejný typ entity, může se stejná kombinace hodnot klíčů zobrazit ve více než jedné sadě entit a identifikovat různé entity, jednu na sadu entit, ve které se tato kombinace kláves zobrazuje. Každá z těchto entit má jiné ID entity. Sady entit poskytují vstupní body do datového modelu.
Sady entit jsou popsány 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ýzu.
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ů. Abyste dosáhli nejlepšího výkonu a vyhnuli se zbytečnému omezování, ujistěte se, že se ve svém scénáři dotazujete na správnou entitu.
Například WorkItemSnapshot kombinuje WorkItemRevisions a Dates tak, aby každé datum má pro každou pracovní položku jednu revizi. 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í aktuálního stavu pracovních položek. Místo toho byste měli použít WorkItems sadu entit k vygenerování rychlejšího dotazu.
Podobně mohou některé entity obsahovat všechny historické hodnoty, zatímco jiné můžou obsahovat pouze aktuální hodnoty. WorkItemRevisions obsahuje všechny historie pracovních položek, které byste neměli používat ve scénářích, kde jsou aktuální hodnoty zajímavé.
Relace
Pokud chcete vygenerovat složitější výsledky dotazů, můžete kombinovat entity pomocí relací. Relace můžete použít k rozbalení, filtrování nebo sumarizaci dat.
Některé vlastnosti navigace vedou k jedné entitě, zatímco jiné mají za následek kolekci entit. Následující diagram znázorňuje vybrané entity a jejich navigační vlastnosti. Pro přehlednost byly vynechány některé složené entity a relace.
Klíče relací
Relace entit jsou také reprezentovány jako cizí klíče, aby externí nástroje mohly spojit entity. Tyto vlastnosti mají příponu SK a jsou buď celé číslo, nebo datové typy GUID. Vlastnosti data mají odpovídající celočíselné vlastnosti klíče kalendářního data s následujícím formátem: RRRRMMDD.
Typy entit a sady entit sledování práce
Následující typy entit a sady entit jsou podporovány v uvedených verzích rozhraní API. Kompletní referenční informace najdete v tématu Referenční informace o metadatech sledování práce pro Azure Boards Analytics.
EntityType/EntitySet |
Popis | v1.0 | v2.0 | v3.0-preview | v4.0-preview |
|---|---|---|---|---|---|
| Plocha/ Oblasti |
Cesty oblasti pracovní položky s vlastnostmi pro seskupení a filtrování podle hierarchie oblastí. | ✔️ | ✔️ | ✔️ | ✔️ |
| Iterace/ Iterace |
Cesty iterace pracovní položky s vlastnostmi pro seskupení a filtrování podle hierarchie iterací. | ✔️ | ✔️ | ✔️ | ✔️ |
| BoardLocation/ BoardLocations |
Umístění buněk panelu, jak je identifikováno sloupcem desky, plaveckou drahou a rozdělením, zahrnuje nastavení historické desky. Popis jednotlivých polí panelu najdete v tématu Pracovní postup a pole panelu. | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate/ Datle |
Data použitá k filtrování a seskupení dalších entit pomocí relací. | ✔️ | ✔️ | ✔️ | ✔️ |
| Projekt/ 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, naleznete v části Požadavky sledování ukázkové sestavy. | ✔️ | ✔️ | ✔️ | |
| Tag/ Značky |
Všechny značky pracovních položek pro každý projekt Příklad, který k filtrování sestavy používá značky , najdete v ukázkové sestavě burndownu vydané verze. | ✔️ | ✔️ | ✔️ | ✔️ |
| Team/ 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í průřezu týmu do sestavy Power BI. | ✔️ | ✔️ | ✔️ | ✔️ |
| Uživatel/ 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, Vytvořeno uživatelem. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemBoardSnapshot/ WorkItemBoardSnapshot |
(složené) Stav každé pracovní položky pro každé datum kalendáře, včetně umístění panelu, sloužící ke generování sestav trendů. Ukázkovou sestavu najdete v ukázkové sestavě diagramu toku (CFD). | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemLink/ WorkItemLinks |
Vazby mezi pracovními položkami, například podřízené položky, nadřazené položky a související. Obsahuje pouze nejnovější revizi odkazů, bez historie. Hypertextové odkazy nejsou zahrnuty. | ✔️ | ✔️ | ✔️ | ✔️ |
| 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 každém kalendářním datu, který slouží 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. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemTypeField/ 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 a sady entit pipelines
Následující typy entit a sady entit jsou podporovány ve verzi v3.0-Preview nebo v4.0-preview Analytics. Úplný odkaz naleznete v tématu Odkaz na metadata kanálu .
| EntityType/EntitySet | Popis | v3.0-preview | v4.0-preview |
|---|---|---|---|
| Větev/ 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 pochopení spotřeby paralelních kanálů. Další informace o paralelních testech kanálu naleznete v tématu Paralelní spouštění testů pomocí úlohy Visual Studio Test. | ✔️ | |
| Potrubí/ Pipelines |
Vlastnosti kanálu | ✔️ | ✔️ |
| PipelineJob/ PipelineJobs |
Výsledky jednotlivých spuštění pro konkrétní test přidružený k testovacímu spuštění | ✔️ | ✔️ |
| PipelineRun/ PipelineRuns |
Informace o spuštění pro kanály Ukázkovou sestavu najdete v části Ukázková sestava trendu rychlosti 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 ukázkové sestavě 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álu a souběžnosti. Historický graf fondů agentů znázorňuje způsob použití této sady entit. | ✔️ | |
| 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. Úplný odkaz najdete v tématu Referenční informace o testovacích metadatech.
EntityType/EntitySet |
Popis | v3.0-preview | v4.0-preview |
|---|---|---|---|
| TestConfiguration/ TestConfigurations |
Informace o konfiguraci testovacího plánu Podrobnosti o konfiguraci testů najdete v tématu Testování různých konfigurací. | ✔️ | ✔️ |
| TestResult/ TestResults |
Výsledky jednotlivých spuštění pro konkrétní test přidružený k testovacímu spuštění. | ✔️ | ✔️ |
| TestResultsDaily/ TestResultsDaily |
Denní agregace snímků spuštění TestResult seskupené podle testu (ne TestRun). Ukázkovou sestavu najdete v části Ukázka ukázkové sestavy trendu testu. | ✔️ | ✔️ |
| Testovací spuštění/ Testovací běhy |
Informace o spuštění testů v rámci kanálu s agregovaným testResult. | ✔️ | ✔️ |
| Testování/ Testy |
Vlastnosti testovacího případu, například 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/ TestPoints |
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é) Výsledky jednotlivých spuštění pro konkrétní test přidružený k testovacímu spuštění. Ukázkovou sestavu najdete v ukázkové sestavě trendu ručního spuštění testu. | ✔️ | ✔️ |
| TestSuite/ TestSuites |
Informace o sadách testů Podrobnosti o definování sad testů najdete v tématu Vytvoření testovacích plánů a testovacích sad. | ✔️ | ✔️ |