Udostępnij przez

Obsługa dostępu do danych

Funkcje źródła danych

Łącznik danych opakowuje i dostosowuje zachowanie funkcji źródła danych w bibliotece M. Na przykład rozszerzenie interfejsu API REST będzie używać funkcji Web.Contents do tworzenia żądań HTTP. Obecnie włączono ograniczony zestaw funkcji źródła danych, aby obsługiwać rozszerzalność.

Example:

[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;

Rodzaj źródła danych

Funkcje oznaczone jako shared w rozszerzeniu mogą być skojarzone z określonym źródłem danych przez dołączenie atrybutu literału DataSource.Kind do funkcji, której nazwą jest nazwa rekordu definicji źródła danych. Rekord źródła danych definiuje typy uwierzytelniania obsługiwane przez źródło danych oraz podstawowe informacje o znakowaniu (takie jak nazwa wyświetlana/etykieta). Nazwa rekordu staje się jego unikatowym identyfikatorem.

Każda funkcja skojarzona z tym samym źródłem danych musi mieć te same wymagane parametry funkcji, w tym nazwę, typ i kolejność. (Na potrzeby rodzaju źródła danych parametr nie jest uznawany za wymagany, jeśli jest oznaczony optional lub jeśli jego metadane zawierają DataSource.Path = false.

Funkcje dla określonego typu źródła danych mogą używać tylko poświadczeń skojarzonych z tym rodzajem. Poświadczenia są identyfikowane w czasie wykonywania, wykonując wyszukiwanie na podstawie kombinacji wymaganych parametrów funkcji. Aby uzyskać więcej informacji na temat identyfikowania poświadczeń, zobacz Ścieżki źródła danych.

Example:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Właściwości

W poniższej tabeli wymieniono pola rekordu definicji źródła danych.

(No changes needed) Typ Szczegóły
Authentication rekord Określa co najmniej jeden typ uwierzytelniania obsługiwany przez źródło danych. Wymagany jest co najmniej jeden rodzaj. Każdy rodzaj będzie wyświetlany jako opcja w monicie poświadczeń Power Query. Aby uzyskać więcej informacji, zobacz Typy uwierzytelniania.
Etykieta SMS (opcjonalnie) Przyjazna nazwa wyświetlana dla tego rozszerzenia w oknach dialogowych poświadczeń.
Obsługuje Szyfrowanie logiczny (opcjonalnie) Jeśli to prawda, interfejs użytkownika wyświetli opcję łączenia ze źródłem danych przy użyciu szyfrowanego połączenia. Jest to zwykle używane w przypadku źródeł danych z nieszyfrowanym mechanizmem zapasowym (zazwyczaj źródła typu ODBC lub ADO.NET).

Publikuj w interfejsie użytkownika

Podobnie jak w przypadku rekordu definicji źródła danych , rekord Publikuj udostępnia interfejs użytkownika dodatku Power Query informacje potrzebne do uwidocznienia tego rozszerzenia w oknie dialogowym Pobieranie danych .

Example:

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") }
];

Właściwości

W poniższej tabeli wymieniono pola dla rekordu Publikuj.

(No changes needed) Typ Szczegóły
Przycisk Tekst list Lista elementów tekstowych. Pierwszy element definiuje nazwę wyświetlaną obok ikony źródła danych w oknie dialogowym Pobieranie danych w usłudze Power BI. Drugi element (opcjonalnie) definiuje poradę narzędzia, która będzie wyświetlana, gdy poprzednia nazwa jest za pomocą myszy.
Kategoria SMS Gdzie rozszerzenie powinno być wyświetlane w oknie dialogowym Pobieranie danych . Obecnie jedynymi wartościami kategorii ze specjalnym traktowaniem są Azure i Database. Wszystkie inne wartości trafią do kategorii Inne.
Beta logiczny (opcjonalnie) Po ustawieniu wartości true, interfejs użytkownika wyświetli identyfikator wersji beta/zapoznawczej obok nazwy twojego łącznika i okno z ostrzeżeniem, że implementacja łącznika podlega zmianom mogącym powodować niezgodność.
LearnMoreUrl SMS (opcjonalnie) Adres URL witryny sieci Web zawierający więcej informacji o tym źródle danych lub łączniku.
SupportsDirectQuery logiczny (opcjonalnie) Włącza zapytanie bezpośrednie dla rozszerzenia.
SourceImage rekord (opcjonalnie) Rekord zawierający listę obrazów binarnych (pochodzący z pliku rozszerzenia przy użyciu metody Extension.Contents ). Rekord zawiera dwa pola (Icon16, Icon32), z których każda ma własną listę. Każda ikona powinna mieć inny rozmiar.
TypObrazu źródła rekord (opcjonalnie) Podobnie jak SourceImage, z wyjątkiem tego, że konwencją dla wielu gotowych łączników jest wyświetlanie ikony arkusza z ikoną charakterystyczną dla źródła w prawym dolnym rogu. Posiadanie innego zestawu ikon dla parametru SourceTypeImage jest opcjonalne — wiele rozszerzeń po prostu używa tego samego zestawu ikon dla obu pól.
  • Last updated on