Certifikované vizuály Power BI

Článok
02/18/2024

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 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.

Poznámka

Sme v procese migrácie z TSlint do ESLint. Vizuály používajúci TSlint budú akceptované na certifikáciu do marca 2023. Potom bude potrebné ESlint.

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 .

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 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(), nebezpečné použitie metód settimeout(), requestAnimationFrame(), setinterval(user input function)a vstup používateľov alebo údaje používateľov.
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.

Certifikované vizuály Power BI v AppSource

Keď niekto v službe AppSource vyhľadáva vizuály Power BI v režime online, malý žltý odznak na karte vizuálu označuje, že ide o certifikovaný vizuál Power BI.
Po kliknutí na kartu vizuálu Power BI v AppSource, žltý odznak s názvom PBI Certified označuje, že tento vizuál Power BI je certifikovaný.

Certifikované vizuály Power BI v rozhraní služby Power BI

Pri importovaní vizuálu Power BI z Power BI (počítačovej aplikácie alebo služby) signalizuje modrý odznak, že vizuál Power BI je certifikovaný.
Môžete zobraziť iba certifikované vizuály Power BI tak, že vyberiete možnosť filtra Certifikovaný v službe Power BI.

Časová os publikovania

Proces nasadenia do služby AppSource môže trvať určitý čas. Po dokončení tohto procesu bude vizuál služby Power BI k dispozícii na stiahnutie zo služby AppSource.

Kedy si budú môcť používatelia stiahnuť môj vizuál?

Ak ste odoslali nový vizuál služby Power BI, používatelia si ho budú môcť stiahnuť niekoľko hodín po tom, ako dostanete e-mail zo služby AppSource.
Ak ste odoslali aktualizáciu existujúceho vizuálu služby Power BI, používatelia si ho budú môcť stiahnuť do dvoch týždňov od odoslania.

Poznámka

Pole verzie v AppSource sa aktualizuje v deň, kedy bola služba Power BI schválená službou AppSource, približne týždeň po odoslaní vizuálu. Používatelia si budú môcť stiahnuť aktualizovaný vizuál, ale aktualizované funkcie sa neprevezmú. Nové funkcie vizuálu budú mať vplyv na zostavy používateľa približne po dvoch týždňoch.

Kedy sa v mojom vizuáli služby Power BI zobrazí certifikačný štítok?

Certifikačný štítok by mal byť viditeľný do troch týždňov po schválení vášho odoslania.

Máte ďalšie otázky? Skúste Komunita Power BI.

Certifikované vizuály Power BI

Odstránenie certifikácie