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 tanúsí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 szóló útmutatót olvashat.

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

• A vizualizáció nem egy R-vizualizáció.
• 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 certification nevű ág (kisbetűvel). 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á a node_modules, .tmp és dist elemeket ehhez 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 adhat magas vagy közepes szintű figyelmeztetéseket.
• ESlint a szükséges konfigurációval. Ennek a parancsnak nem szabad lint hibákat eredményeznie.

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

Készítse el a Power BI-vizualizációt 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.

Tilos

• 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 innerHTML, vagy a D3.html(user data or user input) használata.
• 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álatasettimeout()requestAnimationFrame()setinterval(user input function).
• Tömörített 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 hozzáférés 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 beküldött egy új Power BI-vizualizációt, az néhány órán belül letölthető lesz az AppSource hivatkozásról. Azonban további 10–14 napot vesz igénybe, hogy elérje a gyártási szakaszt, és elérhetővé váljon a Power BI Desktopban/Szolgáltatásban.

• Ha frissítést küldött egy meglévő Power BI-vizualizációhoz, az új verzió az AppSource-on is megjelenik, de az éles környezetben való üzembe helyezés akár két hétig is eltarthat.

  Megjegyzé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 kapja meg a Power BI-vizualizációm a minősítési jelvényt?

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.