Minősített Power BI-vizualizációk

A minősített Power BI-vizualizációk olyan Power BI-vizualizációk az AppSource-ban, amelyek megfelelnek a Microsoft Power BI csapatkód követelményeinek és tesztelésének. Az elvégzett tesztek célja annak ellenőrzése, hogy a vizualizáció nem fér-e hozzá külső szolgáltatásokhoz vagy erőforrásokhoz. A Microsoft azonban nem harmadik féltől származó egyéni vizualizációk szerzője, és azt javasoljuk, hogy az ügyfelek közvetlenül kapcsolatba lépjenek a szerzővel a vizualizációk működésének ellenőrzése érdekében.

A minősített Power BI-vizualizációk bármely más Power BI-vizualizációhoz hasonlóan használhatók. Több funkciót kínálnak, mint a nem módosított vizualizációk. Exportálhatja például őket a PowerPointba, vagy megjelenítheti a vizualizációt a kapott e-mailekben, amikor egy felhasználó feliratkozik a jelentésoldalakra.

A minősítési folyamat nem kötelező. A fejlesztőknek kell eldönteniük, hogy hitelesíteni szeretnék-e a vizualizációjukat. A nem minősített Power BI-vizualizációk nem feltétlenül biztonságosak. Egyes Power BI-vizualizációk nem rendelkeznek minősítéssel, mert nem felelnek meg egy vagy több tanúsítási követelménynek. Például egy külső szolgáltatáshoz csatlakozó térképes Power BI-vizualizáció vagy egy kereskedelmi kódtárakat használó Power BI-vizualizáció nem minősíthető.

A minősítés eltávolítása

A Microsoft fenntartja a jogot, hogy saját belátása szerint eltávolítson egy vizualizációt a minősített listáról.

Tanúsítási követelmények

A Power BI-vizualizáció minősítéséhez meg kell felelnie az ebben a szakaszban felsorolt követelményeknek.

Általános követelmények

A Power BI-vizualizációt a Partnerközpontnak jóvá kell hagynia. A minősítés kérése előtt javasoljuk, hogy tegye közzé Power BI-vizualizációját az AppSource-ban. A Power BI-vizualizációk AppSource-ban való közzétételéről a Power BI-vizualizációk Partnerközpontban való közzétételéről olvashat.

Mielőtt elküldené a Power BI-vizualizációt minősítésre, ellenőrizze, hogy:

• A vizualizáció megfelel a Power BI-vizualizációkra vonatkozó irányelveknek
• A vizualizáció megfelel az összes szükséges tesztnek
• A lefordított csomag pontosan megfelel a beküldött csomagnak

Kódtár követelményei

Bár a kódot nem kell nyilvánosan megosztania a GitHubon, a kódtárnak elérhetőnek kell lennie a Power BI csapatának véleményezéséhez. Ennek legjobb módja, ha megadja a forráskódot (JavaScript vagy TypeScript) a GitHubon.

Az adattárnak a következőket kell tartalmaznia:

• Csak egy Power BI-vizualizáció kódja. Nem tartalmazhat kódot több Power BI-vizualizációhoz vagy nem kapcsolódó kódhoz.
• Egy minősítés nevű ág (kisbetűs kötelező). Az ág forráskódjának meg kell egyeznie a beküldött csomagdal. Ez a kód csak a következő beküldési folyamat során frissíthető, ha újraküldi a Power BI-vizualizációt.

Ha a Power BI-vizualizáció privát npm-csomagokat vagy Git-almodulokat használ, akkor hozzáférést kell biztosítania a kódot tartalmazó adattárakhoz is.

A Power BI-vizualizációtárak megjelenésének megértéséhez tekintse át a Power BI-vizualizációk mintasávdiagramjának GitHub-adattárát.

Fájlkövetelmények

A Power BI-vizualizáció írásához használja az API legújabb verzióját.

Az adattárnak a következő fájlokat kell tartalmaznia:

• .gitignore – Adja hozzá .tmpnode_modulesés adja dist hozzá a fájlhoz. A kód nem tartalmazhat node_modules, .tmp vagy leválasztott mappákat.
• capabilities.json – Ha egy meglévő Power BI-vizualizáció újabb verzióját küldi el a fájl tulajdonságainak módosításával, ellenőrizze, hogy nem törik-e meg a meglévő felhasználók jelentéseit.
• pbiviz.json
• package.json. A vizualizációnak telepítve kell lennie a következő csomagnak:
  • "typescript"
  • "eslint"
  • "eslint-plugin-powerbi-visuals"
  • A fájlnak tartalmaznia kell egy parancsot a linter futtatásához – "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
• package-lock.json
• tsconfig.json

Parancskövetelmények

Győződjön meg arról, hogy a következő parancsok nem adnak vissza hibákat.

• npm install

• pbiviz package

• npm audit - Nem szabad magas vagy közepes szintű figyelmeztetést visszaadni.

• ESlint a szükséges konfigurációval. Ez a parancs nem ad vissza lint-hibákat.

  Feljegyzés

  Folyamatban van a TSlintről esLintre való migrálás. A TSlintet használó vizualizációkat 2023 márciusáig fogadjuk el minősítésre. Ezután ESlintre lesz szükség.

Összeállítási követelmények

A Power BI-vizualizációk írásához használja a powerbi-visuals-tools legújabb verzióját.

A Power BI-vizualizáció fordítása a pbiviz package. Ha saját buildszkripteket használ, adjon meg egy npm run package egyéni buildelési parancsot.

Forráskódra vonatkozó követelmények

Győződjön meg arról, hogy a Power BI-vizualizációk további minősítési szabályzatlistáját követi. Ha a beküldés nem követi ezeket az irányelveket, a Partnerközpont elutasító e-mailt kap a hivatkozásban felsorolt szabályzatszámokkal.

Az itt felsorolt kódkövetelményeket követve győződjön meg arról, hogy a kód összhangban van a Power BI tanúsítási szabályzataival.

Kötelező

• Csak nyilvánosan áttekinthető OSS-összetevőket, például nyilvános JavaScript- vagy TypeScript-kódtárakat használjon.
• A kódnak támogatnia kell a Rendering Events API-t.
• Győződjön meg arról, hogy a DOM biztonságosan van manipulálva. Mielőtt hozzáadja a DOM-hoz, használjon fertőtlenítést a felhasználói bevitelhez vagy a felhasználói adatokhoz.
• Használja a mintajelentést tesztadatkészletként.

Nem engedélyezett

• Külső szolgáltatások vagy erőforrások elérése. Például egyetlen HTTP/S- vagy WebSocket-kérés sem mehet ki a Power BI-ból semmilyen szolgáltatásba. Ezért a WebAccess-jogosultságoknak üresnek vagy kihagyottnak kell lenniük a képességek beállításai között.
• A vagy a D3.html(user data or user input).innerHTML
• JavaScript-hibák vagy kivételek a böngészőkonzolon a bemeneti adatok esetében.
• Tetszőleges vagy dinamikus kód, például eval()a felhasználó által bevitt vagy felhasználói adatok nem biztonságos használatarequestAnimationFrame()settimeout()setinterval(user input function).
• Minified JavaScript-fájlok vagy -projektek.

Power BI-vizualizáció beküldése minősítéshez

Most már készen áll arra, hogy küldjön egy kérést, hogy a Power BI-vizualizációt a Power BI csapata minősítse.

Tipp.

A Power BI tanúsítási folyamata időt vehet igénybe. Ha új Power BI-vizualizációt hoz létre, javasoljuk, hogy a Power BI-vizualizációt a Partnerközponton keresztül tegye közzé, mielőtt Power BI-minősítést kér. Ez biztosítja, hogy a vizualizáció közzététele ne késlekedjön.

Power BI-tanúsítvány kérése:

1. Jelentkezzen be a Partnerközpontba.
2. Az Áttekintés lapon válassza ki a Power BI-vizualizációt, és lépjen a Termék beállítási lapjára.
3. Jelölje be a Power BI-tanúsítvány kérése jelölőnégyzetet.
4. A Véleményezés és közzététel lapon, a Minősítési megjegyzések szövegmezőben adjon meg egy hivatkozást a forráskódra és a hozzáféréshez szükséges hitelesítő adatokra.

Privát adattár beküldési folyamata

Ha egy privát adattárat, például a GitHubot használ a Power BI-vizualizáció minősítésre való elküldéséhez, kövesse az ebben a szakaszban található utasításokat.

1. Hozzon létre egy új fiókot az érvényesítési csapat számára.
2. Konfiguráljon kéttényezős hitelesítést a fiókjához.
3. Hozzon létre egy új helyreállítási kódkészletet.
4. A Power BI-vizualizáció elküldésekor mindenképpen adja meg az alábbi adatokat:
   • Az adattárra mutató hivatkozás
   • Bejelentkezési hitelesítő adatok (jelszóval együtt)
   • Helyreállítási kódok
   • Írásvédett engedélyek a fiókunkhoz (pbicvsupport)

Minősített Power BI-vizualizációs jelvények

A Power BI-vizualizáció minősítése után egy kijelölt jelvényt kap, amely azt jelzi, hogy az egy minősített Power BI-vizualizáció.

Minősített Power BI-vizualizációk az AppSource-ban

• Amikor valaki online keres Power BI-vizualizációkat az AppSource-ban, a vizualizáció kártyáján egy kis sárga jelvény jelzi, hogy ez egy minősített Power BI-vizualizáció.

  

• Amikor a Power BI-vizualizációs kártyára kattint az AppSource-ban, a PBI Certified nevű sárga jelvény azt jelzi, hogy ez a Power BI-vizualizáció minősítéssel rendelkezik.

  

Minősített Power BI-vizualizációk a Power BI felületén

• Ha egy Power BI-vizualizációt importál a Power BI-ból (Asztali vagy szolgáltatás), a kék jelvény azt jelzi, hogy a Power BI-vizualizáció minősítéssel rendelkezik.

  

• Csak minősített Power BI-vizualizációkat jeleníthet meg a Power BI Minősített szűrő lehetőség kiválasztásával.

Közzététel ütemterve

Az AppSource-ra való üzembe helyezés folyamata időigényes lehet. A Power BI-vizualizáció letölthető lesz az AppSource-ból, ha a folyamat befejeződött.

Mikor tölthetik le a felhasználók a vizualizációmat?

• Ha új Power BI-vizualizációt küldött be, a felhasználók néhány órával azután tölthetik le, hogy e-mailt kapott az AppSource-tól.

• Ha egy meglévő Power BI-vizualizációra küldött frissítést, a felhasználók a beküldést követő két héten belül letölthetik azt.

  Feljegyzés

  Az AppSource verziómezője a Power BI AppSource általi jóváhagyásának napjával frissül, körülbelül egy héttel a vizualizáció elküldése után. A felhasználók letölthetik a frissített vizualizációt, de a frissített képességek nem lépnek érvénybe. A vizualizáció új képességei körülbelül két hét múlva hatással lesznek a felhasználó jelentéseire.

Mikor jelenik meg a Power BI-vizualizációm egy minősítési jelvény?

A minősítési jelvénynek a beküldés jóváhagyását követő három héten belül láthatónak kell lennie.

Kapcsolódó tartalom

• A minősített vizualizációkkal kapcsolatos gyakori kérdések.
• Útmutató a Power BI-vizualizációk közzétételéhez

Van még esetleg kérdése? Próbálja ki a Power BI-közösség.