Trendadatok lekérdezése

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

Az adatok trendjeinek vizsgálata és az időszakok közötti összehasonlítások a jelentéskészítés és az adatelemzés fontos szempontjai. Az Elemzés támogatja ezeket a képességeket.

Megjegyzé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.

A trendadatok a WorkItemSnapshot és a WorkItemBoardSnapshot entitáskészletekben vannak közzétéve. Úgy vannak létrehozva, hogy minden munkaelem, a létrehozás napjától a mai napig minden nap létezik. Az egy évvel ezelőtt létrehozott egyetlen munkaelemet tartalmazó szervezet esetében az entitásban 365 sor található. Nagy projektek esetén ezek az entitások nem lennének praktikusak az ügyféleszközökkel való használathoz.

Mi a megoldás? Használja az aggregációs bővítményeket.

Ebben a cikkben a következőt fogja elsajátítani:

• Alapszintű lekérdezés létrehozása trendadatokhoz

Az OData Aggregation Extensions használatával összesített adatokat adhat vissza az Azure DevOpsból, amelyek elősegítik a jelentéskészítést. Megjelenítheti például a március hónapra vonatkozó hibatrendet. A hibatrendek a projektek kezelésének gyakori és kritikus részét képezik, így azonnal hasznos lehet.

Alapszintű lekérdezés létrehozása trendadatokhoz

A WorkItemSnapshot tábla hatékony lekérdezéséhez néhány alapvető követelmény szükséges:

• Szűrje az adatokat dátum szerint.
• Az összesítésnek legalább dátum szerint kell csoportosítania. Ha nem, a válasz figyelmeztetést kap.

A hibatrend-jelentést létrehozó lekérdezés a következő példához hasonlóan néz ki:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//WorkItemSnapshot?
  $apply=
    filter(DateValue ge 2016-03-01Z and DateValue le 2016-03-31Z and WorkItemType eq 'Bug')/
    groupby((DateValue,State), aggregate($count as Count))
  &$orderby=DateValue

Az alábbi példához hasonló eredményt ad vissza:

{
  "@odata.context": "https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//$metadata#WorkItemSnapshot(DateValue,State,Count)",
  "value": [
    {
      "@odata.id": null,
      "State": "Active",
      "DateValue": "2016-03-01T00:00:00-08:00",
      "Count": 2666
    },
    {
      "@odata.id": null,
      "State": "Closed",
      "DateValue": "2016-03-01T00:00:00-08:00",
      "Count": 51408
    }
  ]
}

Ez a lekérdezés legfeljebb 31 * (number of bug states)a következőt fogja eredményezni: Az alapértelmezett hiba három állapotú:

• Aktív
• Resolved
• Lezárva

Ez a lekérdezés legfeljebb 93 sort ad vissza, függetlenül attól, hogy valójában hány ezer rekord létezik. Sokkal tömörebb adatvisszaküldési formát biztosít.

Tekintsük át a példában szereplő változatot. Látni szeretné egy iteráció vagy kiadás hibatrendét, amely egy iterációval kezdődik, és egy másikkal végződik.

A lekérdezés létrehozásához tegye a következő példát:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//WorkItemSnapshot?
  $apply=
    filter(WorkItemType eq 'Bug')/
    filter(Iteration/IterationName eq 'Sprint 99')/
    filter(DateValue ge Iteration/StartDate and (Iteration/EndDate eq null or DateValue le Iteration/EndDate))/
    groupby((DateValue, State), aggregate($count as Count))
  &$orderby=DateValue

Az alábbi példához hasonló eredményt ad vissza:

{
  "@odata.context": "https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}//$metadata#WorkItemSnapshot(DateValue,State,Count)",
  "value": [
    {
      "@odata.id": null,
      "State": "Active",
      "DateValue": "2016-04-04T00:00:00-07:00",
      "Count": 320
    },
    {
      "@odata.id": null,
      "State": "Closed",
      "DateValue": "2016-04-04T00:00:00-07:00",
      "Count": 38
    }
  ]
}

Ebben a lekérdezésben két fő különbség van. Hozzáadtunk egy szűrőzáradékot, amely egy adott iterációra szűri az adatokat, és a dátumok most összehasonlítva vannak az iteráció kezdő és záró dátumával, illetve egy nehezen kódolt dátummal.

Megjegyzés:

Ha a pillanatképtáblákon lévő lekérdezés nem használja az összesítést, a válaszban megjelenik a "A megadott lekérdezés nem tartalmaz $select vagy $apply záradékot, amely minden lekérdezéshez ajánlott".

Related articles

• Összesítő adat lekérdezéseket hozhat létre a kapcsolódó adatok csoportjainak megszámlálásához és elemzéséhez.