Få et visualobjekt for Power BI sertifisert

Sertifiserte Power BI-visualobjekter er Power BI-visualobjekter i AppSource som oppfyller kodekravene til Microsoft Power BI-teamet. Disse visualobjektene testes for å bekrefte at de ikke får tilgang til eksterne tjenester eller ressurser og at de følger sikre kodemønstre og retningslinjer.

Når et visualobjekt i Power BI er sertifisert, blir flere funksjoner tilgjengelig. Du kan for eksempel eksportere til PowerPoint eller vise visualobjektet i e-poster som mottas når en bruker abonnerer på rapportsider.

Sertifiseringsprosessen er valgfri. Power BI-visualobjekter som ikke er sertifisert, er ikke nødvendigvis usikre Power BI-visualobjekter. Enkelte Power BI-visualobjekter er ikke sertifisert, fordi de ikke samsvarer med et eller flere av sertifiseringskravene. Et Power BI-visualobjekt for et kart som for eksempel tilkobles en ekstern tjeneste, eller et Power BI-visualobjekt som benytter kommersielle biblioteker.

Obs!

Microsoft er ikke forfatter av Power BI-visualobjekter fra tredjeparter. Vi anbefaler å ta kontakt med forfatteren direkte for å bekrefte funksjonaliteten for visualobjekter fra tredjepart.

Sertifiseringskrav

For å få et Power BI-visualobjekt sertifisert, må Power BI-visualobjektet overholde kravene som er oppført her.

Generelle krav

Power BI-visualobjektene dine må godkjennes av Partnersenter. Vi anbefaler at Power BI-visualobjektet allerede er i AppSource. For å finne ut hvordan du publiserer et Power BI-visualobjekt til AppSource, kan du se Publisere Power BI-visualobjekter til Partner Center.

Før du sender inn Power BI visualobjektet som skal sertifiseres, må du kontrollere at:

Krav til koderepositorier

Selv om du ikke må dele koden din offentlig i GitHub, må koderepositoriet være tilgjengelig for en gjennomgang av Power BI-teamet. Den beste måten å gjøre dette på, er å gjøre kildekoden (JavaScript eller TypeScript) tilgjengelig i GitHub.

Repositoriet må inneholde dette:

  • Kode for bare ett Power BI-visualobjekt. Det kan ikke inneholde kode for flere Power BI -visualobjekter eller ikke-relatert kode.
  • En gren med navnet sertifisering (små bokstaver er obligatorisk). Kildekoden i denne grenen må samsvare med den innsendte pakken. Denne koden kan bare oppdateres i neste innsendingsprosess hvis du sender Power BI-visualobjektet på nytt.

Hvis Power BI-visualobjektet bruker private npm-pakker, eller git-undermoduler, må du gi tilgang til de ekstra repositoriene som inneholder denne koden.

Hvis du vil forstå hvordan en Power BI-visualobjektdatabase ser ut, kan du se gjennom GitHub-repositoriet for Eksempler av stolpediagram-visualobjekter for Power BI.

Filkrav

Bruk den nyeste versjonen av API-en til å utvikle Power BI-visualobjektet.

Repositoriet må inkludere følgende filer:

  • .gitignore - Legg til node_modules, .tmp og dist i denne filen. Koden kan ikke inkludere mapper for node_modules, .tmp eller dist.
  • capabilities.json – Hvis du sender inn en nyere versjon av Power BI-visualobjektet med endringer i egenskapene i denne filen, må du kontrollere at de ikke bryter rapporter for eksisterende brukere.
  • pbiviz.json
  • package.json. Visualobjektet må ha denne pakken installert:
    • "tslint" - Versjon 5.18.0 eller høyere
    • "typescript" - Versjon 3.0.0 eller høyere
    • "tslint-microsoftcontrib" - Versjon 6.2.0 eller høyere
    • Filen må inneholde en kommando for kjøring av linter -"lint": "tslint -c tslint.json -p tsconfig.json"
  • package-lock.json
  • tsconfig.json

Kommandokrav

Sørg for at følgende kommandoer ikke returnerer noen feil.

Kompileringskrav

Bruk den nyeste versjonen av powerbi-visuals-tools til å utvikle Power BI-visualobjektet.

Du må kompilere Power BI-visualobjektet med pbiviz package. Hvis du bruker dine egne versjonsskript, må du oppgi en npm run package egendefinert versjonskommando.

Krav til kildekode

Kontroller at du følger policylisten for Ekstra sertifisering for Power BI-visualobjekter. Hvis innsendingen ikke følger disse retningslinjene, vil avvisnings-e-postmeldingen fra Partner Center inkludere policynumrene som er oppført i denne koblingen.

Følg kodekravene som er oppført nedenfor for å påse at koden er på linje med Power BI-sertifiseringspolicyene.

Følgende er obligatorisk:

  • Bruk bare offentlige, tilgjengelige OSS-komponenter, blant annet offentlige JavaScript- eller TypeScript-biblioteker.
  • Koden må støtte API-en for gjengivelse av hendelser.
  • Påse at DOM er manipulert på en sikker måte. Bruk sanering for brukerinndata eller brukerdata før du legger dem til i DOM.
  • Bruk eksempelrapporten som et testdatasett.

Følgende er ikke tillatt:

  • Tilgang til eksterne tjenester eller ressurser. Mellom annet kan ingen HTTP/S- eller WebSocket-forespørsler gå fra Power BI til andre tjenester.
  • Bruk innerHTML eller D3.html(user data or user input).
  • Javascript-feil eller -unntak i nettleserkonsollen for eventuelle inndata.
  • Tilfeldig eller dynamisk kode som eval(), utrygg bruk av settimeout(), requestAnimationFrame(), setinterval(user input function)og brukerinndata eller brukerdata.
  • Minimerte JavaScript-filer eller -prosjekter.

Slik sender du inn et visualobjekt i Power BI for sertifisering

Du kan be om å få visualobjektet ditt i Power BI sertifisert av Power BI-avdelingen via partnersenteret.

Tips!

Power BI-sertifiseringsprosessen kan ta tid. Hvis du oppretter et nytt visualobjekt i Power BI, anbefaler vi at du publiserer Power BI-visualobjektet via partnersenteret før du ber om Power BI-sertifisering. Dette sikrer at publiseringen av visualobjektet ikke forsinkes.

Slik ber du om Power BI-sertifisering:

  1. Logg deg på partnersenteret.
  2. Oversiktssiden velger du visualobjektet ditt i Power BI og går videre til innstillingssiden for Produkt.
  3. Merk av for Forespørsel om Power BI-sertifisering.
  4. Angi en kobling til kildekoden og legitimasjonen som kreves for å få tilgang til den på siden Se gjennom og publiser i tekstboksen Notater om sertifisering.

Innsendingsprosess for privat repositorium

Hvis du bruker et privat repositorium som GitHub for å sende Power BI-visualobjekter til sertifisering, følger du instruksjonene i dette avsnittet.

  1. Opprett en ny konto for valideringsteamet.
  2. Konfigurer godkjenning med to faktorer for kontoen din.
  3. Opprett et nytt sett gjenopprettingskoder.
  4. Når du sender inn Power BI visualobjektet, må du sørge for at du oppgir følgende:
    • En nettkobling til repositoriet
    • Påloggingsinformasjon (inkludert passord)
    • Gjenopprettingskoder
    • Skrivebeskyttet tilgang til kontoen vår (pbicvsupport)

Merker for sertifiserte Power BI-visualobjekter

Når et Power BI-visualobjekt er sertifisert, får det et angitt merke som indikerer at det er sertifisert.

Sertifiserte Power BI-visualobjekter i AppSource

  • Når du søker på nettet etter Power BI-visualobjekter i AppSource, indikerer et lite gult merke på visualobjektets kort at det er et sertifisert Power BI-visualobjekt.

    Sertifisert Power BI-visualobjekt i AppSource

  • Etter at du har klikket på Power BI-visualobjektets kort i AppSource, indikerer et gult merke med teksten PBI-godkjent at dette Power BI-visualobjektet er sertifisert.

    Sertifisert Power BI-visualobjekt i appside

Sertifiserte Power BI-visualobjekter i Power BI-grensesnittet

  • Når du importerer et Power BI-visualobjekt innenfor Power BI (Desktop eller tjeneste), indikerer et blått merke at Power BI-visualobjektet er sertifisert.

    Sertifiserte Power BI-visualobjekter i Power BI-grensesnittet

  • Du kan vise bare sertifiserte Power BI-visualobjekter ved å velge filteralternativet Power BI-godkjent.

Tidslinje for publisering

Distribusjon til AppSource er en prosess som kan ta litt tid. Power BI visualobjekt vil være tilgjengelig for nedlasting fra AppSource når denne prosessen er fullført.

Når vil brukere kunne laste ned visualobjektet mitt?

  • Hvis du har sendt et Power BI visualobjekt for første gang, kan brukerne laste ned et par timer etter at du har mottatt en e-post fra AppSource.

  • hvis du har sendt en oppdatering til en eksisterende Power BI visuell effekt, kan brukerne laste den ned i løpet av to uker i innsendingen.

    Obs!

    versjon-feltet i AppSource vil bli oppdatert med dagen din Power BI ble godkjent av AppSource, omtrent en uke etter at du sendte inn visualobjektet. Brukere kan laste ned det oppdaterte visualobjektet, men de oppdaterte egenskapene trer ikke i kraft. De visuelle nye egenskapene vil påvirke brukerens rapporter etter omtrent to uker.

Når vil mitt Power BI visualobjekt vise et sertifiseringsmerke?

  • Hvis du har sendt et Power BI visualobjekt for første gang, vises sertifiseringsmerket i løpet av en dag etter mottak av e-posten for godkjenning fra AppSource.

  • hvis du ber om sertifisering for en eksisterende Power BI visuell effekt, vil sertifiserings merket være synlig i løpet av to uker i innsendingen.

Neste trinn