Zpracování podpory brány

Testovat připojení

Podpora vlastních Připojení orů je dostupná v osobních i standardních režimech místní brány dat. Oba režimy brány podporují import. Direct Query je podporován pouze v režimu Standard. OAuth pro vlastní konektory prostřednictvím bran se v současné době podporuje jenom pro správce brány, ale ne pro jiné uživatele zdroje dat.

Metoda implementace funkce Test Připojení ion se pravděpodobně změní, když je funkce Připojení vlastních dat Power BI ve verzi Preview.

Pokud chcete podporovat plánovanou aktualizaci prostřednictvím místní brány dat, musí váš konektor implementovat obslužnou rutinu Test Připojení ion. Funkce se volá, když uživatel konfiguruje přihlašovací údaje pro váš zdroj a používá se k zajištění jejich platnosti. Obslužná rutina Test Připojení ion je nastavena v záznamu Druh zdroje dat a má následující podpis:

(dataSourcePath) as list => ...

Kde dataSourcePath je hodnota Cesta ke zdroji dat pro vaši funkci a návratová hodnota je seznam složený z:

• Název funkce, která se má volat (tato funkce musí být označena jako #shared, a obvykle je to vaše primární funkce zdroje dat).
• Jeden nebo více argumentů, které chcete funkci předat.

Pokud vyvolání funkce způsobí chybu, považuje se test Připojení ion za neúspěšný a přihlašovací údaje se nezachovají.

Poznámka:

Jak je uvedeno výše, název funkce poskytovaný funkcí Test Připojení ion musí být shared členem.

Příklad: Připojení or bez požadovaných argumentů

Následující fragment kódu implementuje test Připojení ion pro zdroj dat bez požadovaných parametrů (například ten, který najdete v kurzu TripPin). Připojení orům bez požadovaných parametrů (označovaných jako Singletons) nejsou k otestování připojení (kromě přihlašovacích údajů) potřeba žádný vstup zadaný uživatelem. V tomto případě dataSourcePath by se hodnota rovnala názvu druhu zdroje dat a lze ji ignorovat. Funkce TripPin.Contents se vyvolá bez dalších parametrů.

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

Příklad: Připojení or s parametrem adresy URL

Pokud má funkce zdroje dat jeden povinný parametr typu Uri.Type, bude se shodovat dataSourcePath s adresou URL poskytnutou uživatelem. Následující fragment kódu ukazuje implementaci Test Připojení ion z ukázky GitHubu.

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

Příklad: Připojení or s požadovanými parametry

Pokud má vaše funkce zdroje dat více parametrů nebo jeden parametr bez adresy URL, dataSourcePath bude hodnota řetězec JSON obsahující parametry. Následující fragment kódu pochází z ukázky 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"
];