Agréger des données de suivi de travail à l’aide d’Analytics

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

Vous pouvez agréger des données de suivi de travail à l’aide d’Analytics avec OData de deux manières : utiliser $count pour des totaux simples ou utiliser l’extension d’agrégation OData $apply pour retourner des résultats groupés, filtrés et calculés au format JSON.

Cet article s’appuie sur construire des requêtes OData pour Analytics et définir des requêtes de base à l’aide d’OData Analytics. Les exemples se concentrent sur les données d’élément de travail, mais les mêmes principes s’appliquent à d’autres jeux d’entités. Pour les requêtes de nombre simple, consultez Obtenir le nombre d’éléments.

Conditions préalables

À propos de l’extension d’agrégation $apply

OData fournit une extension d’agrégation qui introduit le mot clé $apply pour le regroupement, le filtrage et le calcul des valeurs d’agrégation sur vos données de suivi du travail. Les sections suivantes montrent comment utiliser $apply avec aggregate, , groupbyfilteret compute. Pour obtenir la spécification complète, consultez l’extension OData pour l’agrégation de données.

Agréger des données à l’aide de $apply

Ajoutez le $apply jeton à votre URL de requête pour déclencher des agrégations. La syntaxe de base est la suivante :

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

Les exemples suivants montrent les opérations courantes aggregate .

Renvoie la somme de tout le travail restant

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

Renvoyer le dernier identifiant d’élément de travail

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

Résultats de groupe à l’aide de groupby

La groupby clause fonctionne comme SQL GROUP BY : elle décompose les résultats agrégés par une ou plusieurs propriétés.

Compter les éléments de travail par type

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

Retourne un résultat tel que :

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

Regrouper par plusieurs propriétés

Ajoutez d’autres propriétés entre groupby parenthèses pour créer des répartitions plus fines :

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

Retourne une ligne pour chaque combinaison unique de type et d’état (par exemple, Bug/Active, Bug/Commit, Product Backlog Item/Active).

Regrouper à travers les entités

Vous pouvez regrouper des entités associées à l’aide des propriétés de navigation. Par exemple, pour compter les zones par projet :

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

Filtrer les résultats agrégés

Utilisez filter() à l'intérieur de $apply pour affiner les données avant ou après l’agrégation. Chaînez plusieurs filtres à l'aide de / (pipe) et placez le filtre le plus sélectif en premier pour des performances optimales.

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

Agréger plusieurs champs dans un seul appel

Répertoriez plusieurs champs à l’intérieur d’une clause unique aggregate , séparées par des virgules, pour éviter des allers-retours supplémentaires.

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

Returns:

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

Calculer les propriétés calculées

Acheminer les résultats agrégés dans compute() pour dériver de nouvelles valeurs à l’aide d’expressions arithmétiques (div, add, sub, mul). L’exemple suivant calcule le pourcentage de travail terminé :

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

Returns:

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

Créer une requête de diagramme de flux cumulé

La requête suivante combine filter, groupbyet aggregate par rapport à l’ensemble WorkItemBoardSnapshot d’entités pour produire des données pour un diagramme de flux cumulé dans Power BI ou 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

Cette requête applique des filtres sur une plage de dates, ainsi que sur un tableau et une équipe spécifiques, regroupe les résultats par date et par colonne du tableau, et retourne un décompte par groupe. Returns:

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

Étape suivante

Contenu connexe

• Définir des requêtes de base à l’aide d’OData Analytics
• Construire des requêtes OData pour Analytics
• Données de tendance des requêtes
• Instructions relatives aux requêtes OData Analytics
• Extension OData pour l’agrégation de données version 4.0