Certifikované vizuály Power BI

Certifikované vizuály služby Power BI sú vizuály služby Power BI na lokalite AppSource, ktoré spĺňajú požiadavky na kód a testovanie tímu Microsoft Power BI. Vykonané testy sú navrhnuté tak, aby sa skontrolovalo, či vizuál nepristupuje k externým službám alebo zdrojom. Spoločnosť Microsoft však nie je autorom vlastných vizuálov tretích strán a odporúčame zákazníkom, aby sa obrátili priamo na autora, kde si môžu overiť funkčnosť týchto vizuálov.

Certifikované vizuály služby Power BI možno používať rovnako ako všetky ostatné vizuály služby Power BI. Ponúkajú viac funkcií ako necertifikované vizuály. Môžete ich napríklad exportovať do PowerPointu alebo zobraziť vizuál v prijatých e-mailoch, keď sa používateľ prihlási na odber strán zostavy.

Proces certifikácie je voliteľný. Je na vývojároch, či sa rozhodnú certifikovať svoj vizuál. Vizuály služby Power BI, ktoré nie sú certifikované, nie sú nevyhnutne nebezpečné. Niektoré vizuály služby Power BI nie sú certifikované, pretože nie sú v súlade s jednou alebo viacerými požiadavkami na certifikáciu. Nie je možné certifikovať napríklad mapový vizuál služby Power BI, ktorý sa pripája k externej službe, alebo vizuál služby Power BI, ktorý používa komerčné knižnice.

Odstránenie certifikácie

Spoločnosť Microsoft si podľa vlastného uváženia vyhradzuje právo odstrániť vizuál zo zoznamu certifikovaných vizuálov.

Požiadavky na certifikáciu

Ak chcete svoj vizuál služby Power BI certifikovať, musí spĺňať požiadavky uvedené v tejto časti.

Všeobecné požiadavky

Vizuál služby Power BI musí byť schválený v Centre pre partnerov. Pred vyžiadaním certifikácie odporúčame, aby ste svoj vizuál služby Power BI publikovali v službe AppSource. Ak chcete zistiť, ako publikovať vizuál služby Power BI na lokalitu AppSource, pozrite si tému Publikovanie vizuálov služby Power BI v Centre pre partnerov.

Pred odoslaním vizuálu služby Power BI na certifikáciu overte, či:

Vizuál nie je vizuálom R
Vizuál je v súlade s pokynmi pre vizuály služby Power BI
Vizuál prejde všetkými požadovanými testami.
Kompilovaný balík sa presne zhoduje s odoslaným balíkom

Požiadavky na odkladací priestor kódu

Hoci svoj kód nemusíte verejne zdieľať v GitHube, odkladací priestor kódu by mal byť tímu služby Power BI k dispozícii na kontrolu. Najlepším spôsobom, ako to urobiť, je poskytnúť zdrojový kód (JavaScript alebo TypeScript) v GitHube.

Odkladací priestor musí obsahovať:

Kód len pre jeden vizuál služby Power BI. Nemôže obsahovať kód pre viac vizuálov služby Power BI ani nesúvisiaci kód.
Vetva s názvom certification (Certifikácia ) – vyžaduje sa na malé písmená). Zdrojový kód v tejto vetve sa musí zhodovať s odoslaným balíkom. Tento kód možno aktualizovať iba v rámci ďalšieho procesu odoslania, keď znova odošlete vizuál služby Power BI.

Ak váš vizuál služby Power BI používa súkromné balíky npm alebo submoduly git, musíte tiež poskytnúť prístup k odkladacím priestorom obsahujúcim tento kód.

Ak chcete pochopiť, ako vyzerá odkladací priestor na vizuály služby Power BI, pozrite si ukážkový pruhový graf vizuálov služby Power BI v odkladacom priestore GitHub.

Požiadavky na súbory

Na napísanie vizuálu služby Power BI použite najnovšiu verziu rozhrania API.

Odkladací priestor musí obsahovať nasledujúce súbory:

.gitignore – pridajte node_modules.tmp , a dist k tomuto súboru. Kód nemôže obsahovať priečinky node_modules, .tmp ani dist .
capabilities.json – Ak odosielate novšiu verziu existujúceho vizuálu služby Power BI so zmenami vlastností v tomto súbore, overte, či sa nepoškodili zostavy pre existujúcich používateľov.
pbiviz.json
package.json. Vizuál musí mať nainštalovaný nasledujúci balík:
- typescript
- "eslint"
- "eslint-plugin-powerbi-visuals"
- Súbor musí obsahovať príkaz na spustenie vlákna – "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
package-lock.json
tsconfig.json

Požiadavky na príkazy

Uistite sa, že nasledujúce príkazy nevracajú žiadne chyby.

npm install
pbiviz package
npm audit – nesmie vracať žiadne upozornenia s vysokou alebo strednou úrovňou.
ESlint s požadovanou konfiguráciou. Tento príkaz nesmie vracať žiadne chyby vlákien.

Požiadavky na kompilovanie

Na napísanie vizuálu služby Power BI použite najnovšiu verziu nástrojov powerbi-visuals-tools .

Kompilujte vizuál služby Power BI pomocou .pbiviz package Ak používate vlastné skripty zostáv, zadajte príkaz pre vlastnú zostavu npm run package .

Prepitné

Počnúc powerbi-visuals-tools verzie 6.1.0 môžete skontrolovať, či vo vizuáli nie sú nebezpečné volania , fetchXMLHttpRequesta eval pomocou nasledujúceho príkazu:

pbiviz package --certification-audit

Ak sa počas auditu zistí nebezpečný kód, môžete automaticky zostaviť balík s potrebnými opravami spustením:

pbiviz package --certification-fix

Tento príznak odstráni všetky zakázané volania. Príznak je určený len pre prípady, keď sú takéto funkcie súčasťou knižníc, ktoré sú mimo vašej kontroly. V prípade, že sa nevhodný kód nachádza vo vašom vlastnom úložisku, musí byť z kódu odstránený, aby boli splnené požiadavky na certifikáciu. Musíte dôkladne otestovať vizuál, aby ste sa uistili, že funguje podľa očakávaní. Tiež nezabudnite aktualizovať skript balíka npm spustiť v package.json aby sa predišlo nezhode hash počas certifikačnej recenzie.

Požiadavky na zdrojový kód

Uistite sa, že postupujete podľa zoznamu politík dodatočnej certifikácie vizuálov služby Power BI. Ak vaše odoslanie nie je v súlade s týmito usmerneniami, dostanete e-mail s odmietnutím z Centra pre partnerov s číslami politík uvedenými v tomto prepojení.

Dodržiavajte požiadavky na kód uvedené tu, aby ste sa uistili, že váš kód je v súlade s certifikačnými politikami služby Power BI.

Povinné

Používať iba verejné súčasti OSS, ktoré je možné skontrolovať, ako napríklad verejné knižnice JavaScript alebo TypeScript.
Kód musí podporovať rozhranie API na vykresľovanie udalostí.
S rozhraním DOM môžete narábať opatrne. Pred pridaním údajov používateľa do platformy DOM ich môžete dezinfikovať.
Ako testovaciu množinu údajov použite vzorovú zostavu .

Nie je povolené

Prístup k externým službám alebo zdrojom. Napríklad žiadne požiadavky protokolu HTTP/S alebo WebSocket nesmú vyjsť zo služby Power BI do iných služieb. Oprávnenia WebAccess by preto mali byť prázdne alebo by sa mali vynechať v nastaveniach možností.
Použitie XMLHttpRequesthodnoty alebo fetch.
Použitie innerHTMLhodnoty alebo D3.html(user data or user input).
Chyby alebo výnimky JavaScriptu v konzole prehliadača pre všetky vstupné údaje.
Ľubovoľný alebo dynamický kód, ako eval()napríklad , Function() nebezpečné používanie settimeout(), requestAnimationFrame(), setinterval(user input function), a vstup používateľa alebo používateľské údaje.
Minimalizované súbory alebo projekty JavaScriptu.

Odoslanie vizuálu Služby Power BI na certifikáciu

Teraz ste pripravení odoslať žiadosť o certifikáciu vizuálu služby Power BI tímom služby Power BI.

Prepitné

Proces certifikácie služby Power BI môže chvíľu trvať. Ak vytvárate nový vizuál služby Power BI, skôr než požiadate o certifikáciu služby Power BI, odporúčame, aby ste svoj vizuál publikovali cez Centrum pre partnerov. Tým sa zabezpečí, že sa váš vizuál publikuje načas.

Požiadanie o certifikáciu služby Power BI:

Prihláste sa do Centra pre partnerov.
Na stránke Overview (Prehľad) vyberte svoj vizuál služby Power BI a prejdite na stránku nastavenia Product (Produkt).
Začiarknite políčko Request Power BI certification (Požiadať o certifikáciu služby Power BI).
Na stránke Review and publish (Skontrolovať a publikovať) v textovom poli Notes for certification (Poznámky k certifikácii) poskytnite prepojenie na zdrojový kód a prihlasovacie údaje k nemu.

Proces odosielania do súkromného odkladacieho priestoru

Ak používate súkromný odkladací priestor, ako je napríklad GitHub, na odoslanie vizuálu služby Power BI na certifikáciu, postupujte podľa pokynov v tejto časti.

Vytvorte si nové konto pre overovací tím.
Nakonfigurujte dvojfaktorové overovanie pre svoje konto.
Vygenerujte novú množinu kódov na obnovenie.
Pri odosielaní vizuálu Power BI nezabudnite zadať nasledujúce podrobnosti:
- Prepojenie na odkladací priestor
- Prihlasovacie poverenia (vrátane hesla)
- Kódy na obnovenie
- Povolenia iba na čítanie pre naše konto (pbicvsupport)

Odznaky certifikovaných vizuálov Power BI

Keď je vizuál Power BI certifikovaný, získa určený odznak, ktorý označuje, že ide o certifikovaný vizuál Power BI.