Certifikácia konektora doplnku Power Query

Poznámka

V tomto článku sa opisujú požiadavky a proces odoslania vlastného konektora doplnku Power Query na certifikáciu. Pred začatím certifikačného procesu si pozorne prečítajte celý článok.

Úvod

Certifikáciou vlastného konektora doplnku Power Query sa konektor sprístupní verejne, mimo krabice, v rámci Power BI Desktop. Certifikácia sa riadi certifikačným programom konektorov spoločnosti Microsoft, kde spoločnosť Microsoft spolupracuje s partnerskými vývojármi na rozšírení možností pripojenia údajov služby Power BI.

Certifikované konektory sú:

  • Udržiavaný partnerským vývojárom

  • Podporované partnerským vývojárom

  • Certifikované spoločnosťou Microsoft

  • Distribuované spoločnosťou Microsoft

Spolupracujeme s partnermi, aby sme sa uistili, že majú podporu v údržbe, ale problémy so samotným konektorom budú smerovať na vývojára partnera.

Certifikované konektory sú v Power BI Desktop zbalené mimo krabice. Vlastné konektory je potrebné načítať do Power BI Desktop, ako je popísané v časti Načítanie rozšírenia v Power BI Desktop. Obe je možné obnoviť prostredníctvom služby Power BI Desktop alebo služby Power BI pomocou lokálnej brány údajov implementáciou testovacieho pripojenia.

Certifikované konektory s TestConnection implementáciou tiež podporujú end-to-end obnovenie prostredníctvom cloudu (Služba Power BI) bez potreby lokálnej brány údajov. V prostredí služby Power BI sa v podstate nachádza "cloudová brána", ktorá funguje podobne ako lokálna brána. Po certifikácii nasadíme váš konektor do tohto prostredia tak, aby bol k dispozícii všetkým zákazníkom služby Power BI. Existujú ďalšie požiadavky na konektory, ktoré musia používať ďalšie komponenty, ako je napríklad ovládač založený na ODBC. Ak konektor vyžaduje použitie ďalších súčastí, obráťte sa na kontakt spoločnosti Microsoft.

Zabezpečenie a podpisovanie vlastného konektora

Keďže M je všestranný jazyk, ktorý, ako je vidieť v manipulačnej autentifikácii,má schopnosť komunikovať s uloženými povereniami, musíme používateľom poskytnúť spôsob, ako povoliť iba spustenie dôveryhodných konektorov.

Z pohľadu vývojára musia vývojári sami podpísať svoj vlastný konektor a poskytnúť svojim používateľom informácie (odtlačok prsta), aby ho bezpečne načítali.

Z pohľadu používateľa musia používatelia použiť odtlačok od vývojára na bezpečnú dôveryhodnosť a načítanie vlastného konektora na použitie. Prípadne sa používatelia môžu rozhodnúť znížiť svoje nastavenia zabezpečenia, aby umožnili načítanie kódu, ktorý nie je certifikovaný spoločnosťou Microsoft alebo iným vývojárom, ale neodporúča sa to.

Prehľad certifikácie

Požiadavky

Aby sme našim zákazníkom zabezpečili čo najlepší zážitok, považujeme len konektory, ktoré spĺňajú súbor predpokladov pre certifikáciu:

  • Konektor musí byť určený pre verejný výrobok.

  • Vývojár musí poskytnúť odhad použitia. Navrhujeme, aby vývojári konektorov pre veľmi butikové produkty využívali naše samo-podpisové schopnosti konektora, aby ich poskytli priamo zákazníkovi.

  • Konektor musí byť už k dispozícii priamo zákazníkom, aby splnil potrebu používateľa alebo obchodný scenár.

  • Konektor musí úspešne pracovať na predpokladanej úrovni používania zákazníkmi.

  • Vo fóre Power BI Ideas musí byť vlákno riadené zákazníkmi, ktoré označuje požiadavku na sprístupnenie konektora vo Power BI Desktop.

Tieto predpoklady existujú na zabezpečenie toho, aby konektory, ktoré podliehajú certifikácii, mali významné požiadavky na používanie a podporu po certifikácii.

Proces a časová os

Certifikované konektory sa uvoľňujú s mesačnými Power BI Desktop vydaniami, takže termíny pre každé vydanie sa vrátia od každého Power BI Desktop dátumu vydania. Očakávané trvanie certifikačného procesu od registrácie po uvoľnenie sa líši v závislosti od kvality a zložitosti podania konektora a je uvedené v nasledujúcich krokoch:

  • Registrácia: oznámenie o zámere certifikovať vlastný konektor. Toto sa musí uskutočniť do 15. mesiaca, dva mesiace pred cieľovým vydaním pracovnej plochy služby Power BI.

    • Napríklad pre aprílové Power BI Desktop vydanie by bol termín 15. februára.
  • Odoslanie: odoslanie súborov konektorov na kontrolu spoločnosti Microsoft. Toto sa musí uskutočniť do 1. mesiaca pred cieleným vydaním pracovnej plochy služby Power BI.

    • Napríklad pre aprílové Power BI Desktop uvoľnenie by bol termín 1. marec.
  • Technická kontrola: dokončenie súborov konektorov, absolvovanie kontroly a certifikácie spoločnosti Microsoft. To sa musí stať do 15. mesiaca pred cieľovým Power BI Desktop prepustením.

    • Napríklad pre aprílové Power BI Desktop vydanie by bol termín 15. marca.

Vzhľadom na zložitosť technických preskúmaní a potenciálnych oneskorení, odskúšanie a problémy s testovaním dôrazne odporúčame predložiť včasné predloženie s dlhou dodacom lehotou na počiatočné vydanie a certifikáciu. Ak máte pocit, že váš konektor je dôležitý na dodanie niekoľkým zákazníkom s minimálnymi režijnými nákladmi, odporúčame sa podpísať a poskytnúť ho týmto spôsobom.

Požiadavky na certifikáciu

Máme určitý súbor požiadaviek na certifikáciu. Uvedomujeme si, že nie každý vývojár môže splniť tieto požiadavky, a dúfame, že predstavíme súbor funkcií, ktorý bude riešiť potreby vývojárov v krátkom čase.

Súbory na odosielanie (artefakty)

Uistite sa, že odosielané súbory konektorov obsahujú všetky nasledujúce:

  • Súbor konektora (.mez)

    • Súbor .mez by mal dodržiavať štandardy štýlu a mal by byť pomenovaný podobne ako názov produktu alebo služby. Nemal by obsahovať slová ako "Power BI", "Konektor" alebo "API".
    • Pomenujte súbor .mez: ProductName.mez
  • Power BI Desktop (.pbix) súbor na testovanie

    • Na testovanie konektora potrebujeme vzorovú zostavu služby Power BI (.pbix).
    • Zostava by mala obsahovať aspoň jeden dotaz na testovanie každej položky v navigačnej tabuľke.
    • Ak neexistuje žiadna schéma množiny (napríklad databázy), zostava musí obsahovať dotaz pre každý "typ" tabuľky, ktorý môže konektor spracovať.
  • Testovanie účtu na zdroj údajov

    • Testovací účet použijeme na testovanie a riešenie problémov s konektorom.
    • Poskytnite trvalé testovacie konto, aby sme mohli použiť rovnaké konto na certifikáciu akýchkoľvek budúcich aktualizácií.
  • Pokyny na testovanie

    • Poskytnite akúkoľvek dokumentáciu o tom, ako používať konektor a otestovať jeho funkčnosť.
  • Prepojenia na externé závislosti (napríklad ovládače ODBC)

Funkcie a štýl

Konektor musí dodržiavať množinu pravidiel funkcií a štýlu, aby spĺňal štandard použiteľnosti v súlade s inými certifikovanými konektormi.

  • Konektor MUSÍ:

  • Pre FunctionName doménu by to malo mať zmysel (napríklad "Obsah", "Tabuľky", "Dokument", "Databázy" athou).

  • Konektor by mal:

    • Mať ikony.
    • Poskytnite navigačnú tabuľku.
    • Umiestnite reťazce do resources.resx súboru. Adresy URL a hodnoty by mali byť pevne zakódované v kóde konektora a nemali by byť umiestnené v resources.resx súbore.

Zabezpečenie

Existujú špecifické bezpečnostné aspekty, ktoré musí konektor zvládnuť.

  • Ak Extension.CurrentCredentials() sa používa:

    • Je potrebné použitie? Ak áno, kam sa poverujú poverenia?
    • Sú žiadosti zaručené prostredníctvom HTTPS?
    • Ak sa poverenia odosielajú Web.Contents() pomocou funkcie GET:
      • Dá sa to premeniť na post?
      • Ak je potrebné získať, konektor MUSÍ použiť CredentialQueryString záznam v Web.Contents() zázname možností odovzdať citlivé poverenia.
  • Ak sa používajú funkcie Diagnostika.*:

    • overiť, čo sa sleduje; údaje nesmú obsahovať osobné údaje alebo veľké množstvo nepotrebných údajov.
    • Ak ste implementovali významné sledovanie vo vývoji, mali by ste implementovať premennú alebo príznak funkcie, ktorý určuje, či by malo byť sledovanie zapnuté. Pred podaním žiadosti o certifikáciu je potrebné toto vypnúť.
  • Ak Expression.Evaluate() sa používa:

    • Overte, odkiaľ výraz vychádza a odkiaľ ide (teda kde môže dynamicky vytvárať volania Extension.CurrentCredentials() a tak ďalej).
    • Nemali Expression by ste zadávať používateľom ani nepreberať vstup používateľa.
    • Názov Expression by nemal byť dynamický (to znamená načítaný z webového volania).

Registrácia na certifikáciu

Ak máte záujem o certifikáciu vlastného konektora, uistite sa, že váš scenár a konektor spĺňajú predpoklady a požiadavky uvedené v tomto článku. Ak to nespravíme, spôsobí to oneskorenia certifikácie, pretože náš tím bude vyžadovať, aby ste všetky problémy alebo nekonzistentnosti opravli ešte pred prechodom na certifikáciu.

Začnite tým, že dokončíte náš registračnýformulár a kontakt od spoločnosti Microsoft sa skontaktá s jeho začatím.

Po vytvorení konektora k zdroju údajov zvážte pomoc zákazníkom v rýchlom spustení tak, že vytvoríte aplikáciu šablón. Aplikácia šablón poskytuje zákazníkom preddefinovanú zostavu pripojenú k údajom, ktoré môžu použiť preddefinované alebo prispôsobiť podľa potreby.

Poznámka

Aplikácie šablón nepodporuje konektory, ktoré vyžadujú bránu.