Créer un rapport Power BI avec une requête OData

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

Avec Power BI Desktop, vous pouvez facilement commencer à créer des rapports pour votre projet dans Azure DevOps.

Si vous n’avez pas Power BI Desktop, vous pouvez le télécharger et l’installer gratuitement.

Suivez les étapes pour créer un rapport dans Power BI Desktop qui affiche une tendance quotidienne des bogues.

• Créer une requête Power BI
• Créer des transformations Power BI
• Créer un rapport de tendance Open Bugs

Prérequis

Pour créer un rapport Power BI, vous devez respecter les critères suivants :

• Vous devez être membre d’un projet. Si vous n’avez pas encore de projet, créez-en un. Voir s’inscrire gratuitement.
• Si vous n’avez pas été ajouté en tant que membre du projet, ajoutez-le maintenant. Toute personne ayant accès au projet, à l’exception des parties prenantes, peut afficher les vues Analytics.
• Disposer de l’autorisation View Analytics définie sur Autoriser. Consultez Accorder des autorisations pour accéder à Analytics.
• Les tableaux doivent être activés. Pour le réactiver, consultez Activer ou désactiver un service Azure DevOps.
• Avoir installé Power BI Desktopmise à jour 2018octobre ou version ultérieure. Vous pouvez télécharger cette application cliente à partir de la page de téléchargement officielle Power BI Desktop.
• Avoir suivi les éléments de travail pendant une certaine période sur laquelle générer un rapport de tendance.

Créer une requête Power BI

Créez une requête Power BI pour extraire les données dans Power BI comme suit :

1. Choisissez Obtenir des données, puis requête vide.

   

2. Dans l’éditeur Power BI Query, choisissez Éditeur avancé.

   

3. La fenêtre Éditeur avancé s’ouvre.

   

4. Remplacez le contenu par la requête suivante.

   let
      Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot? "
         $apply=filter(
             WorkItemType eq 'Bug'  
         AND StateCategory ne 'Completed'  
         AND startswith(Area/AreaPath,'{areapath}')  
         AND DateValue ge {startdate} )/
         groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count))  
         &$orderby=DateValue"
        ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
   in
       Source
   

   

5. Remplacez vos valeurs dans l’exemple de requête.

   L’exemple de requête comporte des chaînes que vous devez remplacer par vos valeurs :

   • {organization} - Nom de votre organisation
   • {project} - Nom de votre projet d’équipe. Ou omettre /{project} entièrement, pour une requête inter-projets
   • {areapath} - Chemin d’accès de votre zone. Format : Project\Level1\Level2
   • {startdate} - Date à laquelle commencer votre rapport de tendance. Format : AAAA-MM-DDZ. Exemple : 2022-09-01Z représente 2022-Septembre-01. Ne placez pas entre guillemets.

   

6. Choisissez Terminé pour exécuter la requête.

   Si vous n’avez jamais connecté à votre compte, Power BI peut nécessiter l’authentification. Pour plus d’informations, consultez les options d’authentification du client.

Développer la zone, l’itération, les colonnes AssignedTo

La requête retourne plusieurs colonnes que vous devez développer avant de pouvoir les utiliser dans Power BI. Toute entité extraite à l’aide d’une $expand instruction retourne un enregistrement avec potentiellement plusieurs champs. Vous devez développer l’enregistrement pour aplatir l’entité dans ses champs. Les exemples de ces entités sont les suivants : AssignedTo, Iterationet Area.

Après avoir fermé le Éditeur avancé et tout en restant dans le Éditeur Power Query, sélectionnez le bouton Développer sur les entités que vous devez aplatir.

1. Par exemple, choisissez le bouton Développer pour Zone, sélectionnez les propriétés que vous souhaitez développer, puis choisissez OK. Ici, on choisit AreaName et AreaPath on aplatit. La AreaName propriété est similaire au champ Nom du nœud.

   

   Remarque

   Les propriétés disponibles à sélectionner dépendent des propriétés demandées pour retourner dans la requête. Si vous ne spécifiez aucune propriété, toutes les propriétés sont disponibles. Pour en savoir plus sur ces propriétés, consultez les références de métadonnées suivantes : Zones, Itérations et Utilisateurs.

2. La table contient désormais des champs d’entité.

   

3. Répétez les étapes 1 à 3 pour tous les champs représentant des entités qui ont besoin de développer. Ceux-ci apparaissent avec l’enregistrement répertorié dans la colonne de table lorsqu’ils ne sont pas expirés.

Renommer des champs et des requêtes, puis Fermer &Appliquer

Une fois terminé, vous pouvez choisir de renommer des colonnes.

1. Cliquez avec le bouton droit sur un en-tête de colonne, puis sélectionnez Renommer...

   

2. Vous pouvez également renommer la requête à partir de la requête par défaut Query1, en quelque chose de plus significatif.

   

3. Une fois terminé, choisissez Fermer & Appliquer pour enregistrer la requête et revenir à Power BI.

   

Créer le rapport

Power BI vous montre les champs sur lesquelles vous pouvez créer un rapport.

Remarque

L’exemple ci-dessous part du principe que personne n’a renommé de colonnes.

Pour un rapport simple, procédez comme suit :

1. Sélectionnez Graphique en courbes de visualisation Power BI.
2. Ajouter le champ « DateValue » à l’axe
   • Cliquez avec le bouton droit sur « DateValue » et sélectionnez « DateValue », plutôt que Hiérarchie de dates
3. Ajouter le champ « État » à la légende
4. Ajouter le champ « Nombre » aux valeurs
   • Cliquez avec le bouton droit sur le champ WorkItemId et vérifiez que Somme est sélectionnée

L’exemple de rapport :

Étapes suivantes

Créer un rapport d’ouverture de bogues

Articles connexes

• Vue d’ensemble des exemples de rapports utilisant des requêtes OData
• Construire des requêtes OData pour Analytics
• Se connecter à l’aide de requêtes Power BI et OData
• Informations de référence sur les métadonnées pour Azure Boards Analytics
• Exemples de rapports et index de référence rapide
• Ajouter un segment Team à un rapport existant