Exemple de rapport de diagramme de flux cumulé (CFD)

2025-04-04

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

Cet article vous montre comment afficher les stories CFD d’une équipe spécifiée. Ces données sont également disponibles via le graphique intégré et le widget de tableau de bord. Pour plus d’informations sur ces options, consultez Afficher et configurer un diagramme de flux cumulatif.

Un exemple est illustré dans l’image suivante qui montre un nombre d’histoires utilisateur au fil du temps dans les états Recherche, Commit, In Progress et In Review . Le pointage sur une date fournit des informations sur les données de cette date.

Capture d'écran du rapport Power BI Cumulative Flow stacked area chart, colonnes triées dans l'ordre des colonnes du tableau.

Pour plus d’informations sur le flux cumulatif, consultez les conseils sur le flux cumulatif, le temps de traitement et le temps de cycle et les conseils sur le flux cumulatif, le temps de traitement et le temps de cycle.

Remarque

Cet article part du principe que vous lisez la vue d’ensemble des exemples de rapports à l’aide de requêtes OData et que vous avez une compréhension de base de Power BI.

Catégorie	Spécifications
Niveaux d’accès	- Membre du projet. - Au moins un accès de base (Basic).
Permissions	Par défaut, les membres du projet ont l’autorisation d’interroger Analytics et de créer des vues. Pour plus d’informations sur les autres prérequis concernant l’activation du service et des fonctionnalités et les activités de suivi des données générales, consultez Autorisations et conditions préalables pour accéder à Analytics.

Exemples de requêtes

Les requêtes de cette section prennent en charge le retour des données de flux cumulées pour les récits utilisateur. Ces requêtes spécifient l’ensemble WorkItemBoardSnapshot d’entités, car elles renvoient des données calculées pour le tableau de bord dans le temps.

Remarque

Pour déterminer les propriétés disponibles à des fins de filtre ou de rapport, consultez Informations de référence sur les métadonnées pour Azure Boards. Vous pouvez filtrer vos requêtes ou retourner les propriétés en utilisant n'importe quelle valeur Property sous un EntityType ou les valeurs NavigationPropertyBinding Path disponibles avec un EntitySet. Chaque EntitySet correspond à un EntityType. Pour plus d’informations sur le type de données de chaque valeur, passez en revue les métadonnées fournies pour le type de données correspondant EntityType.

Requête Power BI
Requête OData

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir les données>Requête vide. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/WorkItemBoardSnapshot?"
        &"$apply=filter( "
            &"Team/TeamName eq '{teamname}' "
            &"and BoardName eq 'Stories'  "
            &"and DateValue ge {startdate} "
        &") "
        &"/groupby( "
            &"(DateValue,ColumnName,LaneName,State,WorkItemType,AssignedTo/UserName,Area/AreaPath),  "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Vous pouvez utiliser le code de requête OData suivant pour modifier ou tester la requête avant de l’utiliser dans Power BI. Pour plus d’informations, consultez Se connecter à l’aide de requêtes Power BI et OData.

https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/WorkItemBoardSnapshot?
        $apply=filter(
            Team/TeamName eq '{teamname}'
            and BoardName eq 'Stories' 
            and DateValue ge {startdate}
        )
        /groupby(
            (DateValue,ColumnName,LaneName,State,WorkItemType,AssignedTo/UserName,Area/AreaPath), 
            aggregate($count as Count)
        )

Chaînes de substitution et décomposition des requêtes

Remplacez les chaînes suivantes par vos valeurs. N’incluez pas de crochets {} avec votre substitution. Par exemple, si le nom de votre organisation est « Fabrikam », remplacez {organization} par Fabrikam, et non par {Fabrikam}.

{organization} - Nom de votre organisation
{project} - Nom de votre projet d’équipe ou omettre entièrement « /{projet} » pour une requête inter-projets

{teamname} - Nom de l'équipe chargée d'afficher les données CFD

{startdate} - Commencez votre rapport pour les éléments terminés le ou après une date donnée avec le format suivant : YYYY-MM-DDZ. Par exemple : 2022-04-01Z représente 2022-avril-01. Ne placez pas entre guillemets.

Répartition des requêtes

Le tableau suivant décrit chaque partie de la requête.

Composant de requête

Description

$apply=filter(

Démarre la clause filter().

Team/TeamName eq '{teamname}'

Retournez les articles pour une équipe spécifique.

and BoardName eq 'Stories'

Retourner des éléments dans le backlog des histoires. Vous pouvez spécifier d'autres noms de backlogs, tels que Epics ou Features. Spécifiez le niveau de backlog qui correspond au processus sélectionné pour votre projet.

and DateValue ge {startdate}

Retourne des données à partir de la date spécifiée, par exemple, 2022-04-01Z indique le 1er avril 2022 ou le 1er juillet 2019.

)

Fermer la clause filter().

/groupby(

Démarre la clause groupby().

(DateValue, ColumnName, LaneName, State, WorkItemType,AssignedTo/UserName,Area/AreaPath),

Regroupez par DateValue (utilisé pour la tendance) ColumnNameet toutes les autres propriétés sur lesquelles vous souhaitez créer un rapport. Ici, nous incluons LaneName pour permettre le filtrage par couloir.

aggregate($count as Count)

Agrégation sous forme de nombre d'éléments de travail.

)

Ferme la clause groupby().

(Facultatif) Renommer la requête

Vous pouvez renommer l’étiquette de requête par défaut , Query1, en quelque chose de plus significatif. Entrez simplement un nouveau nom dans le volet Paramètres de requête .

Capture d’écran des options de menu de requête Power BI, renommer la requête.

Développer les colonnes dans l’éditeur Power Query

Dans le Éditeur Power Query, choisissez la requête avec les données que vous souhaitez transformer. Pour un graphique CFD, vous devrez étendre les colonnes Area, Iteration et AssignedTo. Pour en savoir plus, consultez les sections suivantes dans Transformez les données d'Analytics pour générer des rapports Power BI, développez les colonnes.

(Facultatif) Renommer des champs

Une fois que vous avez développé les colonnes, vous pouvez renommer un ou plusieurs champs. Par exemple, vous pouvez renommer la colonne AreaPath en Area Path. Pour savoir comment procéder, consultez Renommer les champs de colonnes.

Fermez la requête et appliquez vos modifications

Une fois que vous avez terminé toutes vos transformations de données, choisissez Fermer & Appliquer dans le menu Accueil pour enregistrer la requête et revenir à l’onglet Rapport dans Power BI.

Créez le graphique à aires empilées

Dans l’exemple suivant, la requête a été renommée en CFD, mais aucune colonne n’a été renommée.

Dans Power BI, choisissez le graphique en aires empilées sous Visualisations.
Ajouter DateValue à l’axe, puis cliquer avec le bouton DateValue droit et sélectionner DateValue, plutôt que Date Hierarchy.
Ajouter Count aux valeurs.
Ajouter ColumnName à la légende.
Dans le volet Filtres , développez ColumnNameet sélectionnez uniquement les valeurs que vous souhaitez afficher dans le graphique. Par exemple, vous souhaiterez peut-être désélectionner Nouveau, Proposé, Terminé ou Fermé.

L’exemple de rapport affiche les colonnes dans l’ordre alphabétique. Toutefois, l’ordre préféré consiste à trier les données en fonction de l’ordre de colonne ou de l’ordre progressif.

Capture d'écran d'un exemple de rapport Power BI sur les flux cumulés, les colonnes étant triées par ordre alphabétique.

Trier les colonnes dans l’ordre progressif

Pour trier les colonnes de graphique dans l’ordre spécifique au tableau, procédez comme suit :

Créez une requête dans Power BI conformément aux requêtes suivantes. Lorsque vous avez terminé, renommez la requête en ColumnOrder.

Requête Power BI
Requête OData

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir des données>Nouvelle Requête. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/BoardLocations?"
        &"$apply=filter( "
            &"Team/TeamName eq '{teamname}'  "
            &"and BoardName eq 'Stories'  "
            &"and IsCurrent eq true "
        &") "
        &"/groupby ((ColumnName,ColumnOrder)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/BoardLocations?
        $apply=filter(
            Team/TeamName eq '{teamname}' 
            and BoardName eq 'Stories' 
            and IsCurrent eq true
        )
        /groupby ((ColumnName,ColumnOrder))

Trier le rapport dans l’ordre correct

Dans Power BI, développez la requête ColumnOrder et sélectionnez ColumnName.
Sélectionnez Outils de colonne, puis triez par colonne , puis choisissez ColumnOrder.
Sélectionnez le menu Modélisation , puis gérez les relations. Vérifiez qu’il existe une relation entre CFD.ColumnName et ColumnOrder.ColumnName. Il est probable que la relation a été détectée automatiquement.
Dans le rapport créé ci-dessus, dans la légende, remplacez CFD.ColumnName par ColumnOrder.ColumnNameLégende.

Le rapport s’actualise avec des colonnes triées dans le même ordre que celui utilisé par la carte.

Remarque

Si des éléments de travail se trouvaient dans une colonne qui a été supprimée, ils apparaissent sous la forme « Vide » dans le rapport ci-dessus.

Partager via

Exemple de rapport de diagramme de flux cumulé (CFD)

Exemples de requêtes

Chaînes de substitution et décomposition des requêtes

Répartition des requêtes

(Facultatif) Renommer la requête

Développer les colonnes dans l’éditeur Power Query

(Facultatif) Renommer des champs

Fermez la requête et appliquez vos modifications

Créez le graphique à aires empilées

Trier les colonnes dans l’ordre progressif

Trier le rapport dans l’ordre correct

Articles connexes

Commentaires

Ressources supplémentaires