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
#shared
a 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é.
Poznámka
Ako bolo uvedené vyššie, názov funkcie poskytnutý funkciou Test Pripojenie ion musí byť shared
členom.
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"
];