Partager via


Se connecter à l’aide de Fonctions Power Query et Azure DevOps

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

Le connecteur de données pour Azure DevOps inclut des fonctions Power Query M que les auteurs de requêtes peuvent utiliser. Ces fonctions peuvent gérer des exigences spécifiques à Azure DevOps, telles que l’authentification pour vous. Cet article décrit les arguments des fonctions et comment les utiliser pour se connecter à Analytics.

The VSTS. La fonction AccountContents est un remplacement de la fonction Power Query M Web.Contents. Destiné à des scénarios plus avancés, VSTS. AccountContents retourne le contenu téléchargé à partir de l’URL pour Analytics sous forme de valeur binaire. Vous pouvez l’utiliser pour appeler des API REST AzureDevOps.

Important

  • Utilisez VSTS. AccountContents uniquement pour accéder aux données qui ne sont pas disponibles dans Analytics. Il extrait des données directement à partir d’Azure DevOps et, pour protéger d’autres utilisateurs d’Azure DevOps, il est susceptible d’être limité. Consultez les sous-domaines pris en charge pour VSTS. Section AccountContents plus loin dans cet article. Pour plus d’informations sur d’autres approches, consultez la vue d’ensemble de l’intégration de Power BI.
  • VSTS. AccountContents prend uniquement en charge les données Azure Boards (éléments de travail). Le connecteur de données ne prend pas en charge d’autres types de données, tels que les pipelines. Actuellement, nous ne prévoyons pas de mettre à jour le connecteur pour prendre en charge d’autres types de données.

VSTS. AccountContents

Fonction avancée qui retourne le contenu téléchargé à partir de l’URL pour Analytics en tant que valeur binaire.

La VSTS.AccountContents fonction a les mêmes arguments, options et format de valeur de retour que Web.Contents. Pour plus d’informations, consultez Référence de formule Power Query (M) - Web.Contents.

Si vous utilisez Web.Contents déjà pour accéder aux données de suivi du travail à partir d’Analytics (API REST ou OData), vous pouvez la remplacer par VSTS.AccountContents l’utilisation de l’authentification Data Connector. Il informe Power BI que ces requêtes font référence à la même source de données. Vous pouvez combiner les données sans violer les contraintes de source de données uniques dans le service Power BI. Toutefois, VSTS.AccountContent seules les données d’Azure Boards ne peuvent pas être utilisées pour prendre en charge les requêtes pour pipelines ou d’autres services.

'VSTS. AccountContents » fournit un sous-ensemble des arguments et options disponibles via « OData.Contents ». Les limitations spécifiques sont décrites dans le tableau ci-dessous :

Arguments pour VSTS. Contenu

Argument Descriptif
url URL vers l’un des points de terminaison de service Azure DevOps.
options Enregistrement d’options pour contrôler le comportement de cette fonction.

Champs Options pour VSTS. Contenu

Terrain Descriptif
IsRetry Spécifiez cette valeur logique comme true ignore toute réponse existante dans le cache lors de l’extraction de données.
ManualStatusHandling Spécifiez cette valeur en tant que liste pour empêcher toute gestion intégrée des requêtes HTTP dont la réponse comporte l’un de ces codes d’état.
MaxSize Contrôle la taille maximale de la table qui intéresse le client. Si la demande dépasse cette limite, le serveur peut échouer immédiatement. La valeur par défaut est zéro, ce qui indique au serveur de serveur d’utiliser sa valeur par défaut.
Query Ajoutez par programmation des paramètres de requête à l’URL.
RelativePath Spécifiez cette valeur en tant que texte l’ajoute à l’URL de base avant d’effectuer la requête.
Timeout Spécifiez cette valeur en tant que durée pour modifier le délai d’expiration d’une requête HTTP. La valeur par défaut est 600 secondes.
Version Version du modèle de données. Cette option est principale pour les diagnostics.

Sous-domaines pris en charge pour VSTS. AccountContents

Actuellement, la VSTS.AccountContents() méthode fonctionne uniquement pour les sous-domaines répertoriés ci-dessous. D’autres services, tels que le service Release, ne sont pas encore pris en charge :

  • https://dev.azure.com/
  • https://analytics.dev.azure.com/
  • https://vsrm.dev.azure.com/