Yhdyskäytävän tuen käsittely

Testaa yhteys

Mukautettu Näyttöyhteys tai-tuki on käytettävissä paikallisen tietoyhdyskäytävän henkilökohtaisessa ja vakiotilassa. Molemmat yhdyskäytävätilat tukevat tuontia. Suoraa kyselyä tuetaan vain vakiotilassa. Mukautettujen liittimien OAuth-käyttöä yhdyskäytäviä käyttämällä tuetaan tällä hetkellä vain yhdyskäytävän järjestelmänvalvojille, mutta ei muille tietolähteiden käyttäjille.

Menetelmä Testi Näyttöyhteys ion-toiminnon käyttöönottoon muuttuu todennäköisesti, kun Power BI:n mukautettujen tietojen Näyttöyhteys tai-toiminto on esikatseluvaiheessa.

Jos haluat tukea ajoitettua päivitystä paikallisen tietoyhdyskäytävän kautta, liittimesi on käytettävä Testi Näyttöyhteys käsittelijää. Funktiota kutsutaan, kun käyttäjä määrittää lähteesi tunnistetiedot ja varmistaa, että ne ovat kelvollisia. Testi Näyttöyhteys käsittelijä on määritetty Tietolähteen laji -tietueessa, ja sillä on seuraava allekirjoitus:

(dataSourcePath) as list => ...

dataSourcePath on funktion tietolähteen polun arvo, ja palautusarvo on luettelo, joka koostuu seuraavista:

• Kutsuttavan funktion nimi (tämä funktio on merkittävä merkinnällä #shared, ja se on yleensä ensisijainen tietolähdefunktiosi).
• Yksi tai useampi argumentti välitettavaksi funktioon.

Jos funktion kutsu aiheuttaa virheen, Testi Näyttöyhteys ion katsotaan epäonnistuneen, eikä tunnistetietoja säilytetä.

Muistiinpano

Kuten edellä on mainittu, Test Näyttöyhteys ion-funktion antaman funktion shared nimen on oltava jäsen.

Esimerkki: Näyttöyhteys tai ilman pakollisia argumentteja

Alla oleva koodikatkelmus toteuttaa testin Näyttöyhteys ion tietolähteelle, jolla ei ole vaadittuja parametreja (esimerkiksi TripPin-opetusohjelmasta löytynyt parametri). Näyttöyhteys orjissa, jotka eivät ole pakollisia parametreja (joita kutsutaan singletoneiksi), ei tarvita mitään käyttäjän antamaa syötettä yhteyden testaamiseen (muut kuin tunnistetiedot). Tässä tapauksessa dataSourcePath arvo on yhtä suuri kuin tietolähteen lajin nimi, ja se voidaan ohittaa. Funktio TripPin.Contents käynnistetään ilman lisäparametreja.

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

Esimerkki: Näyttöyhteys tai URL-parametrilla

Jos tietolähdefunktiolla on yksittäinen pakollinen -parametri, Uri.Typese dataSourcePath on sama kuin käyttäjän antama URL-osoite. Alla olevassa katkelmassa näkyy Testi Näyttöyhteys toteutus Github-mallista.

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

Esimerkki: Näyttöyhteys tai, jolla on tarvittavat parametrit

Jos tietolähdefunktiossasi dataSourcePath on useita parametreja tai yksittäinen muu kuin URL-parametri, arvo on JSON-merkkijono, joka sisältää parametrit. Alla oleva katkelmä on peräisin DirectQueryForSQL-mallista.

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