Aggregare i dati di rilevamento del lavoro tramite Analytics

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

È possibile aggregare i dati di rilevamento del lavoro usando Analytics con OData in due modi: usare $count per i totali semplici o usare l'estensione di aggregazione OData $apply per restituire risultati raggruppati, filtrati e calcolati come JSON.

Questo articolo si basa su Costruire query OData per Analisi e Definire query di base usando OData Analytics. Gli esempi si concentrano sui dati degli elementi di lavoro, ma gli stessi principi si applicano ad altri set di entità. Per le query di conteggio semplici, vedere Ottenere un conteggio degli elementi.

Prerequisiti

Informazioni sull'estensione di aggregazione $apply

OData fornisce un'estensione di aggregazione che introduce la $apply parola chiave per il raggruppamento, il filtro e l'elaborazione di valori aggregati sui dati di rilevamento del lavoro. Le sezioni seguenti illustrano come usare $apply con aggregate, groupby, filtere compute. Per la specifica completa, vedere Estensione OData per l'aggregazione dei dati.

Aggregare i dati usando $apply

Aggiungere il token $apply all'URL della query per attivare le aggregazioni. La sintassi di base è:

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

Negli esempi seguenti vengono illustrate le operazioni comuni aggregate .

Restituisci la somma di tutto il lavoro rimanente

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

Restituire l'ultimo identificatore dell'elemento di lavoro

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

Raggruppare i risultati usando groupby

La groupby clausola funziona come SQL GROUP BY . Suddivide i risultati aggregati in base a una o più proprietà.

Contare gli elementi di lavoro per tipo

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

Restituisce un risultato simile al seguente:

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

Raggruppare per più proprietà

Aggiungere altre proprietà tra groupby parentesi per creare suddivisioni più dettagliate:

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

Restituisce una riga per ogni combinazione univoca di tipo e stato ,ad esempio Bug/Active, Bug/Committed, Product Backlog Item/Active.

Raggruppare le entità

È possibile raggruppare le entità correlate usando le proprietà di navigazione. Ad esempio, per contare le aree per progetto:

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

Filtro dei risultati aggregati

Usare filter() all'interno $apply per restringere i dati prima o dopo l'aggregazione. Concatenare più filtri usando / (pipe) e posizionare il filtro più selettivo per ottenere prestazioni ottimali.

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

Aggregare più campi in una singola chiamata

Elencare più campi all'interno di una singola aggregate clausola, separati da virgole, per evitare round trip aggiuntivi.

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

Restituisce:

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

Calcolare le proprietà calcolate

Inviare tramite pipe i risultati aggregati in compute() per derivare nuovi valori usando espressioni aritmetiche (div, add, sub, mul). Nell'esempio seguente viene calcolata la percentuale di lavoro completata:

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

Restituisce:

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

Costruire una query per un diagramma di flusso cumulativo

La query seguente combina filter, groupby, e aggregate sull'insieme di entità WorkItemBoardSnapshot per produrre dati per un diagramma di flusso cumulativo in Power BI o 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

Questa query filtra in base a un intervallo di date e a un gruppo specifico, raggruppa per colonna data e scheda e restituisce un conteggio per gruppo. Restituisce:

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

Passo successivo

Contenuti correlati

• Definire query di base con OData Analytics
• Creazione di query OData per l'analisi dati
• Eseguire query sui dati di tendenza
• Linee guida per le query di OData Analytics
• Estensione OData per l'aggregazione dei dati versione 4.0