Gegevens voor het bijhouden van werk aggregeren met behulp van Analytics

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

U kunt werktraceringsgegevens op twee manieren aggregeren met behulp van Analytics met OData: gebruik $count voor eenvoudige totalen, of gebruik de OData-aggregatie-extensie $apply om gegroepeerde, gefilterde en berekende resultaten te retourneren als JSON.

Dit artikel bouwt voort op OData-query's maken voor Analyse en Basisquery's definiëren met behulp van OData Analytics. De voorbeelden zijn gericht op werkitemgegevens, maar dezelfde principes zijn van toepassing op andere entiteitssets. Zie voor eenvoudige tellingsquery's Haal een telling van items op.

Voorwaarden

Over de $apply-aggregatie-extensie

OData biedt een aggregatie-extensie die het $apply trefwoord introduceert voor het groeperen, filteren en berekenen van statistische waarden voor uw werktraceringsgegevens. In de volgende secties ziet u hoe u deze kunt gebruiken $apply met aggregate, groupbyen filtercompute. Zie OData-extensie voor gegevensaggregatie voor de volledige specificatie.

Gegevens aggregeren met behulp van $apply

Voeg het $apply token toe aan uw query-URL om aggregaties te activeren. De basissyntaxis is:

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

In de volgende voorbeelden ziet u veelvoorkomende aggregate bewerkingen.

De som van alle resterende hoeveelheid werk retourneren

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

De id van het laatste werkitem retourneren

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

Groepsresultaten met behulp van groupby

De groupby clausule werkt zoals SQL GROUP BY — het breekt geaggregeerde resultaten af op basis van een of meer eigenschappen.

Werkitems per type tellen

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

Retourneert een resultaat zoals:

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

Groeperen op meerdere eigenschappen

Voeg meer eigenschappen toe tussen de groupby haakjes om nauwkeurigere uitsplitsingen te maken:

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

Retourneert één rij voor elke unieke combinatie van type en status (bijvoorbeeld Bug/Actief, Bug/Vastgelegd, Productachterstanditem/Actief).

Groeperen tussen entiteiten

U kunt groeperen over gerelateerde entiteiten met behulp van navigatie-eigenschappen. Als u bijvoorbeeld gebieden per project wilt tellen:

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

Geaggregeerde resultaten filteren

Gebruik filter() binnen $apply om gegevens te beperken voor of na aggregatie. Koppel meerdere filters met behulp van / (pipe) en plaats het meest selectieve filter eerst voor de beste prestaties.

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

Meerdere velden in één aanroep aggregeren

Maak een lijst van meerdere velden binnen één aggregate component, gescheiden door komma's, om extra retouren te voorkomen.

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

Retouren

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

Eigenschappen berekenen

Stuur geaggregeerde resultaten door naar compute() om nieuwe waarden af te leiden met behulp van rekenkundige expressies (div, add, sub, mul). In het volgende voorbeeld wordt het percentage voltooide werk berekend:

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

Retouren

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

Een query voor een cumulatief stroomdiagram maken

De volgende query combineert filter, groupbyen aggregate ten opzichte van de WorkItemBoardSnapshot entiteit die is ingesteld om gegevens te produceren voor een cumulatief stroomdiagram in Power BI of 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

Deze query filtert op een datumbereik en een specifiek bord en team, groepeert op datum- en bordkolom en retourneert een telling per groep. Retouren

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

Volgende stap

Verwante inhoud

• Basisqueries definiëren met OData Analytics
• OData-query's maken voor Analyse
• Trendgegevens opvragen
• OData Analytics-queryrichtlijnen
• OData-extensie voor gegevensaggregatieversie 4.0