Munkakövetési adatok lekérdezése az Analytics használatával

Cikk
07/17/2024

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

Az Azure DevOps munkakövetési adatait a cikkben megadott alapszintű lekérdezésekkel kérdezheti le. Ezek a lekérdezések a mindennapi igényeket is kielégítik, miközben az Elemzés különböző funkcióit szemléltetik. A lekérdezések többségét az igényeinek megfelelően módosíthatja.

Ez a cikk az Azure Boards Analytics elemzési és metaadat-referenciáihoz készült OData-lekérdezésekben megadott információkat tartalmazza.

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.

Feljegyzés

Az Analytics szolgáltatás automatikusan települ és támogatott éles környezetben az Azure DevOps Server 2020 és újabb verziók összes új projektgyűjteményéhez. 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. Ha az Azure DevOps Server 2019-ről frissített, a frissítés során telepítheti az Analytics szolgáltatá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.

Feljegyzés

Az Analytics szolgáltatás előzetes verzióban érhető el az Azure DevOps Server 2019-hez. Engedélyezheti vagy telepítheti egy projektgyűjteményhez. Az Elemzési szolgáltatás OData-hírcsatornájának Power BI-integrációja és elérése előzetes verzióban érhető el. 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.

Előfeltételek

Hozzáférés: Legyen legalább alapszintű hozzáféréssel rendelkező projekt tagja.
Engedélyek: Alapértelmezés szerint a projekttagok jogosultak az Analytics lekérdezésére és nézetek létrehozására.
A szolgáltatás- és szolgáltatás-engedélyezéssel, valamint az általános adatkövetési tevékenységekkel kapcsolatos egyéb előfeltételekről további információt az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben talál.

Minden példa egy Azure DevOps-projektre terjed ki. A szervezeti szintű hatókörkezelésre vagy az Azure DevOps Serverre vonatkozó példákért tekintse meg a Project és a szervezet hatókörébe tartozó lekérdezéseket.

Tipp.

A WIQL használatával OData Azure DevOps Marketplace-bővítmény használatával gyorsan létrehozhat egy OData-lekérdezést egy munkaelem-lekérdezés alapján a Lekérdezések lapon. Ez a bővítmény támogatja a munkaelemek és a munkaelemek és a közvetlen hivatkozások egybesimított listájának konvertálását. A bővítmények az Azure Boards nem támogatott funkciói, ezért a termékcsapat nem támogatja. A bővítmények használatakor felmerülő kérdésekért, javaslatokért vagy problémákért látogasson el a megfelelő bővítménylapra.

Munkaelemek szűrése módosított dátum alapján

Az entitást úgy WorkItems kérdezi le, hogy listázhassa a mezőfeltételeinek megfelelő munkaelemeket.

Az alábbi lekérdezés a 2021. december 12-nél nagyobb módosítási dátummal rendelkező termékháttérelemeket, hibákat és szolgáltatásokat adja vissza.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/v1.0/WorkItems?
  $select=WorkItemId, WorkItemType, Title, State 
  &$expand=AssignedTo($select=UserEmail)
  &$filter=(Project/ProjectName eq 'Fabrikam Fiber'
    AND (WorkItemType eq 'Product Backlog Item' or WorkItemType eq 'Bug' or WorkItemType eq 'Feature')
    AND ChangedOn/Date ge 2021-12-16T23:44:15.619Z)
  &$orderby=WorkItemType desc

Munkaelemek szűrése terület alapján

Az alábbi lekérdezést úgy módosíthatja, hogy egy adott terület elérési útja alatt lévő összes munkaelemet listázhassa.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?
  $filter=Area/AreaPath eq '{area path}'
  &$select=WorkItemId, Title, State

Példa lekérdezés:

Az alábbi szintaxis például lekérdezi a fabrikam szervezethez definiált egyes projektek munkaelem-számát.

https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/WorkItems?$apply=groupby((Project/ProjectName), aggregate($count as Count))

Példa válasz:

A válasz az alábbi öt projekt adatait adja vissza.

{
   "@odata.context":"https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#WorkItems(Project(ProjectName),Count)",
   "value":[
      {
         "@odata.id":null,
         "Count":2,
         "Project":{
            "@odata.id":null,
            "ProjectName":"Basic Fabrikam"
         }
      },
      {
         "@odata.id":null,
         "Count":19,
         "Project":{
            "@odata.id":null,
            "ProjectName":"Demo 11"
         }
      },
      {
         "@odata.id":null,
         "Count":188,
         "Project":{
            "@odata.id":null,
            "ProjectName":"Fabrikam Fiber"
         }
      },
      {
         "@odata.id":null,
         "Count":89,
         "Project":{
            "@odata.id":null,
            "ProjectName":"MyFirstProject"
         }
      },
      {
         "@odata.id":null,
         "Count":2,
         "Project":{
            "@odata.id":null,
            "ProjectName":"MyPublicProject"
         }
      }
   ]
}

Munkaelemek szűrése iteráció alapján

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?
  $filter=Iteration/IterationPath eq '{iteration path}'
  &$select=WorkItemId, Title, State

Példa lekérdezés:

Az alábbi szintaxis például a Fabrikam Fibre projekt munkaelemeit az Iteration Path=Fabrikam Fibre\Release 1\Sprint 6 alatt lekérdezési feladatként adja le.

https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/WorkItems?$select=WorkItemId, WorkItemType, Title, State&$expand=Iteration($select=IterationPath)&$filter=(Project/ProjectName eq 'Fabrikam Fiber' AND WorkItemType ne '' AND Iteration/IterationPath eq 'Fabrikam Fiber\Release 1\Sprint 6')

Példa válasz:

A válasz az alábbi négy munkaelem adatait adja vissza.

{
   "@odata.context":"https://analytics.dev.azure.com/fabrikam/_odata/v4.0-preview/$metadata#WorkItems(WorkItemId,WorkItemType,Title,State,Iteration(IterationPath))",
   "value":[
      {
         "WorkItemId":361,
         "Title":"Hello World Web Site",
         "WorkItemType":"Product Backlog Item",
         "State":"New",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Release 1\\Sprint 6"
         }
      },
      {
         "WorkItemId":1126,
         "Title":"web site task",
         "WorkItemType":"Task",
         "State":"To Do",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Release 1\\Sprint 6"
         }
      },
      {
         "WorkItemId":1136,
         "Title":"Add a new task with two new tags",
         "WorkItemType":"Task",
         "State":"To Do",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Release 1\\Sprint 6"
         }
      },
      {
         "WorkItemId":1140,
         "Title":"New task - test for Blocked",
         "WorkItemType":"Task",
         "State":"To Do",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Release 1\\Sprint 6"
         }
      }
   ]
}

Iteráció elemeinek lekérése

Egy adott iteráció összes munkaelemét lekérheti, amely az iteráció első napja és az iteráció utolsó napja között esik. Itt a lekérdezést a munkakövetési adatokban lévő adatok korlátozzák.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?
  $filter=Iteration/IterationPath eq '{iteration path}' 
    and ChangedDate ge Iteration/StartDate 
    and ChangedDate le Iteration/EndDate
  &$select=WorkItemId, Title, State

Adott címkéket tartalmazó munkaelemek szűrése

A rendszer minden operátort itt használ, mert egy munkaelemhez társítható címkék gyűjteménye van. Használat szempontjából a formátum a következő: {Navigation Property}/any(d:d/{Field Name} {operator} {expression}). A kapcsos zárójelek ({}) által nem körülvett elemek szó szerintiek. Vannak változatok. Például nem kell a fenti kifejezésben használt "d" kifejezést használnia. A formátum követése egyszerű marad.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?
  $filter=Tags/any(d:d/TagName eq '{tag name}')
  &$select=WorkItemId, Title, State

Munkaelemek szűrése egy adott csapathoz

Az alábbi lekérdezéssel listázhatja egy adott csapat munkaelemeit.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?
  $filter=Teams/any(d:d/TeamName eq '{team name}')
  &$select=WorkItemId, Title, State

Munkaelemek szűrése egy adott értékkel rendelkező mező alapján

Az alábbi lekérdezés hasonlít a Was Ever operátort használó munkaelem-lekérdezéshez.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItems?
  $filter=WorkItemType eq '{Type}'
     and Revisions/any(r:r/ResolvedBy/UserName eq '{User}')

Példa lekérdezés:

Az alábbi lekérdezés azokat a munkaelemeket adja vissza, amelyek valaha Jamal Hartnetthez lettek rendelve, és amelyek e-mail-címe "fabrikamfiber4@hotmail.com" a Fabrikam Fiber-projekthez .

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v4.0-preview/WorkItems?
  $select=WorkItemType, Title, State, 
  &$expand=AssignedTo($select=UserEmail), Area($select=AreaPath)
  &$filter=(WorkItemType ne '' AND State ne '' AND Revisions/any(r:r/AssignedTo/UserEmail eq 'fabrikamfiber4@hotmail.com'))
  &$orderby=WorkItemType asc

Példa válasz:

A válasz két munkaelemet ad vissza.

{
   "@odata.context":"https://analytics.dev.azure.com/fabrikam/Design%20Agile/_odata/v4.0-preview/$metadata#WorkItems(Priority,WorkItemType,Title,State,TagNames,AssignedTo(UserEmail),Area(AreaPath))",
   "value":[
      {
         "Title":"New home page design",
         "WorkItemType":"Feature",
         "State":"Closed",
         "AssignedTo":{
            "UserEmail":"fabrikamfiber4@hotmail.com"
         },
         "Area":{
            "AreaPath":"Design Agile"
         }
      },
      {
         "Title":"Check performance",
         "WorkItemType":"User Story",
         "State":"New",
         "AssignedTo":{
            "UserEmail":"fabrikamfiber4@hotmail.com"
         },
         "Area":{
            "AreaPath":"Design Agile"
         }
      }
   ]
}

A terület elérési útja alatt hozzárendelt csapatok lekérése

Az alábbi lekérdezés a Fabrikam Fibre projekt Fiókkezelési területének területútvonalaihoz rendelt csapatok nevét adja vissza.

> https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v4.0-preview/Areas?
>      $filter=startswith(AreaPath,'Fabrikam Fiber\Account Management')
>      &$select=AreaPath&$expand=Teams($select=TeamName)
>```
The response returns three area paths and the names of several teams assigned to each. 

> [!div class="tabbedCodeSnippets"]
```OData
> @odata.context	"https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#Areas(AreaPath,Teams(TeamName))"
> value	
> 0	
>   AreaPath             "Fabrikam Fiber\\Account Management\\Customer Profile"
>   Teams	
>       0	
>           TeamName     "Organization Management"
>       1	
>           TeamName     "Fabrikam Team"
>       2	
>           TeamName     "Customer Profile"
> 1	
>   AreaPath             "Fabrikam Fiber\\Account Management\\Shopping Cart"
>   Teams	
>       0	
>           TeamName     "Organization Management"
>       1	
>           TeamName     "Shopping Cart"
>       2	
>           TeamName     "Fabrikam Team"
> 2	
>   AreaPath             "Fabrikam Fiber\\Account Management"
>   Teams	
>       0	
>           TeamName     "Organization Management"
>       1	
>           TeamName     "Fabrikam Team"

Adott munkaelem előzményeinek visszaadása

Lekérdezi a WorkItemRevisions munkaelem-előzménylistára beállított entitást. Az alábbi lekérdezés egy adott munkaelem minden változatának Cím, Állapot és Iterációs útvonal értékét adja vissza.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItemRevisions?
  $filter=WorkItemId eq {Id}
  &$select=WorkItemId, Title, State, Iteration Path

Feljegyzés

Amikor módosítás történik egy munkaelemen, beleértve a verem rangértékének módosítását is, létrejön egy változat. További információ az előzményadatokról: Szűrők alkalmazása előzményadatokra.

Példa lekérdezés:

Az alábbi szintaxis például az ID=1145 változatait kéri le a Fabrikam Fibre projektben.

https://analytics.dev.azure.com/fabrikam/Fabrikam Fiber/_odata/v1.0/WorkItemRevisions?$select=WorkItemId, Title, State&$expand=Iteration($select=IterationPath)&$filter=(Project/ProjectName eq 'Fabrikam Fiber' AND WorkItemId eq 1145 AND State ne '' AND Revision gt 1)

Példa válasz:

A válasz pedig a négy változat adatait adja vissza:

{
   "@odata.context":"https://analytics.dev.azure.com/fabrikam/Fabrikam%20Fiber/_odata/v4.0-preview/$metadata#WorkItemRevisions(WorkItemId,Title,State,Iteration(IterationPath))",
   "value":[
      {
         "WorkItemId":1145,
         "Title":"Sprint 2 work added in June",
         "State":"New",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Future"
         }
      },
      {
         "WorkItemId":1145,
         "Title":"Sprint 2 work added in June",
         "State":"New",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Future"
         }
      },
      {
         "WorkItemId":1145,
         "Title":"Sprint 2 work added in June",
         "State":"New",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Release 1\\Sprint 2"
         }
      },
      {
         "WorkItemId":1145,
         "Title":"Sprint 2 work added in June",
         "State":"Done",
         "Iteration":{
            "IterationPath":"Fabrikam Fiber\\Release 1\\Sprint 2"
         }
      }
   ]
}

Megosztás a következőn keresztül:

Munkakövetési adatok lekérdezése az Analytics használatával

Előfeltételek

Munkaelemek szűrése módosított dátum alapján

Munkaelemek szűrése terület alapján

Munkaelemek szűrése iteráció alapján

Iteráció elemeinek lekérése

Adott címkéket tartalmazó munkaelemek szűrése

Munkaelemek szűrése egy adott csapathoz

Munkaelemek szűrése egy adott értékkel rendelkező mező alapján

A terület elérési útja alatt hozzárendelt csapatok lekérése

Adott munkaelem előzményeinek visszaadása

Visszajelzés

További források

Megosztás a következőn keresztül:

Munkakövetési adatok lekérdezése az Analytics használatával

Előfeltételek

Munkaelemek szűrése módosított dátum alapján

Munkaelemek szűrése terület alapján

Munkaelemek szűrése iteráció alapján

Iteráció elemeinek lekérése

Adott címkéket tartalmazó munkaelemek szűrése

Munkaelemek szűrése egy adott csapathoz

Munkaelemek szűrése egy adott értékkel rendelkező mező alapján

A terület elérési útja alatt hozzárendelt csapatok lekérése

Adott munkaelem előzményeinek visszaadása

Kapcsolódó cikkek

Visszajelzés

További források