Freigeben über

Ihren ersten Connector erstellen: Hello World

  • Artikel

Dieses Beispiel bietet eine einfache Datenquellenerweiterung, die in Visual Studio Code ausgeführt und in Power BI Desktop geladen werden kann.

„Hello World“-Beispiel

Als Übersicht zeigt dieses Beispiel:

  • Exportfunktion (HelloWorld.Contents), die einen Optionstextparameter verwendet
  • Definieren einer Datenquellenart, die:
    • deklariert, dass die implizite (anonyme) Authentifizierung verwendet wird.
    • Zeichenfolgenressourcen verwendet, die die Lokalisierung ermöglichen.
    • UI-Metadaten deklariert, damit die Erweiterung im Dialogfeld „Daten abrufen“ von Power BI Desktop angezeigt werden kann.

Erstellen Sie nach den Anweisungen in Installation des PowerQuery SDK einen neuen Konnektor namens „HelloWorld“, und kopieren Sie den folgenden M-Code und fügen Sie ihn in die Datei HelloWorld.pq Ihres Konnektor-Arbeitsbereichs ein, und folgen Sie dann den restlichen Anweisungen, um ihn in Power BI öffnen zu können.

In der folgenden Konnektor-Definition finden Sie:

  • eine section-Anweisung.
  • eine Datenquellenfunktion mit Metadaten, die sie als Datenquellendefinition mit der Art HelloWorld und Veröffentlichung HelloWorld.Publish einrichten.
  • ein Authentication-Datensatz, der deklariert, dass implizit (anonym) der einzige Authentifizierungstyp für diese Quelle ist.
  • ein Veröffentlichungsdatensatz, der angibt, dass sich diese Verbindung in Beta befindet, und welcher Text aus der RESX-Datei, dem Quellbild und dem Quelltypbild geladen werden soll.
  • ein Datensatz, der Symbolgrößen bestimmten PNGs im Build-Ordner zuordnet.
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") }
];

Nachdem Sie die Datei erstellt und in das richtige Verzeichnis kopiert haben, öffnen Sie Power BI, indem Sie die Anweisungen zum Lernprogramm PowerQuery SDK installieren befolgen. Sie können im Dialogfeld Daten abrufen nach „hello“ suchen, um Ihren Connector zu finden.

In diesem Schritt wird ein Authentifizierungsdialogfeld angezeigt. Da keine Authentifizierungsoptionen vorhanden sind und die Funktion keine Parameter verwendet, gibt es keine weiteren Schritte in diesen Dialogfeldern.

Klicken Sie auf Verbinden, und das Dialogfeld teilt Ihnen mit, dass es sich um einen „Vorschau-Connector“ handelt, da Beta in der Abfrage auf „true“ festgelegt ist. Da keine Authentifizierung vorhanden ist, zeigt der Authentifizierungsbildschirm eine Registerkarte für die anonyme Authentifizierung ohne Felder an. Klicken Sie erneut auf Verbinden, um den Vorgang abzuschließen.

Schließlich wird der Abfrage-Editor mit dem angezeigt, was Sie erwarten – eine Funktion, die den Text „Hello world“ zurückgibt.

Das vollständig implementierte Beispiel finden Sie im Hello World-Beispiel im Beispiel-Repository für den Daten-Connector.