Sertifioinnin hankkiminen Power BI -visualisoinnille

Sertifioidut Power BI -visualisoinnit ovat AppSourcessa sijaitsevia Power BI -visualisointeja, jotka täyttävät Power BI -tiimin koodivaatimukset. Nämä visualisoinnit testataan sen todentamiseksi, etteivät ne käytä ulkoisia palveluita eivätkä resursseja ja että ne seuraavat turvallisia koodausmalleja ja ohjeita.

Kun Power BI -visualisointi on sertifioitu, se tarjoaa lisää ominaisuuksia. Voit esimerkiksi viedä sisältöä PowerPointiin tai näyttää visualisoinnin raporttisivujen tilaamisen yhteydessä lähetettävissä sähköposteissa.

Sertifiointimenettely on valinnainen. Sertifioimattomat Power BI -visualisoinnit eivät välttämättä ole turvallisuudelle vaarallisia Power BI -visualisointeja. Jotkin Power BI -visualisoinnit eivät ole sertifioituja, koska ne eivät täytä yhtä tai useampaa sertifiointivaatimusta. Esimerkkejä voivat olla Power BI -karttavisualisointi, joka on yhteydessä ulkoiseen palveluun, tai kaupallisia kirjastoja hyödyntävä Power BI -visualisointi.

Huomautus

Microsoft ei ole kolmannen osapuolen Power BI ‑visualisointien tekijä. Kolmannen osapuolen visualisointien toiminnallisuuden todentamiseksi on otettava suoraan yhteyttä visualisoinnin tekijään.

Sertifioinnin edellytykset

Jos haluat hankkia Power BI -visualisoinnillesi sertifioinnin, Power BI -visualisointisi on oltava tässä osiossa lueteltujen vaatimusten mukainen.

Yleiset vaatimukset

Power BI visualisoinnin on oltava kumppanikeskuksen hyväksymä. On suositeltavaa, että Power BI -visualisointisi on jo AppSourcessa. Katso lisätietoja Power BI -visualisoinnin julkaisemisesta AppSourcessa artikkelista Power BI -visualisointien julkaiseminen kumppanikeskuksessa.

Ennen kuin lähetät Power BI visualisoinnin sertifioitamiseksi, varmista, että:

Koodisäilön vaatimukset

Vaikka sinun ei tarvitse julkisesti jakaa koodiasi GitHubissa, koodisäilön on oltava saatavilla Power BI -tiimin tarkistettavaksi. Paras tapa tehdä tämä on toimittamalla lähdekoodi (JavaScript tai TypeScript) GitHubissa.

Säilön on sisällettävä seuraavat:

  • Koodi vain yhdelle Power BI -visualisoinnille. Se ei saa sisältää useiden Power BI -visualisointien koodia eikä asiaan liittymätöntä koodia.
  • Haara, jonka nimi on sertifiointi (pieni alkukirjain pakollinen). Tämän haaran lähdekoodin on vastattava lähetettyä pakettia. Tätä koodia saa päivittää vain seuraavan lähetysmenettelyn yhteydessä, jos olet lähettämässä Power BI -visualisointisi uudelleen.

Jos Power BI -visualisointisi käyttää yksityisiä NPM-paketteja tai git-alityyppejä, sinun on järjestettävä käyttöoikeus tämän koodin sisältäviin lisäsäilöihin.

Jos haluat tietää, miltä Power BI -visualisointisäilö näyttää, tarkastele Power BI -visualisointien esimerkkipalkkikaavion GitHub-säilöä.

Tiedostovaatimukset

Käytä ohjelmointirajapinnan viimeisintä versiota Power BI -visualisoinnin kirjoittamiseen.

Säilön on sisällettävä seuraavat tiedostot:

  • .gitignore: lisää node_modules, .tmp ja dist tähän tiedostoon. Koodi ei voi sisältää node_modules-, .tmp- tai dist-kansioita.
  • capabilities.json - Jos olet lähettämässä uutta versiota Power BI -visualisoinnistasi ja siihen kuuluu tämän tiedoston ominaisuuksiin liittyviä muutoksia, varmista, että ne eivät ole ristiriidassa olemassa olevien käyttäjien raporttien kanssa.
  • pbiviz.json
  • package.json. Visualisoinnissa on oltava asennettuna seuraava paketti:
    • "tslint": versio 5.18.0 tai uudempi
    • "typescript": versio 3.0.0 tai uudempi
    • "tslint-microsoftcontrib": versio 6.2.0 tai uudempi.
    • Tiedoston täytyy sisältää komento seuraavan suorittamiseksi: linter - "lint": "tslint -c tslint.json -p tsconfig.json"
  • package-lock.json
  • tsconfig.json

Komentovaatimukset

Varmista, että seuraavat komennot eivät palauta mitään virheitä.

  • npm install
  • pbiviz package
  • npm audit - Ei saa palauttaa korkean tai kohtalaisen tason varoituksia.
  • TSlint Microsoftilta ja vaadittu määritys. Tämä komento ei saa palauttaa mitään lint-virheitä.

Kääntämisvaatimukset

Käytä viimeisintä powerbi-visuals-tools-versiota Power BI -visualisoinnin kirjoittamiseen.

Sinun on käännettävä Power BI -visualisointisi apunasi pbiviz package. Jos käytät omia koontikomentosarjojasi, järjestä mukautettu npm run package-koontikomento.

Lähdekoodivaatimukset

Varmista, että noudatat Power BI -visualisointien lisäsertifioinnin käytäntöjen luetteloa. Jos lähetyksesi ei noudata näitä ohjeita, kumppanikeskuksen hylkäyssähköpostiviesti sisältää tässä linkissä luetteloidut käytäntöjen numerot.

Noudata alla lueteltuja koodivaatimuksia sen varmistamiseksi, että koodisi on Power BI -sertifiointikäytäntöjen mukainen.

Seuraavat ovat pakollisia:

  • Käytä vain julkisesti tarkistettavissa olevia OSS-komponentteja, kuten julkisia JavaScript- tai TypeScript-kirjastoja.
  • Koodin on tuettava Tapahtumien hahmontaminen -ohjelmointirajapintaa.
  • Varmista, että DOM-objektia manipuloidaan luotettavasti. Käytä sanitaatiota käyttäjän syötteessä tai käyttäjätiedoissa, ennen kuin lisäät sen DOM-objektiin.
  • Käytä tätä malliraporttia testitietojoukkona.

Seuraavat eivät ole sallittuja:

  • Ulkoisten palvelujen tai resurssien käyttö. Power BI:stä ei esimerkiksi lähde HTTP/S- tai WebSocket-pyyntöjä palveluihin.
  • Kohteiden innerHTML tai D3.html(user data or user input) käyttäminen.
  • Selainkonsolissa olevat JavaScript-virheet tai -poikkeukset syötetiedoille.
  • Mielivaltainen tai dynaaminen koodi, kuten eval(), kohteen settimeout() suojaamaton käyttö, requestAnimationFrame(), setinterval(user input function) ja käyttäjän syöte tai käyttäjän tiedot.
  • Minified JavaScript -tiedostot tai -projektit.

Power BI -visualisoinnin lähettäminen sertifioitavaksi

Voit pyytää, että Power BI -tiimi sertifioi Power BI -visualisointisi kumppanikeskuksen kautta.

Vihje

Power BI:n sertifiointiprosessi saattaa kestää jonkin aikaa. Jos olet luomassa uutta Power BI -visualisointia, suosittelemme sinua julkaisemaan Power BI -visualisointisi kumppanikeskuksen kautta, ennen kuin pyydät Power BI -sertifiointia. Näin varmistat sen, ettei visualisointisi julkaiseminen viivästy.

Power BI -sertifioinnin pyytäminen:

  1. Kirjaudu sisään kumppanikeskukseen.
  2. Valitse Yleiskatsaus-sivulla Power BI -visualisointi, ja siirry Tuotteen asennus -sivulle.
  3. Valitse Pyydä Power BI -sertifiointia -valintaruutu.
  4. Anna Tarkista ja julkaise -sivun Sertifiointia koskevat huomautukset -tekstiruutuun linkki lähdekoodiin ja sen käyttämiseen tarvittavat tunnistetiedot.

Yksityisen säilön lähettämisprosessi

Jos käytät yksityistä säilöä, kuten GitHub-säilöä, joka lähettää Power BI -visualisoinnin varmentamista varten, noudata tämän osan ohjeita.

  1. Luo uusi tili vahvistustiimiä varten.
  2. Määritä tiliisi kaksivaiheinen todentaminen.
  3. Luo uusi palautuskoodijoukko.
  4. Kun lähetät Power BI visualisointia, varmista, että annat seuraavat:
    • Linkki säilöön
    • Kirjautumisen tunnistetiedot (salasana mukaan lukien)
    • Palautuskoodit
    • Vain luku -oikeudet tiliimme (pbidvsupport)

Sertifioitujen Power BI -visualisointien merkit

Kun Power BI -visualisointi sertifioidaan, se saa merkin tästä.

Sertifioidut Power BI -visualisoinnit AppSourcessa

  • Kun haet Power BI -visualisointeja verkossa AppSourcessa, pieni keltainen merkki visualisoinnin kortissa ilmaisee sitä, että se on sertifioitu Power BI -visualisointi.

    AppSourcen sertifioitu Power BI -visualisointi

  • Kun napsautat Power BI -visualisoinnin korttia AppSourcessa, keltainen merkki, jossa lukee PBI Certified (tai PBI-sertifioitu) ilmaisee sitä, että kyseinen Power BI -visualisointi on sertifioitu.

    Sovellussivu ja sertifioitu Power BI -visualisointi

Sertifioidut Power BI -visualisoinnit Power BI -käyttöliittymässä

  • Kun tuot Power BI -visualisointia Power BI:stä (Desktop tai palvelu), sininen merkki ilmaisee, että Power BI -visualisointi on sertifioitu.

    Power BI -käyttöliittymän sertifioitu Power BI -visualisointi

  • Voit näyttää vain sertifioidut Power BI -visualisoinnit valitsemalla Power BI -sertifioitu -suodatinasetuksen.

Julkaisun aikajana

Käyttöönotto Appsourceen on prosessi, joka voi kestää jonkin aikaa. Power BI -visualisointi on ladattavissa Appsourcesta, kun tämä prosessi on valmis.

Milloin käyttäjät pystyvät lataamaan visualisoinnin?

  • Jos olet lähettänyt Power BI -visualisoinnin ensimmäistä kertaa, käyttäjät voivat ladata sen muutaman tunnin kuluttua siitä, kun olet saanut sähköpostiviestin Appsourcesta.

  • Jos lähetit päivityksen aiemmin luotuun Power BI visualisointiin, käyttäjät voivat ladata sen kahden viikon kuluessa lähettämisestäsi.

    Huomautus

    Appsourcen Versio-kenttä päivitetään, kun AppSource on hyväksynyt Power BI:n noin viikko sen jälkeen, kun olet lähettänyt visualisoinnin. Käyttäjät voivat ladata päivitetyn visualisoinnin, mutta päivitetyt toiminnot eivät tule voimaan. Visualisoinnin uudet ominaisuudet vaikuttavat käyttäjän raportteihin noin kahden viikon kuluttua.

Milloin Power BI -visualisointi näyttää sertifiointimerkin?

  • Jos olet lähettänyt Power BI -visualisoinnin ensimmäistä kertaa, sertifiointimerkki ilmestyy päivän kuluessa siitä, kun hän saa hyväksymisestä sähköpostiviestin Appsourcesta.

  • Jos pyydät sertifiointia olemassa olevaan Power BI visualisointiin, sertifiointimerkki näkyy kahden viikon kuluessa lähettämisestäsi.

Seuraavat vaiheet