Adatmodell az Elemzéshez

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

Az Azure DevOps Analytics-adatmodellje entitáskészletekből áll, amelyek tagjai (entitásai) szűrhető, összesíthető és összegzhető 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.

Feljegyzés

Az Elemzési szolgáltatás automatikusan engedélyezve és támogatva van az összes Azure DevOps Services esetében az éles környezetben. Az Elemzési szolgáltatás OData-hírcsatornájának Power BI-integrációja és hozzáférése általánosan elérhető. Javasoljuk, hogy használja és küldjön nekünk visszajelzést. A rendelkezésre álló adatok verziófüggők. A legújabb támogatott verzió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 egy kulccsal rendelkező strukturált típusok. Ezek határozzák meg az egyes entitások elnevezett tulajdonságait és kapcsolatait. Egy kulcs EntityType a primitív tulajdonságok egy részhalmazából jön létre, például a WorkItemId, a PipelineId, a ReleasePipelineId és az entitástípus további részeiből.

Az entitáskészletek entitások nevesített gyűjteményei. Például WorkItems egy entitásokat tartalmazó WorkItem entitáskészlet. 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 azonosíthat különböző entitásokat, amelyekben ez a kulcskombináció megjelenik. Mindegyik entitás más-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. A cikkből megtudhatja, hogyan hozhat létre OData-lekérdezéseket 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önyvhöz megfelelő entitást kérdezi le.

Egyesít WorkItemRevisions Dates és például úgy, WorkItemSnapshot hogy minden dátumhoz egy-egy változat tartozik az egyes munkaelemekhez. Ez a reprezentáció olyan OData-lekérdezéseket támogat, amelyek a szűrt munkaelemek trendadataira összpontosítanak. Ezzel az összetett entitással azonban nem kérdezheti le a munkaelemek aktuális állapotát. Ehelyett az WorkItems entitáskészlettel gyorsabban futó lekérdezést kell létrehoznia.

Hasonlóképpen előfordulhat, hogy egyes entitások az összes előzményértéket tartalmazzák, míg mások csak az aktuális értékeket. WorkItemRevisions az összes munkaelem-előzményt tartalmazza, 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 összekapcsolhatja az entitásokat 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.

Kapcsolatkulcsok

Az entitáskapcsolatok idegen kulcsként is jelennek meg, í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átumú egész szám típusú dátumkulcs-tulajdonságokkal 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ületeken	A munkaterület elérési útjai területhierarchia szerinti csoportosítási és szűrési tulajdonságokkal.	✔️	✔️	✔️	✔️
Iteráció/ Ismétléseket	A munkaelem iterációs útvonalai, az iterációs hierarchia szerinti csoportosítás és szűrés tulajdonságaival.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	A táblacella helyei a táblaoszlop, a sáv és a felosztás alapján meghatározottak szerint tartalmazzák a korábbi táblabeállításokat. Az egyes táblamezők leírását a Munkafolyamat és a tábla mezők című témakörben talál.	✔️	✔️	✔️	✔️
CalendarDate/ Datolya	A kapcsolatok használatával más entitások szűréséhez és csoportosításához használt dátumok.	✔️	✔️	✔️	✔️
Projekt/ Projektek	Egy szervezethez (felhőhöz) vagy projektgyűjteményhez (helyszíni) definiált összes projekt.	✔️	✔️	✔️	✔️
Folyamat/ Folyamatok	A munkaelemek és a munkaelemtípusok kibontásához vagy szűréséhez használt teendőlista-információk. Ha például folyamatokat használ egy jelentés szűrésére, tekintse meg a követelmények nyomon követésére szolgáló mintajelentést.		✔️	✔️	✔️
Tag/ Címkék	Minden projekt munkaelem-címkéje. Ha például címkéket használ egy jelentés szűréséhez, tekintse meg a Kiadási leégés mintajelentést.	✔️	✔️	✔️	✔️
Team/ Csapat	A projekthez definiált összes csapat. Ha például a Teams használatával szűr egy jelentést, olvassa el a Csoportszeletelő hozzáadása Power BI-jelentéshez című témakört.	✔️	✔️	✔️	✔️
Felhasználó/ Felhasználók	A különböző munkaelem-tulajdonságok 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 tábla helyét is, a trendjelentések létrehozásához. A mintajelentések esetében lásd a CFD-mintajelentést.	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	A munkaelemek, például a Gyermek, a Szülő és a Kapcsolódó elemek közötti kapcsolatok. Csak a hivatkozások legújabb változatát tartalmazza, előzmények nélkül. A hivatkozások nem szerepelnek benne.	✔️	✔️	✔️	✔️
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 a trendjelentések támogatásához. A mintajelentéseket a Hibatrendek mintajelentésben tekinti meg.	✔️	✔️	✔️	✔️
Munkaelemek/ Munkaelemek	A munkaelemek aktuális állapota. Állapotjelentések támogatására szolgál. A mintajelentések esetében tekintse meg a gyermekmunkaelemek összegző értékeinek szülő-mintajelentésre történő összesítését.	✔️	✔️	✔️	✔️
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

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 hivatkozásért tekintse meg a folyamat metaadatainak hivatkozását .

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. A mintajelentések esetében lásd a Folyamat állapotának mintául szolgáló jelentést.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Összetett) Támogatja a párhuzamos folyamathasználat megértését. A párhuzamos folyamattesztekről további információt a Tesztek párhuzamos futtatása a Visual Studio tesztfeladat használatával című témakörben talál.		✔️
Csővezeték/ Folyamatok	Folyamatok tulajdonságai.	✔️	✔️
PipelineJob/ PipelineJobs	Tesztfuttatáshoz társított adott teszt egyedi végrehajtási eredményei	✔️	✔️
PipelineRun/ PipelineRuns	Folyamatok végrehajtási adatai. A mintajelentések esetében lásd : Folyamatátadási sebesség trendje mintajelentés.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Egy adott folyamatvégrehajtás összes fázisának, lépésének, feladatának és tevékenységének egyesített naplója. A mintajelentések esetében lásd a folyamattevékenység időtartamáról szóló mintajelentést.	✔️	✔️
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énydiagramja 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 hivatkozásért tekintse meg a metaadatokra vonatkozó referencia tesztelését.

EntityType/EntitySet	Leírás	3.0-s előzetes verzió	4.0-s verziójú előzetes verzió
TestConfiguration/ TestConfigurations	A terv konfigurációs adatainak tesztelése. 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, teszt (nem TestRun) szerint csoportosítva. A mintajelentések esetében tekintse meg az összegzési trend mintajelentését.	✔️	✔️
TestRun/ TestRuns	Az összesített TestResulttal futtatott tesztek végrehajtási információi.	✔️	✔️
Tesztelés/ Vizsgálatok	A teszteset tulajdonságai, például a teszt neve és a teszt tulajdonosa. A tesztelési esetek meghatározásával kapcsolatos részletekért lásd: Manuális tesztesetek 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 esetében lásd a Folyamat állapotának mintául szolgáló jelentést.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Összetett) A Tesztfuttatáshoz társított adott teszt egyedi végrehajtási eredményei. A mintajelentések esetében lásd a manuális tesztvégrehajtási trendek mintajelentését	✔️	✔️
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 feltárása
• A munka nyomon követésére, a folyamatokra és a projektekre vonatkozó korlátok
• Elemzési nézetek adathalmazának tervezése