Dela via


Ansluta med funktionerna Power Query och Azure DevOps

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

Data Connector för Azure DevOps innehåller Power Query M-funktioner som frågeförfattare kan använda. Dessa funktioner kan hantera Azure DevOps-specifika krav som autentisering åt dig. Den här artikeln beskriver argumenten för funktionerna och hur du använder dem för att ansluta till Analytics.

The VSTS. Funktionen AccountContents ersätter Power Query M-funktionen Web.Contents. Avsedd för mer avancerade scenarier, VSTS. AccountContents returnerar innehållet som laddats ned från URL:en för Analys som ett binärt värde. Du kan använda den för att anropa REST-API:er för AzureDevOps.

Viktigt

  • Använd VSTS. AccountContents endast för att komma åt data som inte är tillgängliga i Analytics. Den hämtar data direkt från Azure DevOps och för att skydda andra Azure DevOps-användare är de känsliga för begränsningar. Se underdomäner som stöds för VSTS. Avsnittet AccountContents senare i den här artikeln. Information om andra metoder finns i Översikt över Power BI-integrering.
  • VSTS. AccountContents stöder endast Azure Boards-data (arbetsobjekt). Dataanslutningsappen stöder inte andra datatyper, till exempel pipelines. För närvarande har vi inga planer på att uppdatera anslutningsappen för att stödja andra datatyper.

VSTS. AccountContents

Avancerad funktion som returnerar innehållet som laddats ned från URL:en för Analys som ett binärt värde.

Funktionen VSTS.AccountContents har samma argument, alternativ och returvärdeformat som Web.Contents. Mer information finns i formelreferens för Power Query (M) – Web.Contents.

Om du redan använder Web.Contents för att komma åt arbetsspårningsdata från Analytics (REST API eller OData) kan du ersätta dem med för att använda autentisering med VSTS.AccountContents Data Connector. Den informerar Power BI om att dessa begäranden refererar till samma datakälla. Du kan kombinera data utan att bryta mot begränsningarna för enskilda datakällor i Power BI-tjänsten. Stöder dock VSTS.AccountContent endast data från Azure Boards och kan inte användas för att stödja frågor för pipelines eller andra tjänster.

'VSTS. AccountContents innehåller en delmängd av argumenten och alternativen som är tillgängliga via OData.Contents. De specifika begränsningarna beskrivs i tabellen nedan:

Argument för VSTS. Innehållet

Argument Description
url URL till en av Azure DevOps-tjänstslutpunkterna.
options En alternativpost för att styra funktionens beteende.

Alternativfält för VSTS. Innehållet

Fält Beskrivning
IsRetry Om du anger det här logiska värdet som sant ignoreras alla befintliga svar i cacheminnet när data hämtas.
ManualStatusHandling Ange det här värdet som en lista förhindrar inbyggd hantering av HTTP-begäranden vars svar har någon av dessa statuskoder.
MaxSize Styr den maximala storleken på tabellen som klienten är intresserad av. Om begäran överskrider den här gränsen kan servern misslyckas omedelbart. Standardvärdet är noll, vilket talar om för serverservern att använda standardvärdet.
Query Lägg programmatiskt till frågeparametrar till URL:en.
RelativePath Ange det här värdet som text som lägger till det i bas-URL:en innan du gör begäran.
Timeout Ange det här värdet som en varaktighet som ändrar tidsgränsen för en HTTP-begäran. Standardvärdet är 600 sekunder.
Version Version av datamodellen. Det här alternativet är primärt för diagnostik.

Underdomäner som stöds för VSTS. AccountContents

VSTS.AccountContents() För närvarande fungerar metoden endast för de underdomäner som anges nedan. Andra tjänster, till exempel versionstjänsten, stöds ännu inte:

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