Partager via


Accéder aux données via Excel

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

Vous pouvez accéder aux données via Excel, générer des rapports, puis publier les graphiques dans Power BI ou utiliser le fichier Excel comme base pour les rapports Power BI. À ce stade, vous avez besoin d’autres informations d’identification activées pour accéder à Data Analytics via Excel.

Conditions préalables

Catégorie Spécifications
Niveaux d’accès - Membre du projet.
- Au moins un accès de base (Basic).
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 conditions préalables 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.

Remarque

Le service Analytics est automatiquement activé et pris en charge en production pour tous les services dans Azure DevOps Services. L’intégration de Power BI et l’accès au flux OData du service Analytics sont généralement disponibles. Vous êtes encouragé à utiliser le flux OData Analytics et à fournir des commentaires.

Les données disponibles dépendent de la version. La dernière version prise en charge de l’API OData est v2.0, et la dernière version préliminaire est v4.0-preview. Pour plus d’informations, consultez gestion des versions de l’API OData.

Remarque

Le service Analytics est automatiquement installé et pris en charge en production pour toutes les nouvelles collections de projets pour Azure DevOps Server 2020 et versions ultérieures. L’intégration de Power BI et l’accès au flux OData du service Analytics sont généralement disponibles. Vous êtes encouragé à utiliser le flux OData Analytics et à fournir des commentaires. Si vous effectuez une mise à niveau à partir d’Azure DevOps Server 2019, vous pouvez installer le service Analytics pendant la mise à niveau.

Les données disponibles dépendent de la version. La dernière version prise en charge de l’API OData est v2.0, et la dernière version préliminaire est v4.0-preview. Pour plus d’informations, consultez gestion des versions de l’API OData.

  1. Ouvrez Excel 2016 ou version ultérieure, y compris Excel pour Microsoft 365.

    Si vous utilisez une version antérieure d’Excel, installez le complément Power Query à partir de Microsoft Power Query pour Excel.

  2. Créez un classeur vide.

  3. Dans l’onglet Données , sélectionnez Nouvelle requête>à partir d’autres sources>à partir du flux OData.

    Capture d’écran montrant Excel Obtenir des données.

  4. Entrez l’URL au format suivant, puis sélectionnez OK :

     https://analytics.dev.azure.com/{Organization_Name}/_odata/{version}/
    

    Si OrganizationName est fabrikam et que la version est v1.0, l’URL est https://analytics.dev.azure.com/fabrikam/_odata/v1.0/.

    Capture d’écran montrant le flux OData sélectionné.

    Remarque

    Vous pouvez également entrer l’URL avec ProjectName spécifié qui filtre les résultats selon le projet spécifié concernant toutes les entités liées à ce projet.

    https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/

     https://{ServerName}:{Port}/tfs/{CollectionName}/_odata/{version}/
    

    Si CollectionName est fabrikam et que la version est v1.0, l’URL est https://{ServerName}:{Port}/tfs/fabrikam/_odata/{v1.0}/.

    Sélectionner le flux OData

    Remarque

    Vous pouvez également entrer l’URL avec ProjectName spécifié qui filtre les résultats selon le projet spécifié concernant toutes les entités liées à ce projet.

    https://{ServerName}:{Port}/tfs/{CollectionName}/{ProjectName}/_odata/{version}/

  5. Vous êtes invité à vous authentifier auprès du service. Si ce n’est déjà fait, consultez les options d’authentification du client.

  6. Sélectionnez une entité unique pour récupérer les données ou cochez Sélectionner plusieurs éléments, puis choisissez les données à récupérer.

    Navigateur Excel

    À ce stade, si vous sélectionnez Charger, Excel charge toutes les données de chaque entité dans Power Query. Toutefois, il peut s’agir de plus de données que vous n’en avez besoin ou plus qu’Excel peut gérer.

    Procédez comme suit pour filtrer les données :

    1. Sélectionnez l’entité que vous souhaitez filtrer et choisissez Modifier pour ouvrir l’Éditeur de requête.
    2. Pour chaque colonne que vous souhaitez filtrer, sélectionnez la colonne et définissez vos critères de filtre.
    3. Une fois que vous avez appliqué tous les filtres nécessaires, sélectionnez Fermer & Appliquer dans le coin supérieur gauche.

    Cette action charge uniquement les données filtrées dans Power Query, ce qui le rend plus gérable et pertinent pour vos besoins.

    Importante

    Ne sélectionnez aucune entité comportant le nom Snapshot dans celui-ci. Ces entités contiennent l’état de chaque élément de travail pour chaque jour depuis la création de chaque élément de travail. Pour les référentiels de toute taille, cela entraîne des dizaines, voire des centaines de millions d’éléments de travail, qui ne se chargent pas correctement. Pour effectuer une analyse des tendances, limitez l’étendue des données récupérées à des éléments et des délais spécifiques, puis extrayez ces informations avec une requête OData distincte.

    En guise d’alternative au chargement des données dans Power Query, vous pouvez choisir la flèche déroulante en regard de Charger et sélectionner Charger vers. Cette action fournit les options suivantes :

    • Charger les données dans une table dans Power Query
    • Créer une connexion sans charger les données, différer le chargement des données jusqu’à une date ultérieure
    • Charger les données dans une feuille de calcul, qui charge une entité par feuille de calcul
    • Charger les données dans un modèle, que vous pouvez sélectionner avec les autres options, pour charger les données dans PowerPivot

Pour plus d’informations, consultez la documentation Excel.

Gestion des relations

Par défaut, lorsque des données de base sont retournées à partir d’Analytics, les données sont liées comme illustré dans la figure suivante :

Capture d’écran montrant les relations d’entité.

Les balises, Teams et utilisateurs ne sont liés à aucune des autres données en raison de la nature de leurs relations. Ces entités sont connectées par des relations plusieurs-à-plusieurs, qui sont difficiles à gérer dans ces modèles, ou par plusieurs relations entre les entités. Par exemple, les utilisateurs et les éléments de travail sont liés par le biais de champs tels que Affecté à, Créé par et Modifié par.

La gestion de plusieurs relations peut être effectuée assez simplement. Par exemple, dans le modèle par défaut, vous pouvez modifier la requête, sélectionner la AssignedTo colonne de la WorkItems table et développer la colonne pour inclure toutes les données de la Users table. Répétez également ce processus pour les colonnes CreatedBy et ChangedBy. Cette approche évite d’avoir plusieurs liens d’une table à une autre, ce qui n’est pas autorisé.