Átjárótámogatás kezelése

Kapcsolat tesztelése

Az egyéni Csatlakozás or-támogatás a helyszíni adatátjáró Személyes és Standard módban is elérhető. Mindkét átjárómód támogatja az importálást. A Direct Query csak Standard módban támogatott. Az átjárókon keresztüli egyéni összekötők OAuth szolgáltatása jelenleg csak az átjáró-rendszergazdák számára támogatott, más adatforrás-felhasználók esetében azonban nem.

A Test Csatlakozás ion funkció implementálásának módja valószínűleg megváltozik, míg a Power BI Egyéni adatok Csatlakozás or funkció előzetes verzióban érhető el.

A helyszíni adatátjárón keresztüli ütemezett frissítés támogatásához az összekötőnek egy Teszt Csatlakozás ion kezelőt kell implementálnia. A függvény akkor lesz meghívva, amikor a felhasználó hitelesítő adatokat konfigurál a forráshoz, és annak ellenőrzésére használja őket, hogy érvényesek legyenek. A Teszt Csatlakozás ion kezelő az Adatforrás típusa rekordban van beállítva, és a következő aláírást tartalmazza:

(dataSourcePath) as list => ...

Hol dataSourcePath található a függvény Adatforrás elérési útja értéke, a visszatérési érték pedig egy lista, amely a következőkből áll:

• A meghívandó függvény neve (ezt a függvényt meg kell jelölni #shared, és általában az elsődleges adatforrásfüggvény).
• Egy vagy több argumentumot kell átadni a függvénynek.

Ha a függvény meghívása hibát eredményez, a test Csatlakozás ion sikertelennek minősül, és a hitelesítő adatok nem lesznek megőrizve.

Megjegyzés:

A fentiekben leírtaknak megfelelően a Test Csatlakozás ion függvénynévnek tagnak kell lennieshared.

Példa: Csatlakozás or kötelező argumentumok nélkül

Az alábbi kódrészlet implementálja a Test Csatlakozás ion függvényt egy olyan adatforráshoz, amely nem rendelkezik szükséges paraméterekkel (például a TripPin oktatóanyagban található). Csatlakozás a szükséges paraméterekkel (más néven "Singletons") rendelkezőknek nincs szükségük semmilyen felhasználó által megadott bemenetre a kapcsolat teszteléséhez (a hitelesítő adatok kivételével). Ebben az esetben az dataSourcePath érték megegyezik az adatforrás típusának nevével, és figyelmen kívül hagyható. A TripPin.Contents függvény meghívása további paraméterek nélkül történik.

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

Példa: url-paraméterrel rendelkező Csatlakozás or

Ha az adatforrásfüggvénynek egyetlen kötelező paramétere van, Uri.Typeakkor az megegyezik dataSourcePath a felhasználó által megadott URL-címével. Az alábbi kódrészlet a Github-minta Tesztelés Csatlakozás ion implementációját mutatja be.

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

Példa: Csatlakozás or a szükséges paraméterekkel

Ha az adatforrásfüggvény több paraméterrel vagy egyetlen nem URL-paraméterrel rendelkezik, akkor az dataSourcePath érték a paramétereket tartalmazó JSON-sztring lesz. Az alábbi kódrészlet a DirectQueryForSQL-mintából származik.

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