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.

Megjegyzés

Az Elemzési szolgáltatás automatikusan engedélyezve van és támogatott éles környezetben az Azure DevOps Services összes szolgáltatásához. Az Analytics szolgáltatás OData-hírcsatornájánakPower BI-integrációja és hozzáférése általánosan elérhető. Javasoljuk, hogy használja az Analytics OData-hírcsatornát, és küldjön visszajelzést.

A rendelkezésre álló adatok verziófüggők. Az OData API legújabb támogatott verziója a v2.0, és a legújabb előzetes verzió a v4.0-preview. További információ: OData API-verziószámozás.

Séma né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 EntityType kulcs a primitív tulajdonságok egy részhalmazából jön létre, például WorkItemId, PipelineId, ReleasePipelineId, és további jellemzői az entitás típusának.

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 teljesítménykorlátozá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.

Például, a WorkItemSnapshot úgy egyesíti a WorkItemRevisions és Dates elemeket, hogy minden dátumhoz az egyes munkaelemekhez tartozik egy-egy változat. 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ületek	A munkaterület elérési útjai területhierarchia szerinti csoportosítási és szűrési tulajdonságokkal.	✔️	✔️	✔️	✔️
Iteráció/ Iterációk	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, amelyeket a táblaoszlop, a sáv és a felosztás alapján azonosítanak, 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/ Dátumok	A kapcsolatok segítségével más entitások szűrésére és csoportosítására 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 bontásához vagy szűréséhez használt hátralék-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.		✔️	✔️	✔️
Címke/ Címkék	Minden projekt összes munkaelem-címkéi. Lásd a Címkéket, amelyek egy jelentés szűrésére szolgálnak, mint például a Kiadási leégés mintajelentést.	✔️	✔️	✔️	✔️
Csapat/ Csapatok	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/ Munkafeladat Táblakivonat	(Összetett) Az egyes naptári dátumok munkaelemeinek állapota, beleértve a tábla helyét is, a trendjelentések létrehozásához. Egy mintajelentéshez lásd a CFD-mintajelentést.	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Munkaelemek közötti kapcsolatok, például Gyermek, Szülő és Kapcsolódó. Csak a hivatkozások legújabb változatát tartalmazza, előzmények nélkül. A hivatkozások nem szerepelnek benne.	✔️	✔️	✔️	✔️
WorkItemRevision/ Munkatétel-változatok	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és megtekintéséhez, lásd: Hibatrendek mintajelentés.	✔️	✔️	✔️	✔️
Munkaelem/ 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/ MunkatípusMezők	Az egyes munkaelemtípusok és -folyamatok munkaelem-tulajdonságai. Jelentések készítésének támogatására használják.	✔️	✔️	✔️	✔️

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 referencia megtekintéséhez lásd: Pipeline metaadatok referencia.

Az entitás típusa/entitás halmaz	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 adatfolyam fogyasztásának 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/ Csővezetékek	Egy folyamatlánc tulajdonságai.	✔️	✔️
PipelineJob/ PipelineJobs	Tesztfuttatáshoz társított adott teszt egyedi végrehajtási eredményei	✔️	✔️
PipelineRun/ PipelineRuns	Folyamatok végrehajtási adatai. Mintajelentésért lásd: Pipeline átadási arány 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 Teszt metaadat hivatkozás.

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. Egy mintajelentéshez tekintse meg a Teszt összegzésének 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	Tesztcsomag-információk. A tesztcsomagok meghatározásával kapcsolatos részletekért lásd Teszttervek é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