Adatmodell elemzéshez

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

Az Azure DevOps Analytics-adatmodellje entitáskészletekből áll, amelyek tagjai (entitásai) szűrhető, összesíthető és összegezhető tulajdonságokat tartalmaznak. Emellett olyan navigációs tulajdonságokat is tartalmaznak, amelyek entitásokat kapcsolnak össze egymással, és hozzáférést biztosítanak más tulajdonságokhoz a kiválasztáshoz, szűréshez és csoportosításhoz.

Megjegyzés

Az Elemzési szolgáltatás az összes Azure DevOps Services esetében automatikusan engedélyezve van és támogatott éles környezetben. A Power BI integrációja és az Elemzési szolgáltatás OData-hírcsatornához való hozzáférése általánosan elérhető. Javasoljuk, hogy használja, és küldjön nekünk visszajelzést. Az elérhető adatok verziófüggőek. A legújabb támogatott verzió a v2.0, és a legújabb előzetes verzió.v4.0-preview További információ: OData API-verziószámozás.

Sémanévterek

Az Analytics-adatmodell két sémanévtéren alapul:

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

Entitáskészletek és entitástípusok

Az entitástípusok neve strukturált típusok egy kulccsal. Definiálják az egyes entitások nevesített tulajdonságait és kapcsolatait. A kulcs EntityType a primitív tulajdonságok egy részhalmazából jön létre, például WorkItemId, PipelineId, ReleasePipelineId és az entitástípus további részeiből.

Az entitáskészletek entitásgyűjtemények. Például egy entitáskészlet, WorkItems amely WorkItem entitásokat tartalmaz. Az entitáskulcs egyedileg azonosítja az entitáskészleten belüli entitást. Ha több entitáskészlet ugyanazt az entitástípust használja, a kulcsértékek ugyanazon kombinációja több entitáskészletben is megjelenhet, és különböző entitásokat azonosíthat, entitáskészletenként egyet, ahol ez a kulcskombináció megjelenik. Ezek az entitások mindegyike más entitásazonosítóval rendelkezik. Az entitáskészletek belépési pontokat biztosítanak az adatmodellbe.

Az entitáskészleteket az OData metaadatai ismertetik, és projektenként eltérőek. Az entitáskészletek, entitástípusok és tulajdonságok teljes listáját a projekt OData-metaadatainak lekérésével ismerheti meg. További információ: OData-lekérdezések létrehozása az Analyticshez.

Összetett entitások

Az összetett entitások bizonyos forgatókönyveket támogatnak. Egyszerűbb entitásokból állnak, gyakran több számítási erőforrást igényelnek, és nagyobb eredményhalmazokat adhatnak vissza. A legjobb teljesítmény elérése és a szükségtelen szabályozás elkerülése érdekében győződjön meg arról, hogy a forgatókönyvének megfelelő entitást kérdezi le.

Egyesíthet WorkItemRevisionsDates például és úgy, WorkItemSnapshot hogy minden dátumhoz egy változat tartozik az egyes munkaelemekhez. Ez az ábrázolás támogatja azokat az OData-lekérdezéseket, amelyek a szűrt munkaelemek trendadataira összpontosítanak. Nem szabad azonban ezt az összetett entitást használni a munkaelemek aktuális állapotának lekérdezéséhez. Ehelyett az WorkItems entitáskészletet kell használnia egy gyorsabb lekérdezés létrehozásához.

Hasonlóképpen, egyes entitások az összes előzményértéket tartalmazhatják, míg mások csak az aktuális értékeket. WorkItemRevisions tartalmazza az összes munkaelem-előzményt, amelyet nem érdemes olyan helyzetekben használni, ahol az aktuális értékek fontosak.

Kapcsolatok

Összetettebb lekérdezési eredmények létrehozásához entitásokat kombinálhat kapcsolatok használatával. Az adatok kibontásához, szűréséhez vagy összegzéséhez kapcsolatokat alkalmazhat.

Egyes navigációs tulajdonságok egyetlen entitást eredményeznek, míg mások entitások gyűjteményét eredményezik. Az alábbi diagram a kiválasztott entitásokat és azok navigációs tulajdonságait mutatja be. Az egyértelműség kedvéért néhány összetett entitás és kapcsolat kimaradt.

Kapcsolati kulcsok

Az entitáskapcsolatok idegen kulcsként is szerepelnek, így a külső eszközök entitásokhoz csatlakozhatnak. Ezek a tulajdonságok az "SK" utótaggal rendelkeznek, és egész vagy GUID típusúak. A dátumtulajdonságok a következő formátummal rendelkeznek: YYYYMMDD.

Munkakövetési entitástípusok és entitáskészletek

A megadott API-verziók az alábbi entitástípusokat és entitáskészleteket támogatják. Teljes körű referenciát az Azure Boards Analytics munkakövetési metaadatainak referenciája című témakörben talál.

EntityType/EntitySet	Leírás	1.0-s verzió	2.0-s verzió	3.0-s előzetes verzió	4.0-s verziójú előzetes verzió
Terület/ Terület	A Terület elérési útjai munkaelem, amely a területhierarchiák szerinti csoportosítás és szűrés tulajdonságaival rendelkezik.	✔️	✔️	✔️	✔️
Iteráció/ Iterációk	Az Iterációs útvonalak munkaelem, amely az iterációs hierarchia szerinti csoportosítás és szűrés tulajdonságaival rendelkezik.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	A Kanban táblacella helyei, amelyeket a táblaoszlop, a sáv és a felosztás határoz meg, előzménytábla-beállításokat tartalmaznak. Az egyes Kanban táblamezők leírását lásd: Munkafolyamat és Kanban táblamezők.	✔️	✔️	✔️	✔️
CalendarDate/ Dátumok	A kapcsolatok használatával más entitások szűréséhez és csoportosításához használt dátumok.	✔️	✔️	✔️	✔️
Project/ Projektek	Egy szervezethez (felhőhöz) vagy projektgyűjteményhez (helyszíni) definiált összes projekt.	✔️	✔️	✔️	✔️
Folyamat/ Folyamatok	A munkaelemek és munkaelemtípusok kibontásához vagy szűréséhez használt teendőlista-információk. Egy olyan példát, amely folyamatok használatával szűr egy jelentést, tekintse meg a Követelmények nyomon követése mintajelentést.		✔️	✔️	✔️
Tag/ Címkék	Minden projekt összes munkaelemcímkéje. Ha például címkéket használ egy jelentés szűréséhez, tekintse meg az írási mintajelentés kiadását bemutató cikket.	✔️	✔️	✔️	✔️
Csapat/ Teams	A projekthez definiált összes csapat. Ha egy példát szeretne látni, amely a Teams használatával szűr egy jelentést, tekintse meg a Csapatszeletelő hozzáadása Power BI-jelentéshez című témakört.	✔️	✔️	✔️	✔️
Felhasználó/ Felhasználók	A munkaelem különböző tulajdonságainak kibontására vagy szűrésére használt felhasználói adatok, például Hozzárendelve, Létrehozva.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Összetett) Az egyes naptári dátumok munkaelemeinek állapota, beleértve a Kanban-tábla helyét is, a trendjelentések létrehozásához. Mintajelentésért lásd: Göngyölt folyamatábra (CFD) mintajelentés.	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	A munkaelemek közötti kapcsolatok, például Gyermek, Szülő és Kapcsolódó. Csak a hivatkozások legújabb verzióját tartalmazza, előzmények nélkül. A hivatkozásokat nem tartalmazza a program.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Minden korábbi munkaelem-változat, beleértve az aktuális változatot is. Nem tartalmazza a törölt munkaelemeket.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Összetett) Az egyes naptári dátumok munkaelemeinek állapota, amely a trendjelentések támogatására szolgál. Mintajelentésért lásd: Hibatrendek mintajelentése.	✔️	✔️	✔️	✔️
Munkaelemek/ Munkaelemek	A munkaelemek aktuális állapota. Állapotjelentések támogatására szolgál. Mintajelentésekért lásd: Gyermekmunkaelem-értékek összesítése szülő-mintajelentésre.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Az egyes munkaelemtípusok és -folyamatok munkaelem-tulajdonságai. Jelentések készítésének támogatására szolgál.	✔️	✔️	✔️	✔️

Folyamatok entitástípusai és entitáskészletei

A v3.0-preview vagy a v4.0-preview Analytics verzió az alábbi entitástípusokat és entitáskészleteket támogatja. Teljes referencia: Folyamat metaadatainak referenciája .

EntityType/EntitySet	Leírás	3.0-s előzetes verzió	4.0-s verziójú előzetes verzió
Ág/ Ágak	Alapvető információk a tesztekben vagy folyamatokban használt ágakról. Mintajelentésért lásd: Folyamatállapot-mintajelentés.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Összetett) Támogatja a párhuzamos folyamathasználat megértését. A párhuzamos folyamattesztekkel kapcsolatos további információkért lásd: Tesztek párhuzamos futtatása a Visual Studio Tesztfeladat használatával.		✔️
Csővezeték/ Pipelines	Folyamat tulajdonságai.	✔️	✔️
PipelineJob/ PipelineJobs	A Tesztfuttatáshoz társított adott teszt egyedi végrehajtási eredményei	✔️	✔️
PipelineRun/ PipelineRuns	Végrehajtási információk a folyamatokhoz. Mintajelentésért lásd: Folyamatátadási sebesség trendje mintajelentés.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Egyesített napló egy adott folyamatvégrehajtás összes fázisáról, lépéséről, feladatáról és tevékenységéről. A mintajelentésekért lásd: Folyamattevékenység időtartamának mintajelentése.	✔️	✔️
PipelineTask/ PipelineTasks	A folyamaton belül használt tevékenységek tulajdonságai.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Összetett) Támogatja a készlet méretének, a folyamatfeladatok és az egyidejűség megértését. Az ügynökkészletek előzménygráfja bemutatja, hogyan használható ez az entitáskészlet.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Összetett)		✔️

Entitástípusok és entitáskészletek tesztelése

Az alábbi entitástípusok és entitáskészletek támogatottak a v3.0-preview vagy a v4.0-preview Analytics verzióval. A teljes referenciaért lásd: Metaadatokra vonatkozó referencia tesztelése.

EntityType/EntitySet	Leírás	3.0-s előzetes verzió	4.0-s verziójú előzetes verzió
TestConfiguration/ TestConfigurations	Tesztterv konfigurációs adatai. A tesztek konfigurálásával kapcsolatos részletekért lásd: Különböző konfigurációk tesztelése	✔️	✔️
TestResult/ TestResults	A Tesztfuttatáshoz társított adott teszt egyedi végrehajtási eredményei.	✔️	✔️
TestResultsDaily/ TestResultsDaily	A TestResult-végrehajtások napi pillanatkép-összesítése, a Test (nem TestRun) szerint csoportosítva. Mintajelentésért lásd: Az összegzési trend mintajelentésének tesztelése.	✔️	✔️
Tesztfuttatás/ Tesztfuttatások	A tesztfuttatások végrehajtási információi a TestResult összesítéssel rendelkező folyamat alatt futnak.	✔️	✔️
Teszt/ Tesztek	A teszteset tulajdonságai, például a teszt neve és a teszt tulajdonosa. A tesztesetek meghatározásával kapcsolatos részletekért lásd: Manuális tesztelési esetek létrehozása.	✔️	✔️
TestPoint/ TestPoints	A tesztpontok végrehajtási adatai. A tesztelési pontok a tesztelési esetek, tesztelési csomagok, a konfiguráció és a tesztelő egyedi kombinációi. A mintajelentésekért lásd: Állapotmintajelentés.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Összetett) A Tesztfuttatáshoz társított adott teszt egyedi végrehajtási eredményei. Mintajelentésért lásd: Manuális tesztvégrehajtási trend mintajelentése	✔️	✔️
TestSuite/ TestSuites	Tesztcsomagok adatai. A tesztcsomagok meghatározásával kapcsolatos részletekért lásd: Tesztcsomagok és tesztcsomagok létrehozása.	✔️	✔️

Kapcsolódó cikkek

• Az OData Analytics lekérdezési irányelvei
• WIT-elemzés
• Adatok összesítése
• Az Analytics OData metaadatainak felderítése
• A munka nyomon követésére, a folyamatokra és a projektekre vonatkozó korlátok
• Elemzési nézetek adathalmazának kialakítása