Spracovanie podpory brány

Testovať pripojenie

Vlastná Pripojenie alebo podpora je dostupná v osobnom aj štandardnom režime lokálnej brány údajov. Oba režimy brány podporujú import. Priamy dotaz je podporovaný len v štandardnom režime. OAuth pre vlastné konektory cez brány je v súčasnosti podporované len pre správcov brány, ale nie iných používateľov zdroja údajov.

Metóda implementácie funkcie Test Pripojenie ion sa pravdepodobne zmení, zatiaľ čo Pripojenie vlastnými údajmi služby Power BIaleobje funkcia vo verzii Preview.

Na podporu plánovaného obnovenia prostredníctvom lokálnej brány údajov musí váš konektor implementovať obslužný program testovania Pripojenie ion. Táto funkcia sa volá vtedy, keď používateľ konfiguruje poverenia pre váš zdroj, a použije sa na to, aby sa uistil, že sú platné. Obslužný program Pripojenie údajov je nastavený v zázname Druh zdroja údajov a má nasledujúci podpis:

(dataSourcePath) as list => ...

Kde dataSourcePath je hodnota cesta k zdroju údajov pre vašu funkciu a vrátená hodnota je zoznam skladaný z týchto zoznamov:

• Názov funkcie, ktorá sa má volať (táto funkcia musí byť označená ako #shareda zvyčajne ide o primárnu funkciu zdroja údajov).
• Jeden alebo viac argumentov, ktoré sa majú preniesť do vašej funkcie.

Ak vyvolanie funkcie spôsobí chybu, funkcia Test Pripojenie ion sa považuje za neúspešnú a poverenie nebude trvalé.

Príklad: Pripojenie alebo bez požadovaných argumentov

Úryvok kódu uvedený nižšie implementuje Test Pripojenie ion pre zdroj údajov bez požadovaných parametrov (napríklad ten, ktorý sa nachádza v kurze TripPin). Pripojenie ktory bez požadovaných parametrov (označované ako Singletons) nepotrebujú na testovanie pripojenia (okrem poverení) žiadny používateľ zadaný vstup. V tomto prípade dataSourcePath by sa hodnota rovnla názvu typu Zdroj údajov a možno ju ignorovať. Funkcia sa TripPin.Contents vyvolá bez ďalších parametrov.

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

Príklad: Pripojenie alebo s parametrom URL adresy

Ak má funkcia zdroja údajov jeden požadovaný parameter typu Uri.Type, jej dataSourcePath hodnota sa bude rovnať URL adrese poskytnutej používateľom. Na nižšie uvedenom úryvku sa zobrazuje implementácia funkcie Test Pripojenie ion zo vzorky Githubu.

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

Príklad: Pripojenie alebo s požadovanými parametrami

Ak má funkcia zdroja údajov viacero parametrov alebo jeden parameter, ktorý nie je URL adresou, dataSourcePath hodnotou bude reťazec JSON obsahujúci parametre. Úryvok kódu uvedený nižšie pochádza zo vzorky 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"
];