Obsługa bramy

Testuj połączenie

Obsługa niestandardowych Połączenie or jest dostępna zarówno w trybach osobistych, jak i standardowych lokalnej bramy danych. Oba tryby bramy obsługują importowanie. Zapytanie bezpośrednie jest obsługiwane tylko w trybie standardowym. Uwierzytelnianie OAuth dla łączników niestandardowych za pośrednictwem bram jest obecnie obsługiwane tylko dla administratorów bramy, ale nie dla innych użytkowników źródła danych.

Metoda implementowania funkcji Test Połączenie ion może ulec zmianie, podczas gdy funkcja usługi Power BI Custom Data Połączenie or jest dostępna w wersji zapoznawczej.

Aby obsługiwać zaplanowane odświeżanie za pośrednictwem lokalnej bramy danych, łącznik musi zaimplementować program obsługi test Połączenie ion. Funkcja jest wywoływana, gdy użytkownik konfiguruje poświadczenia dla źródła i jest używany w celu upewnienia się, że są prawidłowe. Procedura obsługi Test Połączenie ion jest ustawiona w rekordzie Rodzaj źródła danych i ma następujący podpis:

(dataSourcePath) as list => ...

Gdzie dataSourcePath jest wartością Ścieżka źródła danych dla funkcji, a wartość zwracana jest listą składającą się z:

• Nazwa funkcji do wywołania (ta funkcja musi być oznaczona jako #sharedi jest zwykle podstawową funkcją źródła danych).
• Co najmniej jeden argument przekazywany do funkcji.

Jeśli wywołanie funkcji spowoduje wystąpienie błędu, test Połączenie ion jest uznawany za niepowodzenie, a poświadczenie nie zostanie utrwalone.

Uwaga

Jak wspomniano powyżej, nazwa funkcji podana przez test Połączenie ion musi być elementem shared członkowskim.

Przykład: Połączenie or bez wymaganych argumentów

Poniższy fragment kodu implementuje kod Test Połączenie ion dla źródła danych bez wymaganych parametrów (takich jak ten znaleziony w samouczku TripPin). Połączenie or bez wymaganych parametrów (nazywanych "Singletons") nie potrzebują żadnych danych wejściowych dostarczonych przez użytkownika, aby przetestować połączenie (inne niż poświadczenia). W takim przypadku dataSourcePath wartość będzie równa nazwie typu źródło danych i może zostać zignorowana. Funkcja jest wywoływana TripPin.Contents bez dodatkowych parametrów.

TripPin = [
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin"
];

Przykład: Połączenie or z parametrem adresu URL

Jeśli funkcja źródła danych ma jeden wymagany parametr typu Uri.Type, będzie on dataSourcePath równy adresowi URL podanemu przez użytkownika. Poniższy fragment kodu przedstawia implementację testową Połączenie ion z przykładu github.

GithubSample = [
    TestConnection = (dataSourcePath) => {"GithubSample.Contents", dataSourcePath},
    Authentication = [
        OAuth = [
            StartLogin = StartLogin,
            FinishLogin = FinishLogin,
            Label = Extension.LoadString("AuthenticationLabel")
        ]
    ]
];

Przykład: Połączenie or z wymaganymi parametrami

Jeśli funkcja źródła danych ma wiele parametrów lub jeden parametr inny niż URL, dataSourcePath wartość będzie ciągiem JSON zawierającym parametry. Poniższy fragment kodu pochodzi z przykładu DirectQueryForSQL .

DirectSQL = [
    TestConnection = (dataSourcePath) =>
        let
            json = Json.Document(dataSourcePath),
            server = json[server],
            database = json[database]
        in
            { "DirectSQL.Database", server, database },
    Authentication = [
        Windows = [],
        UsernamePassword = []
    ],
    Label = "Direct Query for SQL"
];