Delen via


Verbinding maken met behulp van Power Query- en Azure DevOps-functies

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

De gegevensconnector voor Azure DevOps bevat Power Query M-functies die auteurs van query's kunnen gebruiken. Deze functies kunnen specifieke vereisten voor Azure DevOps, zoals verificatie, voor u verwerken. In dit artikel worden de argumenten voor de functies beschreven en hoe u deze kunt gebruiken om verbinding te maken met Analytics.

De VST's. De functie AccountContents is een vervanging voor Power Query M-functie Web.Contents. VSTS is bedoeld voor meer geavanceerde scenario's. AccountContents retourneert de inhoud die is gedownload van de URL voor Analytics als een binaire waarde. U kunt deze gebruiken om AzureDevOps REST API's aan te roepen.

Belangrijk

  • Gebruik VSTS. AccountContents alleen voor toegang tot gegevens die niet beschikbaar zijn in Analytics. Het haalt gegevens rechtstreeks op uit Azure DevOps en om andere Azure DevOps-gebruikers te beschermen, zijn ze vatbaar voor beperking. Zie Ondersteunde subdomeinen voor VSTS. Sectie AccountContents verderop in dit artikel. Zie overzicht van Power BI-integratie voor informatie over andere benaderingen.
  • VSTS. AccountContents ondersteunt alleen Azure Boards-gegevens (werkitems). De gegevensconnector biedt geen ondersteuning voor andere gegevenstypen, zoals pijplijnen. Momenteel hebben we geen plannen om de connector bij te werken ter ondersteuning van andere gegevenstypen.

VSTS. AccountContents

Geavanceerde functie die de inhoud retourneert die is gedownload van de URL voor Analytics als een binaire waarde.

De VSTS.AccountContents functie heeft dezelfde argumenten, opties en retourwaardenotatie als Web.Contents. Zie Power Query (M) Formula Reference - Web.Contents voor meer informatie.

Als u al gebruikt Web.Contents voor toegang tot werktraceringsgegevens vanuit Analytics (REST API of OData), kunt u deze VSTS.AccountContents vervangen door om dataconnectorverificatie te gebruiken. Het informeert Power BI dat deze aanvragen verwijzen naar dezelfde gegevensbron. U kunt de gegevens combineren zonder de beperkingen voor één gegevensbron in de Power BI-service te schenden. Ondersteunt echter VSTS.AccountContent alleen gegevens van Azure Boards en kan niet worden gebruikt om query's voor pijplijnen of andere services te ondersteunen.

'VSTS. AccountContents' biedt een subset van de argumenten en opties die beschikbaar zijn via 'OData.Contents'. De specifieke beperkingen worden beschreven in de onderstaande tabel:

Argumenten voor VSTS. Inhoud

Argument Beschrijving
url URL naar een van de Azure DevOps-service-eindpunten.
options Een optierecord om het gedrag van deze functie te bepalen.

Optiesvelden voor VSTS. Inhoud

Veld Beschrijving
IsRetry Als u deze logische waarde opgeeft als waar, worden bestaande reacties in de cache genegeerd bij het ophalen van gegevens.
ManualStatusHandling Geef deze waarde op als een lijst voorkomt ingebouwde verwerking van HTTP-aanvragen waarvan het antwoord een van deze statuscodes heeft.
MaxSize Hiermee bepaalt u de maximale grootte van de tabel waarin de client geïnteresseerd is. Als de aanvraag deze limiet overschrijdt, kan de server de aanvraag onmiddellijk mislukken. De standaardwaarde is nul, waardoor de serverserver de standaardwaarde moet gebruiken.
Query Voeg programmatisch queryparameters toe aan de URL.
RelativePath Geef deze waarde op als tekst om deze toe te voegen aan de basis-URL voordat u de aanvraag indient.
Timeout Geef deze waarde op als een duur waarmee de time-out voor een HTTP-aanvraag wordt gewijzigd. De standaardwaarde is 600 seconden.
Version Versie van het gegevensmodel. Deze optie is primair voor diagnostische gegevens.

Ondersteunde subdomeinen voor VSTS. AccountContents

Op dit moment werkt de VSTS.AccountContents() methode alleen voor de subdomeinen die hieronder worden vermeld. Andere services, zoals de Release-service, worden nog niet ondersteund:

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