Dotazování dat sledování práce pomocí Analýzy

Článek
03/21/2024

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

Data sledování práce Azure DevOps můžete dotazovat pomocí základních dotazů uvedených v tomto článku. Tyto dotazy řeší každodenní potřeby a demonstrují různé možnosti analýz. Většinu těchto dotazů můžete přizpůsobit tak, aby vyhovovaly vašim potřebám.

Tento článek sestaví informace poskytnuté v dotazech OData pro analýzu a metadata pro Azure Boards Analytics.

Poznámka:

Služba Analytics je automaticky povolená a podporovaná v produkčním prostředí pro všechny služby Azure DevOps Services. Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou obecně dostupné. Doporučujeme, abyste ho používali a poskytli nám zpětnou vazbu. Dostupná data jsou závislá na verzi. Nejnovější podporovaná verze je v2.0a nejnovější verze Preview je v4.0-preview. Další informace najdete v tématu Správa verzí rozhraní API OData.

Poznámka:

Služba Analytics se automaticky nainstaluje a podporuje v produkčním prostředí pro všechny nové kolekce projektů pro Azure DevOps Server 2020 a novější verze. Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou obecně dostupné. Doporučujeme, abyste ho používali a poskytli nám zpětnou vazbu. Pokud jste upgradovali z Azure DevOps Serveru 2019, můžete během upgradu nainstalovat službu Analytics.

Dostupná data jsou závislá na verzi. Nejnovější podporovaná verze je v2.0a nejnovější verze Preview je v4.0-preview. Další informace najdete v tématu Správa verzí rozhraní API OData.

Poznámka:

Služba Analytics je ve verzi Preview pro Azure DevOps Server 2019. Můžete ji povolit nebo nainstalovat pro kolekci projektů. Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou ve verzi Preview. Doporučujeme, abyste ho používali a poskytli nám zpětnou vazbu.

Požadavky

Pokud chcete zobrazit data Analýzy a dotazovat se na službu, musíte být členem projektu se základním přístupem nebo novějším. Ve výchozím nastavení mají všichni členové projektu udělená oprávnění k dotazování analýzy a definování zobrazení Analýzy.
Další informace o dalších požadavcích týkajících se povolení služeb a funkcí a obecných aktivit sledování dat najdete v tématu Oprávnění a požadavky pro přístup k Analýzám.

Všechny příklady jsou vymezeny na projekt v Azure DevOps. Příklady určení rozsahu na úrovni organizace nebo Azure DevOps Serveru najdete v tématu Dotazy v rámci projektu a organizace.

Tip

Rozšíření OData Azure DevOps Marketplace můžete použít k rychlému vygenerování dotazu OData na základě dotazu pracovní položky na stránce Dotazy. Toto rozšíření podporuje převod plochého seznamu pracovních položek a pracovních položek a přímých odkazů. Rozšíření nejsou podporována funkcemi Azure Boards, a proto produktový tým nepodporuje. Pokud máte dotazy, návrhy nebo problémy, které máte při používání těchto rozšíření, navštivte odpovídající stránku rozšíření.

Filtrování pracovních položek na základě změně data

Dotazujete entitu nastavenou WorkItems na výpis pracovních položek, které splňují kritéria pole.

Následující dotaz vrátí položky, chyby a funkce produktového backlogu, které mají změněné datum větší než 12. prosince 2021.

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

Filtrování pracovních položek na základě oblasti

Následující dotaz můžete upravit tak, aby vypisovat všechny pracovní položky v určité cestě oblasti.

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

Příklad dotazu:

Následující syntaxe například dotazuje počet pracovních položek pro každý projekt definovaný pro organizaci fabrikam .

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

Příklad odpovědi:

Odpověď vrátí data pro následující pět projektů.

{
   "@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"
         }
      }
   ]
}

Filtrování pracovních položek na základě iterace

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

Příklad dotazu:

Například následující syntaxe dotazuje pracovní položky pro projekt Fabrikam Fiber v rámci Iterace Path=Fabrikam Fiber\Release 1\Sprint 6.

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říklad odpovědi:

Odpověď vrátí data pro následující čtyři pracovní položky.

{
   "@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"
         }
      }
   ]
}

Načtení položek pro iteraci

Můžete načíst všechny pracovní položky pro danou iteraci, které spadají mezi první den iterace a poslední den iterace. Dotaz je zde omezený daty obsaženými v datech sledování práce.

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

Filtrování pracovních položek obsahujících konkrétní značky

Zde se používá jakýkoli operátor, protože existuje kolekce značek, které lze přidružit k pracovní položce. Z hlediska použití je formát: {Navigation Property}/any(d:d/{Field Name} {operator} {expression}). Libovolná položka, která není obklopena složenými závorkami ({}) je literál. Existují určité varianty. Například nemusíte používat "d", jak se používá ve výrazu výše. Tento formát je jednoduchý.

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

Filtrování pracovních položek pro konkrétní tým

Pomocí následujícího dotazu můžete zobrazit seznam pracovních položek pro konkrétní tým.

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

Filtrování pracovních položek na základě pole s konkrétní hodnotou

Následující dotaz je podobný dotazu pracovní položky, který používá operátor Was Ever .

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

Příklad dotazu:

Následující dotaz vrátí pracovní položky, které byly někdy přiřazeny Jamal Hartnett, jehož e-mail je 'fabrikamfiber4@hotmail.com' pro projekt Fabrikam Fiber .

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říklad odpovědi:

Odpověď vrátí dvě pracovní položky.

{
   "@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"
         }
      }
   ]
}

Načtení týmů přiřazených v rámci cesty oblasti

Následující dotaz vrátí názvy týmů přiřazených k cestám oblastí v oblasti Správa účtů pro projekt Fabrikam Fiber .

> 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"

Vrácení historie konkrétní pracovní položky

Dotazujete entitu nastavenou WorkItemRevisions na výpis historie pracovních položek. Následující dotaz vrátí hodnotu Nadpis, Stav a Iterační cesta pro každou revizi pro zadanou pracovní položku.

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

Poznámka:

Kdykoli se u pracovní položky provede změna, včetně změny hodnoty pořadí zásobníku, se vytvoří revize. Další informace o historických datech najdete v tématu Použití filtrů na historická data.

Příklad dotazu:

Například následující syntaxe dotazuje revize ID =1145 v projektu Fabrikam Fiber.

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říklad odpovědi:

Odpověď vrátí data pro čtyři revize:

{
   "@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"
         }
      }
   ]
}

Dotazování dat sledování práce pomocí Analýzy

Požadavky

Filtrování pracovních položek na základě změně data

Filtrování pracovních položek na základě oblasti

Filtrování pracovních položek na základě iterace

Načtení položek pro iteraci

Filtrování pracovních položek obsahujících konkrétní značky

Filtrování pracovních položek pro konkrétní tým

Filtrování pracovních položek na základě pole s konkrétní hodnotou

Načtení týmů přiřazených v rámci cesty oblasti

Vrácení historie konkrétní pracovní položky

Váš názor

Váš názor

Další materiály

Dotazování dat sledování práce pomocí Analýzy

Požadavky

Filtrování pracovních položek na základě změně data

Filtrování pracovních položek na základě oblasti

Filtrování pracovních položek na základě iterace

Načtení položek pro iteraci

Filtrování pracovních položek obsahujících konkrétní značky

Filtrování pracovních položek pro konkrétní tým

Filtrování pracovních položek na základě pole s konkrétní hodnotou

Načtení týmů přiřazených v rámci cesty oblasti

Vrácení historie konkrétní pracovní položky

Související články

Váš názor

Váš názor

Další materiály