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

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.

Előfeltételek

• Az Analytics-adatok megtekintéséhez és a szolgáltatás lekérdezéséhez egy alapszintű hozzáféréssel rendelkező vagy annál nagyobb hozzáférésű projekt tagjának kell lennie. Alapértelmezés szerint minden projekttag rendelkezik az Analytics lekérdezéséhez és az Analytics-nézetek meghatározásához szükséges engedélyekkel.
• 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 az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben olvashat.

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. Az előzményadatokkal kapcsolatos további információkért lásd : 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"
         }
      }
   ]
}

Kapcsolódó cikkek

• WIT-elemzés
• Adatok összesítése
• Az OData Analytics lekérdezési irányelvei