Se connecter à l’aide des fonctions Power Query et Azure DevOps

  • Article

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

Le connecteur de données pour Azure DevOps inclut Power Query fonctions 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 remplace Power Query fonction M Web.Contents. Destiné aux scénarios plus avancés, VSTS. AccountContents retourne le contenu téléchargé à partir de l’URL pour Analytics sous la forme d’une 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 les données directement d’Azure DevOps et, pour protéger les autres utilisateurs d’Azure DevOps, il est vulnérable à la limitation. Consultez les sous-domaines pris en charge pour VSTS. Section AccountContents plus loin dans cet article. Pour plus d’informations sur les autres approches, consultez la vue d’ensemble de l’intégration de Power BI.
  • VSTS. AccountContents prend en charge uniquement 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 n’avons pas prévu 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 Power Query (M) Formula Reference - 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 les VSTS.AccountContents remplacer par pour utiliser l’authentification Data Connector. Il informe Power BI que ces demandes 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 prend uniquement en charge les données de Azure Boards et ne peut pas être utilisé pour prendre en charge les requêtes pour les 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 Description
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 d’options pour VSTS. Contenu

Champ Description
IsRetry Spécifiez cette valeur logique, car true ignore toute réponse existante dans le cache lors de l’extraction des données.
ManualStatusHandling Spécifiez cette valeur car une liste empêche toute gestion intégrée pour les requêtes HTTP dont la réponse a l’un de ces codes status.
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 serveur d’utiliser sa valeur par défaut.
Query Ajouter des paramètres de requête par programme à l’URL.
RelativePath Spécifiez cette valeur lorsque le texte l’ajoute à l’URL de base avant d’effectuer la demande.
Timeout Spécifiez cette valeur, car une durée modifie 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 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/