Condividi tramite

Creazione del primo connettore: Hello World

  • Articolo

Questo esempio fornisce una semplice estensione dell'origine dati che può essere eseguita in Visual Studio Code e caricata in Power BI Desktop.

Esempio Hello World

Come panoramica, questo esempio mostra:

  • Esportazione della funzione (HelloWorld.Contents), che accetta un parametro di testo di opzione.
  • Definizione di un tipo di origine dati che:
    • Dichiara che usa l'autenticazione implicita (anonima).
    • Usa le risorse stringa che consentono la localizzazione.
    • Dichiarazione dei metadati dell'interfaccia utente in modo che l'estensione possa essere visualizzata nella finestra di dialogo Recupera dati di Power BI Desktop.

Seguendo le istruzioni riportate in Installazione di PowerQuery SDK, creare un nuovo connettore denominato "HelloWorld", copiarlo nel codice M seguente e incollarlo nel file HelloWorld.pq dell'area di lavoro del connettore e quindi seguire le altre istruzioni per poterlo aprire in Power BI.

Nella definizione del connettore seguente:

  • Istruzione section .
  • Funzione dell'origine dati con metadati che lo stabiliscono come definizione di origine dati con Kind HelloWorld e Publish HelloWorld.Publish.
  • Un Authentication record che dichiara che implicito (anonimo) è l'unico tipo di autenticazione per questa origine.
  • Un record di pubblicazione che dichiara che questa connessione si trova in Beta, quale testo caricare dal file resx, dall'immagine di origine e dall'immagine del tipo di origine.
  • Un record che associa le dimensioni delle icone a specifici gruppi di sicurezza di rete nella cartella di compilazione.
section HelloWorld;
 
[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;
 
HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];
 
HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];
 
HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Dopo aver compilato il file e copiato nella directory corretta, seguire le istruzioni riportate nell'esercitazione Installazione di PowerQuery SDK aprire Power BI. È possibile cercare "hello" per trovare il connettore nella finestra di dialogo Recupera dati .

Questo passaggio consente di visualizzare una finestra di dialogo di autenticazione. Poiché non sono disponibili opzioni di autenticazione e la funzione non accetta parametri, non esistono altri passaggi in queste finestre di dialogo.

Premere Connessione e la finestra di dialogo indica che si tratta di un "connettore di anteprima", perché Beta è impostato su true nella query. Poiché non è presente alcuna autenticazione, nella schermata di autenticazione viene visualizzata una scheda per l'autenticazione anonima senza campi. Premere di nuovo Connessione per terminare.

Infine, viene visualizzato l'editor di query che mostra ciò che ci si aspetta, ovvero una funzione che restituisce il testo "Hello world".

Per l'esempio completamente implementato, vedere l'esempio Hello World nel repository di esempio data Connessione ors.