So lassen Sie sich ein Power BI-Visual zertifizierenGet a Power BI visual certified

Zertifizierte Power BI-Visuals sind Power BI-Visuals in AppSource, die den Codeanforderungen des Microsoft Power BI-Teams entsprechen.Certified Power BI visuals are Power BI visuals in AppSource that meet the Microsoft Power BI team code requirements. Diese Visuals wurden getestet, um sicherzustellen, dass sie nicht auf externe Dienste oder Ressourcen zugreifen und dass sie sicheren Codierungsmustern und -richtlinien folgen.These visuals are tested to verify that they don't access external services or resources, and that they follow secure coding patterns and guidelines.

Wenn ein Power BI-Visual zertifiziert wurde, bietet es mehr Features.Once a Power BI visual is certified, it offers more features. Beispielsweise können Sie ein Visual nach PowerPoint exportieren oder in empfangenen E-Mails anzeigen, wenn ein Benutzer Berichtsseiten abonniert.For example, you can export to PowerPoint, or display the visual in received emails, when a user subscribes to report pages.

Der Zertifizierungsprozess ist optional.The certification process is optional. Power BI-Visuals ohne Zertifizierung sind nicht notwendigerweise unsicher.Power BI visuals that are not certified, are not necessarily unsafe Power BI visuals. Einige Power BI-Visuals sind nicht zertifiziert, weil sie mindestens eine Zertifizierungsanforderung nicht erfüllen.Some Power BI visuals aren't certified because they don't comply with one or more of the certification requirements. Beispiele: Ein Power BI-Kartenvisual, das eine Verbindung mit einem externen Dienst herstellt, oder ein Power BI-Visual, das kommerzielle Bibliotheken verwendet.For example, a map Power BI visual connecting to an external service, or a Power BI visual using commercial libraries.

Hinweis

Microsoft ist nicht der Autor von Power BI-Visuals von Drittanbietern.Microsoft is not the author of third-party Power BI visuals. Um die Funktionalität eines Drittanbietervisuals zu verifizieren, wenden Sie sich direkt an den Autor.To verify the functionality of third-party visuals, contact the author of the visual directly.

ZertifizierungsanforderungenCertification requirements

Damit Ihr Power BI-Visual zertifiziert werden kann, muss es die in diesem Abschnitt aufgeführten Anforderungen erfüllen.To get your Power BI visual certified, your Power BI visual must comply with the requirements listed in this section.

Allgemeine AnforderungenGeneral requirements

Ihr Power BI-Visual muss von Partner Center genehmigt werden.Your Power BI visual has to be approved by Partner Center. Es empfiehlt sich, das Power BI-Visual bereits vorher in AppSource bereitzustellen.We recommend that your Power BI visual is already in AppSource. Informationen zum Veröffentlichen eines Power BI-Visuals in AppSource finden Sie unter Veröffentlichen von Power BI-Visuals in Partner Center.To learn how to publish a Power BI visual to AppSource, see Publish Power BI visuals to Partner Center.

Bevor Sie Ihre Power BI-Visual zur Zertifizierung einreichen, überprüfen Sie, ob es den Richtlinien für Power BI-Visuals entspricht.Before submitting your Power BI visual to be certified, verify that it complies with the guidelines for Power BI visuals.

Stellen Sie beim Einreichen des Power BI-Visuals sicher, dass das kompilierte Paket exakt mit dem eingereichten Paket übereinstimmt.When submitting the Power BI visual, make sure that the compiled package exactly matches the submitted package.

Anforderungen in Bezug auf das CoderepositoryCode repository requirements

Sie müssen Ihren Code zwar nicht öffentlich auf GitHub freigeben, aber das Coderepository muss dem Power BI-Team zur Überprüfung zur Verfügung stehen.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. Die beste Möglichkeit hierfür besteht darin, den Quellcode (JavaScript oder TypeScript) auf GitHub bereitzustellen.The best way to do this, is by providing the source code (JavaScript or TypeScript) in GitHub.

Das Repository muss Folgendes enthalten:The repository must contain the following:

  • Code für eine einzelne Power BI-Visualisierung.Code for only one Power BI visual. Es darf weder Code für mehrere Power BI-Visuals noch Code enthalten, der in keinem Zusammenhang mit dem Visual steht.It can't contain code for multiple Power BI visuals, or unrelated code.
  • Einen Branch namens certification („Zertifizierung“, Kleinschreibung erforderlich).A branch named certification (lowercase required). Der Quellcode in diesem Branch muss mit dem eingereichten Paket übereinstimmen.The source code in this branch has to match the submitted package. Dieser Code kann erst während des nächsten Einreichungsprozesses aktualisiert werden, wenn Sie das Power BI-Visual erneut einreichen.This code can only be updated during the next submission process, if you're resubmitting your Power BI visual.

Wenn Ihr Power BI-Visual private npm-Pakete oder git-Untermodule verwendet, müssen Sie Zugriff auf die zusätzlichen Repositorys bereitstellen, die diesen Code enthalten.If your Power BI visual uses private npm packages, or git submodules, you must provide access to the additional repositories containing this code.

Der Aufbau eines visuellen Power BI-Repositorys ist im GitHub-Repository im Beispielbalkendiagramm für Power BI-Visualisierungen gezeigt.To understand how a Power BI visual repository looks, review the GitHub repository for the Power BI visuals sample bar chart.

Anforderungen in Bezug auf DateienFile requirements

Verwenden Sie die neueste Version der API, um Ihr Power BI-Visual zu schreiben.Use the latest version of the API to write the Power BI visual.

Das Repository muss die folgenden Dateien enthalten:The repository must include the following files:

  • .gitignore: Fügen Sie dieser Datei node_modules, .tmp und dist hinzu..gitignore - Add node_modules, .tmp and dist to this file. Der Code darf die Ordner node_modules, .tmp oder dist nicht enthalten.The code cannot include the node_modules, .tmp or dist folders.
  • capabilities.json: Wenn Sie eine neuere Version Ihres Power BI-Visuals mit Änderungen an den Eigenschaften in dieser Datei einreichen, stellen Sie sicher, dass diese nicht zu Fehlern bei Berichten für vorhandene Benutzer führen.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. Für das Visual müssen die folgenden Pakete installiert sein:The visual must have the following package installed:
    • tslint-Version 5.18.0 oder höher"tslint" - Version 5.18.0 or higher
    • typescript-Version 3.0.0 oder höher"typescript" - Version 3.0.0 or higher
    • tslint-microsoftcontrib-Version 6.2.0 oder höher"tslint-microsoftcontrib" - Version 6.2.0 or higher
    • Die Datei muss einen Befehl zum Ausführen von Linter enthalten: "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

Anforderungen in Bezug auf BefehleCommand requirements

Stellen Sie sicher, dass die folgenden Befehle keine Fehler zurückgeben.Make sure that the following commands don't return any errors.

Anforderungen in Bezug auf die KompilierungCompiling requirements

Verwenden Sie die neueste Version von powerbi-visuals-tools, um Ihr Power BI-Visual zu schreiben.Use the latest version of powerbi-visuals-tools to write the Power BI visual.

Sie müssen das Power BI-Visual mit pbiviz package kompilieren.You must compile your Power BI visual with pbiviz package. Wenn Sie eigene Buildskripts verwenden, geben Sie einen benutzerdefinierten npm run package-Buildbefehl an.If you're using your own build scripts, provide a npm run package custom build command.

Anforderungen in Bezug auf den QuellcodeSource code requirements

Stellen Sie sicher, dass alle Richtlinien in der Liste der zusätzlichen Zertifizierungsanforderungen für Power BI-Visuals eingehalten werden.Verify that you follow the Power BI visuals additional certification policy list. Wenn Ihre Einreichung nicht mit diesen Richtlinien übereinstimmt, werden Ihnen in der Ablehnungs-E-Mail von Partner Center die unter diesem Link aufgeführten Richtliniennummern mitgeteilt.If your submission doesn't follow these guidelines, the rejection email from Partner Center will include the policy numbers listed in this link.

Berücksichtigen Sie die im Folgenden aufgeführten Codeanforderungen, um sicherzustellen, dass Ihr Code den Power BI-Zertifizierungsrichtlinien entspricht.Follow the code requirements listed below to make sure that your code is in line with the Power BI certification policies.

ErforderlichRequired

  • Verwenden Sie nur öffentlich überprüfbare OSS-Komponenten wie öffentliche JavaScript- oder TypeScript-Bibliotheken.Only use public reviewable OSS components such as public JavaScript or TypeScript libraries.
  • Der Code muss die API zum Rendern von Ereignissen unterstützen.The code must support the Rendering Events API.
  • Stellen Sie sicher, dass DOM auf sichere Weise geändert wird.Ensure DOM is manipulated safely. Bereinigen Sie Benutzereingaben oder Benutzerdaten, bevor Sie den Code zu DOM hinzufügen.Use sanitization for user input or user data, before adding it to DOM.
  • Verwenden Sie den Beispielbericht als Testdataset.Use the sample report as a test dataset.

Nicht zulässigNot allowed

  • Zugriff auf externe Dienste oder Ressourcen.Accessing external services or resources. Beispielsweise dürfen aus Power BI keine HTTP/S- oder WebSocket-Anforderungen an Dienste gesendet werden.For example, no HTTP/S or WebSocket requests can go out of Power BI to any services.
  • Verwenden von innerHTML oder D3.html(user data or user input).Using innerHTML, or D3.html(user data or user input).
  • JavaScript-Fehler oder -Ausnahmen in der Browserkonsole für Eingabedaten.JavaScript errors or exceptions in the browser console, for any input data.
  • Zufälliger oder dynamischer Code wie eval(), unsichere Verwendung von settimeout(), requestAnimationFrame(), setinterval(user input function) sowie Benutzereingaben oder Benutzerdaten.Arbitrary or dynamic code such as eval(), unsafe use of settimeout(), requestAnimationFrame(), setinterval(user input function), and user input or user data.
  • Minimierte JavaScript-Dateien oder -Projekte.Minified JavaScript files or projects.

Übermitteln eines Power BI-Visual zur ZertifizierungSubmitting a Power BI visual for certification

Sie können über Partner Center eine Zertifizierung Ihres Power BI-Visuals durch das Power BI-Team anfordern.You can request to have your Power BI visual certified by the Power BI team via Partner Center.

Tipp

Der Zertifizierungsprozess für ein Power BI-Visual kann einige Zeit in Anspruch nehmen.The Power BI certification process might take time. Wenn Sie ein neues Power BI-Visual erstellen, empfiehlt es sich, dieses über Partner Center zu veröffentlichen, bevor Sie eine Power BI-Zertifizierung anfordern.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. Damit wird sichergestellt, dass sich die Veröffentlichung Ihres Visuals nicht verzögert.This ensures that the publishing of your visual is not delayed.

So fordern Sie eine Power BI-Zertifizierung an:To request Power BI certification:

  1. Melden Sie sich bei Partner Center an.Sign in to Partner Center.
  2. Wählen Sie auf der Übersichtsseite Ihre Power BI-Visual aus, und wechseln Sie zur Seite Produkteinrichtung.On the Overview page, choose your Power BI visual, and go to the Product setup page.
  3. Aktivieren Sie das Kontrollkästchen Power BI-Zertifizierung anfordern.Select the Request Power BI certification check box.
  4. Geben Sie auf der Seite Überprüfen und veröffentlichen im Textfeld Hinweise für Zertifizierung einen Link zum Quellcode sowie die Anmeldeinformationen für den Zugriff darauf an.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.

Einreichungsprozess bei privaten RepositorysPrivate repository submission process

Befolgen Sie die Anweisungen in diesem Abschnitt, wenn Sie ein privates Repository wie GitHub verwenden, um Ihre Power BI-Visualisierung zur Zertifizierung einzureichen.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. Erstellen Sie ein neues Konto für das Überprüfungsteam.Create a new account for the validation team.
  2. Konfigurieren Sie für Ihr Konto die zweistufige Authentifizierung.Configure two-factor authentication for your account.
  3. Generieren Sie einen neuen Satz an Wiederherstellungscodes.Generate a new set of recovery codes.
  4. Geben Sie folgende Informationen an, wenn Sie Ihre Power BI-Visualisierung einreichen:When submitting your Power BI visual, provide the following:
    • Einen Link zum RepositoryA link to the repository
    • Anmeldeinformationen (einschließlich Kennwort)Login credentials (including a password)
    • WiederherstellungscodesRecovery codes
    • Leseberechtigungen für unser Konto (pbicvsupport)Read-only permissions to our account (pbicvsupport)

Badges für zertifizierte Power BI-VisualsCertified Power BI visual badges

Sobald ein Power BI-Visual zertifiziert ist, erhält es einen entsprechenden Badge.Once a Power BI visual is certified, it gets a designated badge that indicates that it's certified.

Zertifizierte Power BI-Visuals in AppSourceCertified Power BI visuals in AppSource

  • Bei der Onlinesuche nach Power BI-Visuals in AppSource zeigt ein kleiner gelber Badge auf der Karte des Visuals an, dass es sich um ein zertifiziertes Power BI-Visual handelt.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.

    AppSource-zertifizierte Power BI-Visuals

  • Nach dem Klicken auf die Karte des Power BI-Visuals in AppSource zeigt ein gelber Badge mit der Bezeichnung PBI Certified an, dass dieses Power BI-Visual zertifiziert ist.After clicking the Power BI visual card in AppSource, a yellow badge titled PBI Certified indicates that this Power BI visual is certified.

    App-Seite mit zertifiziertem Power BI-Visual

Zertifizierte Power BI-Visuals auf der Power BI-OberflächeCertified Power BI visuals in the Power BI interface

  • Beim Importieren eines Power BI-Visuals aus Power BI (Desktop oder Dienst) zeigt ein blaues Badge an, dass das Power BI-Visual zertifiziert ist.When importing a Power BI visual from within Power BI (Desktop or service), a blue badge indicates that the Power BI visual is certified.

    Power BI-Oberfläche mit zertifiziertem Power BI-Visual

  • Sie können ausschließlich zertifizierte Power BI-Visuals anzeigen, indem Sie die Filteroption Power BI-zertifiziert auswählen.You can display only certified Power BI visuals, by selecting the Power BI Certified filter option.

VeröffentlichungszeitachsePublication timeline

Das Bereitstellen in AppSource ist ein Prozess, der einige Zeit in Anspruch nehmen kann.Deploying to AppSource is a process that may take some time. Wenn dieser Prozess abgeschlossen ist, sind Ihre visuellen Power BI-Elemente zum Herunterladen aus AppSource verfügbar.Your Power BI visual will be available to download from AppSource when this process is complete.

Wann können Benutzer mein visuelles Element herunterladen?When will users be able to download my visual?

  • Wenn Sie ein visuelles Power BI-Element erstmals übermittelt haben, können Benutzer das Element einige Stunden herunterladen, nachdem Sie eine E-Mail von AppSource empfangen haben.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.

  • Wenn Sie ein Update für ein vorhandenes visuelles Power BI-Element übermittelt haben, können Benutzer dieses Update innerhalb eines Monats nach Ihrer Übermittlung herunterladen.If you submitted an update to an existing Power BI visual, users will be able to download it within a month of your submission.

    Hinweis

    Das Feld Version in AppSource wird mit dem Tag aktualisiert, an dem Ihr visuelles Power BI-Element von AppSource genehmigt wurde, ungefähr eine Woche, nachdem Sie Ihr visuelles Element übermittelt haben.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. Benutzer können das aktualisierte visuelle Element herunterladen, aber die aktualisierten Funktionen werden nicht wirksam.Users will be able to download the updated visual but the updated capabilities will not take effect. Die neuen Funktionen Ihres visuellen Elements werden nach ungefähr einem Monat in den Berichten der Benutzer wirksam.Your visual's new capabilities will affect the user's reports after about a month.

Wann wird von meinem visuellen Power BI-Element ein Zertifizierungsbadge angezeigt?When will my Power BI visual display a certification badge?

  • Wenn Sie ein visuelles Power BI-Element erstmals übermittelt haben, wird der Zertifizierungsbadge innerhalb eines Tages nach Erhalt der Genehmigungs-E-Mail von AppSource angezeigt.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.

  • Wenn Sie eine Zertifizierung für ein vorhandenes visuelles Power BI-Element anfordern, wird der Zertifizierungsbadge innerhalb eines Monats ihrer Übermittlung angezeigt.If you're requesting certification for an existing Power BI visual, the certification badge will be visible within a month of your submission.

Nächste SchritteNext steps