Condividi tramite

Connettersi con funzioni Power Query e Azure DevOps

  • Articolo

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

Il connettore dati per Azure DevOps include Power Query funzioni M che gli autori di query possono usare. Queste funzioni possono gestire requisiti specifici di Azure DevOps, ad esempio l'autenticazione. Questo articolo descrive gli argomenti per le funzioni e come usarli per connettersi a Analytics.

The VSTS. La funzione AccountContents è una sostituzione per Power Query funzione M Web.Content. Destinato a scenari più avanzati, VSTS. AccountContents restituisce il contenuto scaricato dall'URL per Analytics come valore binario. È possibile usarlo per chiamare LE API REST di AzureDevOps.

Importante

  • Usare VSTS. AccountContents solo per accedere ai dati non disponibili in Analytics. Esegue il pull dei dati direttamente da Azure DevOps e, per proteggere altri utenti di Azure DevOps, è soggetta alla limitazione. Vedere i sottodomini supportati per VSTS. Sezione AccountContents più avanti in questo articolo. Per informazioni sugli altri approcci, vedere panoramica dell'integrazione di Power BI.
  • VSTS. AccountContents supporta solo i dati Azure Boards (elementi di lavoro). Il connettore dati non supporta altri tipi di dati, ad esempio le pipeline. Attualmente non sono previsti piani per aggiornare il connettore per supportare altri tipi di dati.

VSTS. AccountContents

Funzione avanzata che restituisce il contenuto scaricato dall'URL di Analytics come valore binario.

La VSTS.AccountContents funzione ha gli stessi argomenti, opzioni e formato del valore restituito di Web.Contents. Per altre informazioni, vedere Informazioni di riferimento sulla formula Power Query (M) - Web.Content.

Se si usa Web.Contents già per accedere ai dati di rilevamento del lavoro da Analytics (API REST o OData), è possibile sostituirlo con VSTS.AccountContents per usare l'autenticazione di Data Connector. Informa Power BI che queste richieste fanno riferimento alla stessa origine dati. È possibile combinare i dati senza violare i vincoli di origine dati singoli nel servizio Power BI. Tuttavia, VSTS.AccountContent supporta solo i dati di Azure Boards e non può essere usato per supportare query per pipeline o altri servizi.

'VSTS. AccountContents fornisce un subset degli argomenti e delle opzioni disponibili tramite 'OData.Content'. Le limitazioni specifiche sono descritte nella tabella seguente:

Argomenti per VSTS. Contenuto

Argomento Descrizione
url URL a uno degli endpoint del servizio Azure DevOps.
options Record di opzioni per controllare il comportamento di questa funzione.

Campi opzioni per VSTS. Contenuto

Campo Descrizione
IsRetry Specificare questo valore logico come true ignora qualsiasi risposta esistente nella cache durante il recupero dei dati.
ManualStatusHandling Specificare questo valore come elenco impedirà la gestione predefinita per le richieste HTTP la cui risposta ha uno di questi codici di stato.
MaxSize Controlla la dimensione massima della tabella in cui il client è interessato. Se la richiesta supera questo limite, il server può non riuscire immediatamente la richiesta. Il valore predefinito è zero, che indica al server di usare il valore predefinito.
Query Aggiungere parametri di query a livello di codice all'URL.
RelativePath Specificare questo valore come testo lo aggiunge all'URL di base prima di effettuare la richiesta.
Timeout Specificare questo valore come durata cambierà il timeout per una richiesta HTTP. Il valore predefinito è 600 secondi.
Version Versione del modello di dati. Questa opzione è primaria per la diagnostica.

Sottodomini supportati per VSTS. AccountContents

Attualmente, il VSTS.AccountContents() metodo funziona solo per i sottodomini elencati di seguito. Altri servizi, ad esempio il servizio Release, non sono ancora supportati:

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