Een Power BI-visual laten certificerenGet a Power BI visual certified

Gecertificeerde Power BI-visuals zijn Power BI-visuals in AppSource die voldoen aan de codevereisten van het Microsoft Power BI-team.Certified Power BI visuals are Power BI visuals in AppSource that meet the Microsoft Power BI team code requirements. 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.These visuals are tested to verify that they don't access external services or resources, and that they follow secure coding patterns and guidelines.

Zodra een Power BI-visual gecertificeerd is, zijn er meer functies beschikbaar.Once a Power BI visual is certified, it offers more features. Zo kunt u de visual exporteren naar PowerPoint en de visual weergeven in e-mails die worden ontvangen wanneer een gebruiker zich op rapportpagina's abonneert.For example, you can export to PowerPoint, or display the visual in received emails, when a user subscribes to report pages.

Het certificeringsproces is optioneel.The certification process is optional. Power BI-visuals die niet zijn gecertificeerd, zijn niet noodzakelijk onveilige Power BI-visuals.Power BI visuals that are not certified, are not necessarily unsafe Power BI visuals. Sommige Power BI-visuals zijn niet gecertificeerd omdat ze niet aan een of meer van de certificeringsvereisten voldoen.Some Power BI visuals aren't certified because they don't comply with one or more of the certification requirements. Bijvoorbeeld een Power BI-visual voor een kaart die verbinding maakt met een externe service of een Power BI-visual die gebruikmaakt van commerciële bibliotheken.For example, a map Power BI visual connecting to an external service, or a Power BI visual using commercial libraries.

Notitie

Microsoft is niet de auteur van Power BI-visuals van derden.Microsoft is not the author of third-party Power BI visuals. Neem contact op met de auteur van de visual als u de functionaliteit van visuals van derden wilt controleren.To verify the functionality of third-party visuals, contact the author of the visual directly.

Vereisten voor certificeringCertification requirements

Als uw Power BI-visual moet worden gecertificeerd, moet uw Power BI-visual voldoen aan de vereisten die in deze sectie worden vermeld.To get your Power BI visual certified, your Power BI visual must comply with the requirements listed in this section.

Algemene vereistenGeneral requirements

Uw Power BI-visual moet worden goedgekeurd door het Partnercentrum.Your Power BI visual has to be approved by Partner Center. Het is raadzaam dat uw Power BI-visual zich al in AppSource bevindt.We recommend that your Power BI visual is already in AppSource. Zie Power BI-visuals publiceren in het Partnercentrum voor meer informatie over het publiceren van een Power BI Visual naar AppSource.To learn how to publish a Power BI visual to AppSource, see Publish Power BI visuals to Partner Center.

Voordat u uw Power BI-visual indient voor certificering, controleert u of deze voldoet aan de richtlijnen voor Power BI-visuals.Before submitting your Power BI visual to be certified, verify that it complies with the guidelines for Power BI visuals.

Zorg ervoor dat het gecompileerde pakket precies overeenkomt met het ingediende pakket wanneer u de Power BI-visual indient.When submitting the Power BI visual, make sure that the compiled package exactly matches the submitted package.

Vereisten voor de codeopslagplaatsCode repository requirements

U hoeft uw code niet openbaar te delen in GitHub, maar de codeopslagplaats moet wel beschikbaar zijn voor beoordeling door het Power BI-team.Although you don't have to publicly share your code in GitHub, the code repository has to be available for a review by the Power BI team. De beste manier om dit te doen, is door de broncode (JavaScript of TypeScript) in GitHub op te geven.The best way to do this, is by providing the source code (JavaScript or TypeScript) in GitHub.

De opslagplaats moet het volgende bevatten:The repository must contain the following:

  • Code voor slechts één Power BI-visual.Code for only one Power BI visual. Deze mag geen code voor meerdere Power BI-visuals of niet-gerelateerde code bevatten.It can't contain code for multiple Power BI visuals, or unrelated code.
  • Een vertakking met de naam certification (kleine letters vereist).A branch named certification (lowercase required). De broncode in deze vertakking moet overeenkomen met het ingediende pakket.The source code in this branch has to match the submitted package. Deze code kan alleen tijdens het volgende indieningsproces worden bijgewerkt als u uw Power BI-visual opnieuw wilt indienen.This code can only be updated during the next submission process, if you're resubmitting your Power BI visual.

Als uw Power BI-visual persoonlijke NPM-pakketten of git-submodules gebruikt, moet u toegang bieden tot de extra opslagplaatsen die deze code bevatten.If your Power BI visual uses private npm packages, or git submodules, you must provide access to the additional repositories containing this code.

Bekijk de GitHub-opslagplaats voor de Voorbeeldstaafdiagram voor Power BI-visual om te begrijpen hoe een opslagplaats voor Power BI-visuals eruitziet.To understand how a Power BI visual repository looks, review the GitHub repository for the Power BI visuals sample bar chart.

BestandsvereistenFile requirements

Gebruik de nieuwste versie van de API om de Power BI-visual te schrijven.Use the latest version of the API to write the Power BI visual.

De opslagplaats moet de volgende bestanden bevatten:The repository must include the following files:

  • .gitignore: voeg node_modules, .tmp en dist toe aan dit bestand..gitignore - Add node_modules, .tmp and dist to this file. De code mag niet de mappen node_modules, .tmp of dist bevatten.The code cannot include the node_modules, .tmp or dist folders.
  • capabilities.json: als u een nieuwere versie van uw Power BI-visual indient met wijzigingen in de eigenschappen in dit bestand, controleert u of hierdoor rapporten voor bestaande gebruikers niet onbruikbaar worden.capabilities.json - If you are submitting newer version of your Power BI visual with changes to the properties in this file, verify that they do not break reports for existing users.
  • pbiviz.jsonpbiviz.json
  • package.json.package.json. Voor de visual moet het volgende pakket zijn geïnstalleerd:The visual must have the following package installed:
    • tslint: versie 5.18.0 of hoger"tslint" - Version 5.18.0 or higher
    • typescript: versie 3.0.0 of hoger"typescript" - Version 3.0.0 or higher
    • tslint-microsoftcontrib: versie 6.2.0 of hoger"tslint-microsoftcontrib" - Version 6.2.0 or higher
    • Het bestand moet een opdracht bevatten voor het uitvoeren van linter - "lint": "tslint -c tslint.json -p tsconfig.json"The file must contain a command for running linter - "lint": "tslint -c tslint.json -p tsconfig.json"
  • package-lock.jsonpackage-lock.json
  • tsconfig.jsontsconfig.json

OpdrachtvereistenCommand requirements

Zorg ervoor dat de volgende opdrachten geen fouten retourneren.Make sure that the following commands don't return any errors.

CompileervereistenCompiling requirements

Gebruik de nieuwste versie van powerbi-visuals-tools om de Power BI-visual te schrijven.Use the latest version of powerbi-visuals-tools to write the Power BI visual.

U moet uw Power BI-visual compileren met pbiviz package.You must compile your Power BI visual with pbiviz package. Als u uw eigen buildscripts gebruikt, geeft u de aangepaste buildopdracht npm run package op.If you're using your own build scripts, provide a npm run package custom build command.

BroncodevereistenSource code requirements

Controleer of u de lijst met extra certificeringsbeleid voor Power BI-visuals hebt gevolgd.Verify that you follow the Power BI visuals additional certification policy list. Als uw indiening niet aan deze richtlijnen voldoet, bevat het e-mailbericht van het Partnercentrum de beleidsnummers die in deze koppeling worden weer gegeven.If your submission doesn't follow these guidelines, the rejection email from Partner Center will include the policy numbers listed in this link.

Volg de onderstaande codevereisten om ervoor te zorgen dat uw code in overeenstemming is met het certificeringsbeleid van Power BI.Follow the code requirements listed below to make sure that your code is in line with the Power BI certification policies.

VereistRequired

  • Gebruik alleen openbare OSS-onderdelen, zoals openbare Javascript- of TypeScript-bibliotheken.Only use public reviewable OSS components such as public JavaScript or TypeScript libraries.
  • De code moet de API voor rendering-gebeurtenissen ondersteunen.The code must support the Rendering Events API.
  • Zorg ervoor dat DOM veilig wordt gemanipuleerd.Ensure DOM is manipulated safely. Gebruik opschoning voor gebruikersinvoer of gebruikersgegevens voordat deze worden toegevoegd aan DOM.Use sanitization for user input or user data, before adding it to DOM.
  • Gebruik het voorbeeldrapport als een testgegevensset.Use the sample report as a test dataset.

Niet toegestaanNot allowed

  • Gebruik van externe services of bronnen.Accessing external services or resources. U kunt bijvoorbeeld vanuit Power BI geen HTTP/S- of WebSocket-aanvragen naar services verzenden.For example, no HTTP/S or WebSocket requests can go out of Power BI to any services.
  • Het gebruik van innerHTML of D3.html(user data or user input).Using innerHTML, or D3.html(user data or user input).
  • JavaScript-fouten of -uitzonderingen in de browserconsole voor invoergegevens.JavaScript errors or exceptions in the browser console, for any input data.
  • Willekeurige of dynamische code, zoals eval(), onveilig gebruik van settimeout(), requestAnimationFrame(), setinterval(user input function) en gebruikersinvoer of gebruikersgegevens.Arbitrary or dynamic code such as eval(), unsafe use of settimeout(), requestAnimationFrame(), setinterval(user input function), and user input or user data.
  • Geminifiede JavaScript-bestanden of-projecten.Minified JavaScript files or projects.

Een Power BI-visual indienen voor certificeringSubmitting a Power BI visual for certification

Via het Partnercentrum kunt u een aanvraag indienen om uw Power BI-visual door het Power BI-team te laten certificeren.You can request to have your Power BI visual certified by the Power BI team via Partner Center.

Tip

Het Power BI-certificeringsproces kan enige tijd duren.The Power BI certification process might take time. 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.If you're creating a new Power BI visual, we recommend that you publish your Power BI visual via the Partner Center before you request Power BI certification. Dit zorgt ervoor dat de publicatie van de visual niet wordt vertraagd.This ensures that the publishing of your visual is not delayed.

Power BI-certificering aanvragen:To request Power BI certification:

  1. Meld u aan bij Partnercentrum.Sign in to Partner Center.
  2. Kies uw Power BI-visual op de pagina Overzicht en ga naar de instellingspagina Product.On the Overview page, choose your Power BI visual, and go to the Product setup page.
  3. Schakel het selectievakje Power BI-certificering aanvragen in.Select the Request Power BI certification check box.
  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.On the Review and publish page, in the Notes for certification text box, provide a link to the source code and the credentials required to access it.

Inzendingsproces voor privéopslagplaatsPrivate repository submission process

Volg de instructies in deze sectie als u een privéopslagplaats, zoals GitHub, gebruikt om uw Power BI Visual te verzenden voor certificering.If you're using a private repository such as GitHub to submit your Power BI visual for certification, follow the instructions in this section.

  1. Maak een nieuw account voor het validatieteam.Create a new account for the validation team.
  2. Configureer tweeledige verificatie voor uw account.Configure two-factor authentication for your account.
  3. Genereer een nieuwe set herstelcodes.Generate a new set of recovery codes.
  4. Als u uw Power BI-visual wilt verzenden, moet u het volgende opgeven:When submitting your Power BI visual, provide the following:
    • Een koppeling naar de opslagplaatsA link to the repository
    • Aanmeldingsreferenties (inclusief een wachtwoord)Login credentials (including a password)
    • HerstelcodesRecovery codes
    • Alleen-lezenmachtigingen voor ons account (pbicvsupport)Read-only permissions to our account (pbicvsupport)

Badges voor gecertificeerde Power BI-visualsCertified Power BI visual badges

Zodra een Power BI-visual is gecertificeerd, krijgt deze een speciale badge om aan te geven dat de visual is gecertificeerd.Once a Power BI visual is certified, it gets a designated badge that indicates that it's certified.

Gecertificeerde Power BI-visuals in AppSourceCertified Power BI visuals in AppSource

  • Wanneer u online naar Power BI-visuals in AppSource zoekt, geeft een kleine gele badge op de kaart van de visual aan dat het een gecertificeerde Power BI-visual is.When searching online for Power BI visuals in AppSource, a small yellow badge on the visual's card indicates that it's a certified Power BI visual.

    Gecertificeerde Power BI-visual in AppSource

  • Nadat u in AppSource op de kaart van de Power BI-visual hebt geklikt, geeft een gele badge met de titel PBI Certified aan dat deze Power BI-visual is gecertificeerd.After clicking the Power BI visual card in AppSource, a yellow badge titled PBI Certified indicates that this Power BI visual is certified.

    Gecertificeerde Power BI-visual op app-pagina

Gecertificeerde Power BI-visuals in de Power BI-interfaceCertified Power BI visuals in the Power BI interface

  • Bij het importeren van een Power BI-visual vanuit Power BI (bureaublad of service), geeft een blauwe badge aan dat de Power BI-visual is gecertificeerd.When importing a Power BI visual from within Power BI (Desktop or service), a blue badge indicates that the Power BI visual is certified.

    Gecertificeerde Power BI-visual in Power BI

  • U kunt alleen gecertificeerde Power BI-visuals weergeven door de filteroptie Power BI-gecertificeerd te selecteren.You can display only certified Power BI visuals, by selecting the Power BI Certified filter option.

PublicatietijdlijnPublication timeline

Implementeren in AppSource is een proces dat enige tijd kan duren.Deploying to AppSource is a process that may take some time. Uw Power BI-visual kan worden gedownload van AppSource wanneer dit proces is voltooid.Your Power BI visual will be available to download from AppSource when this process is complete.

Wanneer kunnen gebruikers mijn visual downloaden?When will users be able to download my visual?

  • Als u een Power BI-visual voor de eerste keer hebt verzonden, kunnen gebruikers deze een paar uur na ontvangst van een e-mail van AppSource downloaden.If you submitted a Power BI visual for the first time, users will be able to download it a few hours after you receive an email from AppSource.

  • Als u een update hebt verzonden voor een bestaande Power BI-visual, kunnen gebruikers deze binnen een maand na uw verzending downloaden.If you submitted an update to an existing Power BI visual, users will be able to download it within a month of your submission.

    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.The version field in AppSource will be updated with the day your Power BI was approved by AppSource, approximately a week after you submitted your visual. Gebruikers kunnen de bijgewerkte visual downloaden, maar de bijgewerkte functionaliteit zal niet van kracht worden.Users will be able to download the updated visual but the updated capabilities will not take effect. De nieuwe functionaliteit van uw visual is na ongeveer een maand van invloed op de rapporten van de gebruiker.Your visual's new capabilities will affect the user's reports after about a month.

Wanneer zal bij mijn Power BI-visual een certificeringsbadge worden weergegeven?When will my Power BI visual display a certification badge?

  • Als u een Power BI-visual voor de eerste keer hebt ingediend, wordt de certificeringsbadge weergegeven op de dag waarop de goedkeurings-e-mail van AppSource is ontvangen.If you submitted a Power BI visual for the first time, the certification badge will appear within a day of receiving the approval email from AppSource.

  • Als u een certificering aanvraagt voor een bestaande Power BI-visual, wordt de certificeringsbadge binnen een maand na uw verzending weergegeven.If you're requesting certification for an existing Power BI visual, the certification badge will be visible within a month of your submission.

Volgende stappenNext steps