Uw Power BI-visual laten certificeren

Gecertificeerde Power BI-visuals zijn Power BI-visuals in AppSource die voldoen aan de codevereisten van het Microsoft Power BI-team. Deze visuals worden getest om te controleren of ze geen toegang hebben tot externe services of bronnen en of ze de patronen en richtlijnen voor veilige codering volgen.

Gecertificeerde Power BI-visuals bieden meer functies dan niet-gecertificeerde visuals. U kunt ze bijvoorbeeld exporteren naar PowerPoint of de visual weergeven in ontvangen e-mailberichten wanneer een gebruiker zich abonneert op rapportpagina's.

Het certificeringsproces is optioneel. Power BI-visuals die niet zijn gecertificeerd, zijn niet noodzakelijkerwijs onveilig. Sommige Power BI-visuals zijn niet gecertificeerd omdat ze niet aan een of meer van de certificeringsvereisten voldoen. Een Power BI-visual toewijzen die verbinding maakt met een externe service of een Power BI-visual met commerciële bibliotheken kan bijvoorbeeld niet worden gecertificeerd.

Notitie

Microsoft is niet de auteur van Power BI-visuals van derden. Neem contact op met de auteur van de visual als u de functionaliteit van visuals van derden wilt controleren.

Vereisten voor certificering

Als u uw Power BI-visual wilt laten certificeren, moet deze voldoen aan de vereisten die in deze sectie worden vermeld.

Algemene vereisten

Uw Power BI-visual moet worden goedgekeurd door het Partnercentrum. Voordat u certificering aanvraagt, wordt u aangeraden uw Power BI-visual te publiceren in AppSource. Zie Power BI-visuals publiceren in het Partnercentrum voor meer informatie over het publiceren van een Power BI Visual naar AppSource.

Voordat u uw Power BI-visual voor certificering indient, controleert u of:

Vereisten voor de codeopslagplaats

U hoeft uw code niet openbaar te delen in GitHub, maar de codeopslagplaats moet wel beschikbaar zijn voor beoordeling door het Power BI-team. De beste manier om dit te doen, is door de broncode (JavaScript of TypeScript) op te geven in GitHub.

De opslagplaats moet het volgende bevatten:

  • Code voor slechts één Power BI-visual. Deze mag geen code voor meerdere Power BI-visuals of niet-gerelateerde code bevatten.
  • Een vertakking met de naam certification (kleine letters vereist). De broncode in deze vertakking moet overeenkomen met het ingediende pakket. Deze code kan alleen tijdens het volgende indieningsproces worden bijgewerkt als u uw Power BI-visual opnieuw wilt indienen.

Als uw Power BI-visual gebruikmaakt van privé npm-pakketten of git-submodules, moet u ook toegang verlenen tot de opslagplaatsen die deze code bevatten.

Bekijk de GitHub-opslagplaats voor de Voorbeeldstaafdiagram voor Power BI-visual om te begrijpen hoe een opslagplaats voor Power BI-visuals eruitziet.

Bestandsvereisten

Gebruik de nieuwste versie van de API om de Power BI-visual te schrijven.

De opslagplaats moet de volgende bestanden bevatten:

  • .gitignore - Toevoegen node_modulesen .tmp , dist aan dit bestand. De code kan de mappen node_modules, .tmp of dist niet bevatten.
  • capabilities.json : als u een nieuwere versie van een bestaande Power BI-visual verzendt met wijzigingen in de eigenschappen in dit bestand, controleert u of ze geen rapporten voor bestaande gebruikers verbreken.
  • pbiviz.json
  • package.json. Voor de visual moet het volgende pakket zijn geïnstalleerd:
    • tslint: versie 5.18.0 of hoger
    • typescript: versie 3.0.0 of hoger
    • tslint-microsoftcontrib: versie 6.2.0 of hoger
    • Het bestand moet een opdracht bevatten voor het uitvoeren van linter - "lint": "tslint -c tslint.json -p tsconfig.json"
  • package-lock.json
  • tsconfig.json

Opdrachtvereisten

Zorg ervoor dat de volgende opdrachten geen fouten retourneren.

Compileervereisten

Gebruik de nieuwste versie van powerbi-visuals-tools om de Power BI-visual te schrijven.

Compileer uw Power BI-visual met pbiviz package. Als u uw eigen buildscripts gebruikt, geeft u de aangepaste buildopdracht npm run package op.

Broncodevereisten

Zorg ervoor dat u de aanvullende lijst met certificeringsbeleidslijsten voor Power BI-visuals volgt. Als uw inzending niet aan deze richtlijnen voldoet, ontvangt u een e-mail over afwijzing van het Partnercentrum met de beleidsnummers die in deze koppeling worden vermeld.

Volg de onderstaande codevereisten om ervoor te zorgen dat uw code in overeenstemming is met het certificeringsbeleid van Power BI.

Vereist

  • Gebruik alleen openbare OSS-onderdelen, zoals openbare Javascript- of TypeScript-bibliotheken.
  • De code moet de API voor rendering-gebeurtenissen ondersteunen.
  • Zorg ervoor dat DOM veilig wordt gemanipuleerd. Gebruik opschoning voor gebruikersinvoer of gebruikersgegevens voordat deze worden toegevoegd aan DOM.
  • Gebruik het voorbeeldrapport als een testgegevensset.

Niet toegestaan

  • Gebruik van externe services of bronnen. U kunt bijvoorbeeld vanuit Power BI geen HTTP/S- of WebSocket-aanvragen naar services verzenden.
  • Het gebruik van innerHTML of D3.html(user data or user input).
  • JavaScript-fouten of -uitzonderingen in de browserconsole voor invoergegevens.
  • Willekeurige of dynamische code, zoals eval(), onveilig gebruik van settimeout(), requestAnimationFrame(), setinterval(user input function) en gebruikersinvoer of gebruikersgegevens.
  • Geminifiede JavaScript-bestanden of-projecten.

Een Power BI-visual verzenden voor certificering

U kunt nu een aanvraag indienen om uw Power BI-visual te laten certificeren door het Power BI-team.

Tip

Het Power BI-certificeringsproces kan enige tijd duren. Als u een nieuwe Power BI-visual maakt, wordt u aangeraden de Power BI-visual te publiceren via het Partnercentrum voordat u de certificeringsaanvraag indient. Dit zorgt ervoor dat de publicatie van de visual niet wordt vertraagd.

Power BI-certificering aanvragen:

  1. Meld u aan bij Partnercentrum.
  2. Kies uw Power BI-visual op de pagina Overzicht en ga naar de instellingspagina Product.
  3. Schakel het selectievakje Power BI-certificering aanvragen in.
  4. Geef op de pagina Controleren en publiceren in het tekstvak Opmerkingen voor certificering een koppeling naar de broncode en de benodigde referenties voor toegang op.

Inzendingsproces voor privéopslagplaats

Volg de instructies in deze sectie als u een privéopslagplaats, zoals GitHub, gebruikt om uw Power BI Visual te verzenden voor certificering.

  1. Maak een nieuw account voor het validatieteam.
  2. Configureer tweeledige verificatie voor uw account.
  3. Genereer een nieuwe set herstelcodes.
  4. Wanneer u uw Power BI-visual verzendt, moet u de volgende details opgeven:
    • Een koppeling naar de opslagplaats
    • Aanmeldingsreferenties (inclusief een wachtwoord)
    • Herstelcodes
    • Alleen-lezenmachtigingen voor ons account (pbicvsupport)

Badges voor gecertificeerde Power BI-visuals

Zodra een Power BI-visual is gecertificeerd, krijgt deze een aangewezen badge die aangeeft dat het een gecertificeerde Power BI-visual is.

Gecertificeerde Power BI-visuals in AppSource

  • Wanneer iemand online zoekt naar Power BI-visuals in AppSource, geeft een kleine gele badge op de kaart van de visual aan dat het een gecertificeerde Power BI-visual is.

    AppSource certified Power BI visual

  • Wanneer in AppSource op de Power BI-visualkaart wordt geklikt, geeft een gele badge met de titel PBI Certified aan dat deze Power BI-visual is gecertificeerd.

    App page certified Power BI visual

Gecertificeerde Power BI-visuals in de Power BI-interface

  • Wanneer een Power BI-visual vanuit Power BI (Desktop of service) wordt geïmporteerd, geeft een blauwe badge aan dat de Power BI-visual is gecertificeerd.

    Power BI interface certified Power BI visual

  • U kunt alleen gecertificeerde Power BI-visuals weergeven door de filteroptie Power BI-gecertificeerd te selecteren.

Publicatietijdlijn

Het implementeren in AppSource kan enige tijd duren. Uw Power BI-visual kan worden gedownload van AppSource wanneer dit proces is voltooid.

Wanneer kunnen gebruikers mijn visual downloaden?

  • Als u een nieuwe Power BI-visual hebt verzonden, kunnen gebruikers deze een paar uur nadat u een e-mail van AppSource hebt ontvangen, downloaden.

  • Als u een update hebt verzonden naar een bestaande Power BI-visual, kunnen gebruikers deze binnen twee weken na uw inzending downloaden.

    Notitie

    Het veld Versie in AppSource wordt bijgewerkt met de dag waarop uw Power BI is goedgekeurd door AppSource, ongeveer een week nadat u uw visual hebt verzonden. Gebruikers kunnen de bijgewerkte visual downloaden, maar de bijgewerkte functionaliteit zal niet van kracht worden. De nieuwe mogelijkheden van uw visual zijn van invloed op de rapporten van de gebruiker na ongeveer twee weken.

Wanneer zal bij mijn Power BI-visual een certificeringsbadge worden weergegeven?

De certificeringsbadge moet binnen drie weken na uw indiening zichtbaar zijn.

Volgende stappen