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.

La fonction VSTS.AccountContents remplace 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. Elle extrait directement les données depuis Azure DevOps et, afin de préserver les autres utilisateurs d’Azure DevOps, elle peut faire l’objet d’une limitation de débit. 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 déjà Web.Contents pour accéder aux données de suivi du travail à partir d’Analytics (API REST ou OData), vous pouvez le remplacer par VSTS.AccountContents pour utiliser l’authentification du connecteur de données. 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 ne prend en charge que les données d’Azure Boards et ne peut pas être utilisé pour prendre en charge les requêtes concernant 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.Contents

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 d'options pour VSTS.Contents

Champ Descriptif
IsRetry Spécifiez cette valeur logique comme `true`, ce qui 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 du tableau 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 pour qu'elle soit ajoutée à 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/

Contenu connexe

  • Last updated on