Freigeben über

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. Sie ruft Daten direkt aus Azure DevOps ab, und um andere Azure DevOps-Benutzer zu schützen, ist es anfällig für Drosselungen. Siehe die unterstützten Unterdomänen für VSTS. Abschnitt "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 Datenconnector unterstützt keine anderen Datentypen, z. B. 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 für den Zugriff auf Arbeitsverfolgungsdaten aus Analytics (REST-API oder OData) verwenden Web.Contents , können Sie sie VSTS.AccountContents durch die 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. Unterstützt jedoch nur Daten aus Azure Boards und kann nicht verwendet werden, VSTS.AccountContent um Abfragen für Pipelines oder andere Dienste zu unterstützen.

'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. Inhalt

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

Optionsfelder für VSTS. Inhalt

Feld Description
IsRetry Geben Sie diesen Wahrheitswert als "true" an, um alle vorhandenen Antworten im Cache beim Abrufen von Daten 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 Serverserver angibt, seinen Standardwert zu verwenden.
Query Fügen Sie der URL programmgesteuert Abfrageparameter hinzu.
RelativePath Geben Sie diesen Wert als Text an die Basis-URL an, bevor Sie die Anforderung vornehmen.
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/
  • Last updated on