Partager via

Ajouter un segment d’équipe à un rapport Power BI

  • Article

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

Souvent, les rapports Power BI incluent des données de plusieurs équipes pour l’agrégation et la comparaison. Cet article vous montre comment ajouter un segment d’équipe à un rapport Power BI existant. Le segment d’équipe vous permet de filtrer les données du rapport par Teams, plutôt que par chemin d’accès à la zone.

Important

Le filtre d’équipe nécessite que le champ « AreaSK » soit inclus dans la requête utilisée par le rapport que vous souhaitez filtrer. Toutes les requêtes fournies dans les exemples de rapports incluent déjà « AreaSK ». Si vous avez créé votre propre requête, vérifiez qu’elle retourne « AreaSK » dans les clauses $select ou groupby().

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.

Prérequis

  • Accès : être membre d’un projet avec au moins un accès de base .
  • Autorisations : 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

Pour utiliser un segment d’équipe dans un rapport Power BI, vous devez ajouter une autre requête à votre rapport Power BI. La requête suivante retourne le mappage entre les équipes et les chemins d’accès aux zones.

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir une requête vide de données>. 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/v1.0/Areas?"
        &"$filter=startswith(AreaPath,'{areapath}') "
            &"&$select=AreaSK,AreaPath "
            &"&$expand=Teams($select=TeamName) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Chaînes de substitution et répartition 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 par {organization}Fabrikam, et non {Fabrikam}par .

  • {organization} - Nom de votre organisation
  • {project} - Nom de votre projet d’équipe ou omettre entièrement « /{projet} » pour une requête inter-projets
  • {areapath} - Chemin d’accès de votre zone. Exemple de format : Project\Level1\Level2.

Répartition des requêtes

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

Composant de requête

Description

$filter=startswith(AreaPath, '{areapath}')

Retourne toutes les équipes mappées à un chemin d’accès de zone à ou sous l’objet spécifié{areapath}. Pour inclure toutes les équipes dans un projet, omettez cette instruction.

&$select=AreaSK, AreaPath

Champs Chemin d’accès à la zone de retour, à utiliser pour le mappage.

&$expand=Teams($select=TeamName)

Retournez l’équipe associée au chemin d’accès à la zone.

(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 la colonne Teams

  1. Choisissez le bouton Développer.

    Capture d’écran montrant le bouton Développer.

  2. Sélectionnez les champs à aplatir.

    Capture d’écran montrant comment sélectionner les champs à aplatir.

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

    Capture d’écran de la table qui contient désormais des champs d’entité.

Créer une relation à l’aide de « AreaSK »

Après avoir sélectionné Fermer & Appliquer et revenir à Power BI, procédez comme suit :

  1. Dans les menus Modélisation , sélectionnez Gérer les relations.

  2. Créez une relation entre votre requête Rapport et la requête Teams. Il est probable que Power BI détecte automatiquement et crée la relation pour vous. Voici un exemple de relation entre la requête dans le rapport Open Bugs et la requête Teams :

    Capture d’écran montrant un exemple de relation entre les requêtes.

Ajouter le filtre d’équipe à un rapport existant

  1. Sur la page à laquelle vous souhaitez ajouter le filtre d’équipe, vérifiez qu’aucun graphique n’est sélectionné, puis choisissez Segment dans le volet Visualisations.

    Capture d’écran des sélections de visualisations et de champs Power BI pour le segment d’équipe.

  2. Ajouter Team.TeamName au champ.

Pour plus d’informations sur l’utilisation de segments, consultez Segments dans Power BI.