Udostępnij za pośrednictwem

Tworzenie pierwszego łącznika: Hello World

  • Artykuł

Ten przykład zawiera proste rozszerzenie źródła danych, które można uruchomić w programie Visual Studio Code i załadowane w programie Power BI Desktop.

Przykład Hello World

W ramach przeglądu ten przykład przedstawia następujące elementy:

  • Eksportowanie funkcji (HelloWorld.Contents), która przyjmuje parametr tekstowy opcji.
  • Definiowanie rodzaju źródła danych, które:
    • Deklaruje, że używa uwierzytelniania niejawnego (anonimowego).
    • Używa zasobów ciągów, które umożliwiają lokalizację.
    • Deklarowanie metadanych interfejsu użytkownika w celu wyświetlenia rozszerzenia w oknie dialogowym Pobieranie danych programu Power BI Desktop.

Postępuj zgodnie z instrukcjami w temacie Instalowanie zestawu POWERQuery SDK, utwórz nowy łącznik o nazwie "HelloWorld", skopiuj poniższy kod M i wklej go w pliku HelloWorld.pq obszaru roboczego łącznika, a następnie postępuj zgodnie z pozostałymi instrukcjami, aby móc otworzyć go w usłudze Power BI.

W poniższej definicji łącznika znajdziesz:

  • Instrukcja section .
  • Funkcja źródła danych z metadanymi określającymi je jako definicję źródła danych z typem HelloWorld i publikowaniem HelloWorld.Publish.
  • Rekord Authentication deklarujący, że niejawny (anonimowy) jest jedynym typem uwierzytelniania dla tego źródła.
  • Rekord publikowania deklarujący, że to połączenie znajduje się w wersji beta, jaki tekst ma być ładowany z pliku resx, obrazu źródłowego i obrazu typu źródłowego.
  • Rekord kojarzący rozmiary ikon z określonymi grupami powiadomień w folderze kompilacji.
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") }
];

Po skompilowaniu pliku i skopiowaniu go do odpowiedniego katalogu, postępując zgodnie z instrukcjami w samouczku Instalowanie zestawu POWERQuery SDK , otwórz usługę Power BI. Możesz wyszukać frazę "hello", aby znaleźć łącznik w oknie dialogowym Pobieranie danych .

Ten krok powoduje wyświetlenie okna dialogowego uwierzytelniania. Ponieważ nie ma opcji uwierzytelniania i funkcja nie przyjmuje żadnych parametrów, nie ma dalszych kroków w tych oknach dialogowych.

Naciśnij Połączenie, a okno dialogowe informuje o tym, że jest to "łącznik w wersji zapoznawczej", ponieważ Beta w zapytaniu jest ustawiona wartość true. Ponieważ nie ma uwierzytelniania, ekran uwierzytelniania przedstawia kartę uwierzytelniania anonimowego bez pól. Naciśnij ponownie Połączenie, aby zakończyć.

Na koniec edytor zapytań pojawia się, co można oczekiwać — funkcja zwracająca tekst "Hello world".

Aby zapoznać się z w pełni zaimplementowanym przykładem, zobacz Przykład Hello World w repozytorium przykładowym Połączenie ors.