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

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

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, téléchargez et installez-le gratuitement.

Prérequis

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
      The query you provided has a syntax issue due to the placement of double quotes. Specifically, the `$apply` and `$orderby` parameters should be part of the URL string, but they are not correctly concatenated. Here is the corrected version:
   
   

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

1. 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.

   

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

   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é l’éditeur avancé et en restant dans l’éditeur Power Query, sélectionnez le bouton Développer sur les entités dont vous avez besoin pour 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 à retourner dans la requête. Si vous ne spécifiez aucune propriété, toutes les propriétés sont disponibles. Pour plus d’informations sur ces propriétés, consultez les références de métadonnées suivantes : Zones, Itérations et Utilisateurs.

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

   

3. Répétez les étapes 1 à 3 pour tous les champs représentant des entités qui doivent être étendues. Ces champs s'affichent avec Enregistrement répertorié dans la colonne de table quand ils ne sont pas développés.

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

Lorsque vous avez 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.

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 », puis 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

Exemple de rapport :

Étapes suivantes

Articles connexes

• Explorer des exemples de rapports à l’aide de requêtes OData
• Construire des requêtes OData pour Analytics
• Se connecter à Power BI à l’aide de requêtes OData
• Consultez les métadonnées pour Azure Boards Analytics
• Accéder à des exemples de rapports et à un index de référence rapide
• Ajouter un filtre d'équipe à un rapport existant