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 Analytique vues.
- Définissez l’autorisation View Analytique sur Autoriser. Consultez Accorder des autorisations pour accéder à Analytique.
- Les tableaux doivent être activés. Pour le réactiver, consultez Activer ou désactiver un service Azure DevOps.
- Vous avez installé La mise à jour d’octobre 2018 de Power BI Desktop ou une 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.
- Vous devez être membre d’un projet. Si vous n’avez pas encore de projet, créez-en un.
- 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 Analytique vues.
- Vous avez activé ou installé Analytique. Vous devez être propriétaire du compte ou membre du groupe Administrateurs de collection de projets pour ajouter des extensions ou activer le service.
- Les tableaux doivent être activés. Pour le réactiver, consultez Activer ou désactiver un service Azure DevOps.
- Définissez l’autorisation View Analytique sur Autoriser. Consultez Accorder des autorisations pour accéder à Analytique.
- Vous avez installé La mise à jour d’octobre 2018 de Power BI Desktop ou une 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 :
Choisissez Obtenir des données, puis requête vide.
Dans l’éditeur Power BI Query, choisissez Éditeur avancé.
La fenêtre Éditeur avancé s’ouvre.
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
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.
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
, Iteration
et 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.
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
etAreaPath
on aplatit. LaAreaName
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 plus d’informations sur ces propriétés, consultez les références de métadonnées suivantes : Zones, Itérations et Utilisateurs.
La table contient désormais des champs d’entité.
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.
Cliquez avec le bouton droit sur un en-tête de colonne, puis sélectionnez Renommer...
Vous pouvez également renommer la requête à partir de la requête par défaut Query1, en quelque chose de plus significatif.
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 :
- Sélectionnez Graphique en courbes de visualisation Power BI.
- Ajouter le champ « DateValue » à l’axe
- Cliquez avec le bouton droit sur « DateValue » et sélectionnez « DateValue », plutôt que Hiérarchie de dates
- Ajouter le champ « État » à la légende
- 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
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