Herstellen einer Verbindung mit Power Query- und Azure DevOps-Funktionen

  • Artikel

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

Der Datenconnector für Azure DevOps enthält 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.

Der VSTS. Die AccountContents-Funktion ersetzt Power Query M-Funktion Web.Contents. VSTS ist für erweiterte Szenarien vorgesehen. AccountContents gibt den Von der URL für Analytics heruntergeladenen Inhalt als Binärwert zurück. Sie können sie verwenden, um AzureDevOps-REST-APIs aufzurufen.

Wichtig

  • Verwenden Sie VSTS. AccountContents nur für den Zugriff auf Daten, die in Analytics nicht verfügbar sind. Es ruft Daten direkt aus Azure DevOps ab und ist zum Schutz anderer Azure DevOps-Benutzer anfällig für Drosselung. Weitere Informationen finden Sie unter Unterstützte Unterdomänen für VSTS. Abschnitt "AccountContents" weiter unten in diesem Artikel. Informationen zu anderen Ansätzen finden Sie in der Übersicht über die Power BI-Integration.
  • VSTS. AccountContents unterstützt nur Azure Boards Daten (Arbeitselemente). Andere Datentypen, z. B. Pipelines, werden vom Datenconnector nicht unterstützt. Derzeit haben wir keine Pläne, den Connector zu aktualisieren, um andere Datentypen zu unterstützen.

VSTS. AccountContents

Erweiterte Funktion, die den von der URL für Analytics heruntergeladenen Inhalt als Binärwert zurückgibt.

Die VSTS.AccountContents -Funktion verfügt über dasselbe Argument-, Options- und Rückgabewertformat 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 durch VSTS.AccountContents ersetzen, um die Datenconnector-Authentifizierung zu verwenden. Power BI wird darüber informiert, dass diese Anforderungen auf dieselbe Datenquelle verweisen. Sie können die Daten kombinieren, ohne die Einschränkungen für einzelne Datenquellen in Power BI Service zu verletzen. VSTS.AccountContent Unterstützt jedoch nur Daten aus Azure Boards und kann nicht verwendet werden, 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 BESCHREIBUNG
url URL zu einem der Azure DevOps-Dienstendpunkte.
options Ein Optionsdatensatz, um das Verhalten dieser Funktion zu steuern.

Optionsfelder für VSTS. Inhalt

Feld BESCHREIBUNG
IsRetry Wenn Sie diesen logischen Wert als true angeben, werden beim Abrufen von Daten alle vorhandenen Antworten im Cache ignoriert.
ManualStatusHandling Geben Sie diesen Wert als Liste an, um die integrierte Verarbeitung von HTTP-Anforderungen zu verhindern, deren Antwort einen dieser status-Codes aufweist.
MaxSize Steuert die maximale Größe der Tabelle, für die der Client interessiert ist. Wenn die Anforderung diesen Grenzwert überschreitet, kann die Anforderung vom Server sofort fehlschlagen. Der Standardwert ist 0, was dem Server angibt, seinen Standardwert zu verwenden.
Query Fügen Sie der URL programmgesteuert Abfrageparameter hinzu.
RelativePath Geben Sie diesen Wert an, da Text ihn an die Basis-URL anfüge, bevor die Anforderung 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 Diagnose.

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/