Verbinden mit Power Query- und Azure DevOps-Funktionen

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

Der Datenconnector für Azure DevOps umfasst Power Query M-Funktionen, die Abfrageautoren verwenden können. Diese Funktionen können azure DevOps spezifische Anforderungen wie die Authentifizierung für Sie verarbeiten. In diesem Artikel werden die Argumente für die Funktionen und deren Verwendung zum Herstellen einer Verbindung mit Analytics beschrieben.

The VSTS.AccountContents-Funktion ist ein Ersatz für die Power Query M-Funktion Web.Contents. Vorgesehen für komplexere Szenarien, VSTS. AccountContents gibt den Inhalt zurück, der aus der URL für Analytics als binärwert heruntergeladen wurde. Sie können es verwenden, um AzureDevOps-REST-APIs aufzurufen.

Von Bedeutung

  • Verwenden Sie VSTS. AccountContents nur für den Zugriff auf Daten, die in Analytics nicht verfügbar sind. Es werden Daten direkt von Azure DevOps gepullt und zum Schutz anderer Benutzer von Azure DevOps ist es anfällig für Drosselung. Siehe den Abschnitt Unterstützte Subdomänen für VSTS.AccountContents weiter unten in diesem Artikel. Informationen zu anderen Ansätzen finden Sie in der Power BI-Integrationsübersicht.
  • VSTS. AccountContents unterstützt nur Azure Boards-Daten (Arbeitsaufgaben). Der Datenanschluss unterstützt keine anderen Datentypen wie beispielsweise Pipelines. Derzeit haben wir keine Pläne, den Connector zu aktualisieren, um andere Datentypen zu unterstützen.

VSTS.AccountContents

Erweiterte Funktion, die den Inhalt zurückgibt, der aus der URL für Analytics als Binärwert heruntergeladen wurde.

Die VSTS.AccountContents Funktion weist die gleichen Argumente, Optionen und das Rückgabewertformat auf wie Web.Contents. Weitere Informationen finden Sie unter Power Query (M) Formula Reference – Web.Contents.

Wenn Sie bereits Web.Contents verwenden, um auf Arbeitsverfolgungsdaten aus Analytics (REST-API oder OData) zuzugreifen, können Sie es durch VSTS.AccountContents zur Verwendung der Data Connector-Authentifizierung ersetzen. Es informiert Power BI, dass diese Anforderungen auf dieselbe Datenquelle verweisen. Sie können die Daten kombinieren, ohne die Einschränkungen für einzelne Datenquellen in Power BI-Dienst zu verletzen. VSTS.AccountContent unterstützt jedoch nur Daten aus Azure Boards und kann nicht zur Unterstützung von Abfragen für Pipelines oder andere Dienste verwendet werden.

'VSTS. AccountContents stellt eine Teilmenge der Argumente und Optionen bereit, die über "OData.Contents" verfügbar sind. Die spezifischen Einschränkungen sind in der folgenden Tabelle aufgeführt:

Argumente für VSTS.Contents

Argument Description
url URL zu einem der Azure DevOps-Dienstendpunkte.
options Ein Optionsdatensatz zum Steuern des Verhaltens dieser Funktion.

Optionsfelder für VSTS.Contents

Feld Description
IsRetry Geben Sie diesen logischen Wert als "true" an, um alle bestehenden Antworten im Cache beim Datenabruf zu ignorieren.
ManualStatusHandling Geben Sie diesen Wert als Liste an, um die integrierte Verarbeitung für HTTP-Anforderungen zu verhindern, deren Antwort einen dieser Statuscodes aufweist.
MaxSize Steuert die maximale Größe der Tabelle, an der der Client interessiert ist. Wenn die Anforderung diesen Grenzwert überschreitet, kann der Server die Anforderung sofort fehlschlagen. Der Standardwert ist Null, wodurch der Server angewiesen wird, seinen Standardwert zu verwenden.
Query Fügen Sie der URL programmgesteuert Abfrageparameter hinzu.
RelativePath Geben Sie diesen Wert als Text an, wird er an die Basis-URL angehängt, bevor die Anfrage gestellt wird.
Timeout Geben Sie diesen Wert als Dauer an, um das Timeout für eine HTTP-Anforderung zu ändern. Der Standardwert beträgt 600 Sekunden.
Version Version des Datenmodells. Diese Option ist primär für die Diagnose vorgesehen.

Unterstützte Unterdomänen für VSTS AccountContents

Derzeit funktioniert die VSTS.AccountContents() Methode nur für die unten aufgeführten Unterdomänen. Andere Dienste, z. B. der Releasedienst, werden noch nicht unterstützt:

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