Aggregera arbetsspårningsdata med hjälp av Analys

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Du kan aggregera arbetsspårningsdata med hjälp av Analys med OData på två sätt: använda $count för enkla summor eller använda OData-aggregeringstillägget $apply för att returnera grupperade, filtrerade och beräknade resultat som JSON.

Den här artikeln bygger på Skapa OData-frågor för analys och Definiera grundläggande frågor med OData Analytics. Exemplen fokuserar på arbetsobjektsdata, men samma principer gäller för andra entitetsuppsättningar. För enkla räkningsfrågor, se Hämta ett antal objekt.

Förutsättningar

Om $apply aggregeringsutökning

OData tillhandahåller ett aggregeringstillägg som introducerar nyckelordet $apply för gruppering, filtrering och beräkning av aggregerade värden över dina arbetsspårningsdata. Följande avsnitt visar hur du använder $apply med aggregate, groupby, filteroch compute. Fullständig specifikation finns i OData-tillägget för dataaggregering.

Aggregera data med hjälp av $apply

Lägg till token i $apply fråge-URL:en för att utlösa aggregeringar. Den grundläggande syntaxen är:

/{entitySetName}?$apply=aggregate({columnToAggregate} with {aggregationType} as {newColumnName})

I följande exempel visas vanliga aggregate åtgärder.

Returnera summan av allt återstående arbete

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=aggregate(RemainingWork with sum as SumOfRemainingWork)

Returnera den senaste arbetsobjektidentifieraren

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=aggregate(WorkItemId with max as MaxWorkItemId)

Gruppera resultat med hjälp av groupby

Satsen groupby fungerar som SQL GROUP BY – den delar upp aggregerade resultat med en eller flera egenskaper.

Räkna arbetsobjekt efter typ

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=groupby((WorkItemType), aggregate($count as Count))

Returnerar ett resultat som:

{
  "value": [
    { "WorkItemType": "Bug", "Count": 3 },
    { "WorkItemType": "Product Backlog Item", "Count": 13 }
  ]
}

Gruppera efter flera egenskaper

Lägg till fler egenskaper inom groupby parenteserna för att skapa finare detaljerade uppdelningar:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=groupby((WorkItemType, State), aggregate($count as Count))

Returnerar en rad för varje unik kombination av typ och tillstånd (till exempel Bug/Active, Bug/Committed, Product Backlog Item/Active).

Gruppera mellan entiteter

Du kan gruppera mellan relaterade entiteter med hjälp av navigeringsegenskaper. Om du till exempel vill räkna områden per projekt:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/Areas?
  $apply=groupby((Project/ProjectName), aggregate($count as Count))

Filtrera aggregerade resultat

Använd filter() inuti $apply för att begränsa data före eller efter aggregering. Länka flera filter med hjälp / av (pipe) och placera det mest selektiva filtret först för bästa prestanda.

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=
    filter(Iteration/IterationName eq 'Sprint 89')/
    filter(WorkItemType eq 'User Story')/
    groupby((State), aggregate($count as Count))

Aggregera flera fält i ett enda anrop

Lista flera fält i en enda aggregate sats, avgränsade med kommatecken, för att undvika extra tur och retur.

/WorkItems?$apply=aggregate(CompletedWork with sum as SumOfCompletedWork, RemainingWork with sum as SumOfRemainingWork)

Returnerar:

{
  "value": [
    { "SumOfCompletedWork": 1525841.29, "SumOfRemainingWork": 73842.39 }
  ]
}

Beräkna beräknade egenskaper

Skicka aggregerade resultat till compute() för att härleda nya värden med hjälp av aritmetiska uttryck (div, , addsub, mul). I följande exempel beräknas procentandelen arbete som slutförts:

/WorkItems?$apply=aggregate(CompletedWork with sum as SumOfCompletedWork, RemainingWork with sum as SumOfRemainingWork)/compute(SumOfCompletedWork div (SumOfCompletedWork add SumOfRemainingWork) as DonePercentage)

Returnerar:

{
  "value": [
    { "DonePercentage": 0.9676, "SumOfCompletedWork": 1514698.34, "SumOfRemainingWork": 50715.95 }
  ]
}

Skapa en fråga för kumulativt flödesdiagram

Följande fråga kombinerar filter, groupbyoch aggregate mot entitetsuppsättningen WorkItemBoardSnapshot för att skapa data för ett kumulativt flödesdiagram i Power BI eller Excel.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItemBoardSnapshot?
  $apply=
    filter(DateValue gt 2015-07-16Z and DateValue le 2015-08-16Z)/
    filter(BoardName eq 'Stories' and Team/TeamName eq '{teamName}')/
    groupby((DateValue, ColumnName), aggregate(Count with sum as Count))
  &$orderby=DateValue

Den här frågan filtrerar till ett datumintervall och ett specifikt styrelse- och team, grupperar efter datum och brädkolumn och returnerar ett antal per grupp. Returnerar:

{
  "value": [
    { "DateValue": "2015-07-16T00:00:00-07:00", "ColumnName": "Completed", "Count": 324 },
    { "DateValue": "2015-07-16T00:00:00-07:00", "ColumnName": "In Progress", "Count": 5 }
  ]
}

Nästa steg

Relaterat innehåll

• Definiera grundläggande frågor med OData Analytics
• Skapa OData-frågor för analys
• Fråga trenddata
• OData Analytics-frågeriktlinjer
• OData-Tillägg för Dataaggregation version 4.0