Veröffentlichen von benutzerdefinierten Visuals in AppSourcePublish custom visuals to AppSource

Erfahren Sie, wie Sie ein benutzerdefiniertes Visual in AppSource veröffentlichen, damit es von anderen gefunden und verwendet werden kann.Learn how you can publish your custom visual to AppSource for others to discover and use. Officeoffice

Nachdem Sie ein benutzerdefiniertes Visual erstellt haben, empfiehlt es sich, es in AppSource zu veröffentlichen, damit es von anderen Personen gefunden und verwendet werden kann.Once you have created your custom visual, you may want to publish it AppSource for others to discover and use. Zuvor sind jedoch einige vorbereitende Schritte erforderlich.There is some preperation that needs to be done before you can do that. Weitere Informationen zum Erstellen einer benutzerdefinierten Visualisierung finden Sie unter Erstellen benutzerdefinierter Visualisierungen mithilfe von Entwicklertools.For more information on how to create a custom visual, see Use developer tools to create custom visuals.

Was ist AppSource?What is AppSource? Einfach ausgedrückt ist dies der Ort, an dem Sie SaaS-Apps und Add-Ins für Ihre Microsoft-Produkte und -Services finden.Simply put, it is the place to find SaaS apps and add-ins for your Microsoft products and service. In AppSource finden Millionen von Benutzern von Office 365, Dynamics 365, Cortana Intelligence und anderen Produkten Lösungen, mit denen sie die Effizienz ihrer Arbeit steigern, größere Einblicke gewinnen oder die Darstellung der Ergebnisse verbessern können.AppSource connects millions of users of Office 365, Dynamics 365, Cortana Intelligence, and others, to solutions that help them get work done more efficiently, more insightfully or more beautifully than before.

Vorbereiten der Übermittlung Ihrer benutzerdefinierten VisualisierungPreparing to submit your custom visual

Nachdem Sie die benutzerdefinierte Visualisierung codiert, getestet und als PBIVIZ-Datei gepackt haben, sollten Sie zudem die folgenden Elemente für die Übermittlung vorbereitet haben.One you're done coding and testing your custom visual and have packaged it into a pbiviz file, you should also have the following ready for your submission.

ItemItem ErforderlichRequired BeschreibungDescription
PBIVIZ-Paket mit allen erforderlichen MetadatenPbiviz package contains all the required metadata JaYes Name der VisualisierungVisual name
AnzeigenameDisplay name
GUIDGUID
VersionVersion
BeschreibungDescription
Name und E-Mail-Adresse des AutorsAuthor name and email
PBIX-BeispielberichtsdateiSample .pbix report file JaYes Um Ihre Visualisierung zu präsentieren, sollten Sie Benutzer mit der Visualisierung vertraut machen.To showcase your visual, you should help users to get acquainted with the visual. Sie sollten den Nutzen der Visualisierung für den Benutzer unterstreichen und Beispiele für die Verwendung, die Formatierungsoptionen und weitere Funktionen bieten. Sie können auch am Ende eine Seite für Hinweise hinzufügen, die Tipps und Tricks, häufige Fehler und ähnliche Hinweise enthält.You should emphasize on the value the visual brings to the user and give examples of usage, formatting options, etc. You can also add a "hints" page at the end with some tips and tricks, things to avoid and the like.
SymbolIcon JaYes Sie sollten das Logo der benutzerdefinierten Visualisierung einschließen, das in der digitalen Ladenzeile angezeigt wird.You should include the custom visual logo that will appear in the store front. Dabei kann es sich um eine PNG-, JPG-, JPEG- oder GIF-Datei handeln.The format can be .png, .jpg, .jpeg or .gif. Die Bildgröße muss genau 300 px (Breite) x 300 px (Höhe) betragen.It must be exactly 300px (width) x 300px (height). Die Dateigröße darf 512 KB nicht überschreiten.It can be no larger than 512kb for the file size.
ScreenshotsScreenshots JaYes Sie müssen mindestens einen Screenshot bereitstellen.You must provide at least one screenshot. Dabei kann es sich um eine PNG-, JPG-, JPEG- oder GIF-Datei handeln.The format can be .png, .jpg, .jpeg or .gif. Die Größe muss exakt 1366 px (Breite) x 768 px (Höhe) betragen.It must be exactly 1366px (width) x 768px (height). Die Dateigröße darf 1024 KB nicht überschreiten.It can be no larger than 1024kb for the file size. Um den Nutzen der Screenshots zu erhöhen, fügen Sie Textblasen hinzu, die den Wertbeitrag wichtiger Features, die in den einzelnen Screenshots gezeigt werden, erläutern.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
Support-DownloadlinkSupport download link JaYes Geben Sie eine URL an, um Kunden zu unterstützen, bei denen Probleme mit Ihrer Visualisierung auftreten.Provide the URL to support customers who have issues with your visual. Die URL sollte „https://“ oder „http://“ enthalten.The format of your URL should include https:// or http://.
Link zum DatenschutzdokumentPrivacy document link JaYes Geben Sie einen Link zur Datenschutzrichtlinie für Kunden an, die Ihre Visualisierung verwenden.Provide a link to the privacy policy for customers who use your visual. Der Link sollte „https://“ oder „http://“ enthalten.The format of your link should include https:// or http://.
LizenzbedingungenEnd user license agreement (EULA) JaYes Sie müssen eine Datei mit den Lizenzbedingungen hochladen.You must upload a EULA file. Dabei kann es sich um eigene Lizenzbedingungen oder die Standardlizenzbedingungen im Office Store für benutzerdefinierte Power BI-Visualisierungen handeln.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Wenn Sie die Standardlizenzbedingungen verwenden möchten, fügen Sie im Verkäuferdashboard im Dialogfeld zum Hochladen der Datei mit den Lizenzbedingungen die folgende URL ein:https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.
VideolinkVideo link NeinNo Um das Interesse der Benutzer an Ihrer benutzerdefinierten Visualisierung zu steigern, sollten sie einen Link zu einem Video über Ihre Visualisierung bereitstellen.To increase the interest of users for your custom visual, it is advised to provide a link to a video about your visual. Die URL sollte „https://“ oder „http://“ enthalten.The format of your URL should include https:// or http://.
GitHub-RepositoryGitHub repository NeinNo Es wird empfohlen, einen gültigen öffentlichen Link zu einem GitHub-Repository bereitzustellen, das Quellen Ihrer Visualisierung und Beispieldaten enthält, damit andere Entwickler Feedback geben und Verbesserungen des Codes vorschlagen können.It is preferred to have a valid and public link to a GitHub repository with sources of your visual and sample data in it to allow other developers to provide feedback and propose improvements to your code.

Übermitteln an Power BISubmitting to Power BI

Vor Beginn der Übermittlung müssen Sie eine E-Mail an das Power BI-Team für benutzerdefinierte Visualisierungen senden.Submission starts with sending an email to the Power BI custom visuals submission team. Sie können die E-Mail an pbivizsubmit@microsoft.com senden.You can email pbivizsubmit@microsoft.com.

Fügen Sie die PBIVIZ-Datei und die PBIX-Beispielberichtsdatei als Anlage an die E-Mail an.Attach the .pbiviz file and the sample report .pbix file in your email. Das Power BI-Team sendet eine Antwort mit Anweisungen und einer XML-Datei mit App-Paket zum Hochladen.The Power BI team will reply back with instructions and a app package XML file to upload. Dieses XML-App-Paket ist erforderlich, um Ihr Visual über das Office Developer Center zu übermitteln.This XML app package is required in order to submit your visual through the Office developer center.

Hinweis

Um die Qualität zu verbessern und zu verhindern, dass vorhandene Berichte beschädigt werden, dauert es nach der Genehmigung im Store weitere zwei Wochen, bis Aktualisierungen vorhandener Visuals die Produktionsumgebung erreichen.To improve quality and assure that existing reports are not breaking, updates to existing visuals will take an additional two weeks to reach production environment after approval in the store.

Senden von Inhalten an AppSourceSubmitting to AppSource

Nachdem Sie das XML-App-Paket vom Power BI-Team erhalten haben, navigieren Sie zum Developer Center, um Ihr Visual an AppSource zu übermitteln.Once you get the app package XML from the Power BI team, navigate to the developer center to submit your visual to AppSource.

Hinweis

Sie benötigen ein gültiges Office-Entwicklerkonto, um sich beim Office Developer Center anzumelden.You must have a valid Office developer account to log in to the Office developer center. Das Office-Entwicklerkonto muss ein Microsoft-Konto (Live ID, z. B. hotmail.com oder outlook.com) sein.An Office developer account must be a Microsoft Account (Live ID, e.g. hotmail.com or outlook.com).

Wichtig

Vor der Übermittlung an AppSource müssen Sie eine E-Mail mit der PBIVIZ-Datei und der PBIX-Datei an das Power BI-Team senden.You must send an email with the .pbiviz file and the .pbix file to the Power BI team before submitting to AppSource. Dies ist erforderlich, damit das Power BI-Team die Dateien auf den Server für die öffentliche Freigabe hochladen kann.This allows the Power BI team to upload the files to the public share server. Andernfalls kann der Store die Dateien nicht abrufen.Otherwise, the store will not be able to retrieve the files. Sie müssen bei jeder Übermittlung eines neuen Visuals, bei der Aktualisierung eines vorhandenen Visuals und bei Korrekturen von abgelehnten Visuals die Dateien übermitteln.You must send the files with each new visual submission, update to existing visual, and fixes to rejected submissions.

Prozess zum Übermitteln der VisualisierungProcess to submit visual

Führen Sie die folgenden Schritte aus, um die Übermittlung durchzuführen.Follow the below steps to complete the submission.

  1. Wählen Sie Neue App hinzufügen aus.Select Add a new app.

  2. Wählen Sie Benutzerdefiniertes visuelles Power BI-Element und dann Weiter aus.Select Power BI custom visual and then Next.
  3. Wählen Sie das Symbol + unter App-Paket, und wählen Sie im Dialogfeld „Datei öffnen“ die XML-Datei mit dem App-Paket aus, die Sie vom Power BI-Team erhalten haben.Select the + under App package and select the app package XML file that you received from the Power BI team from the open file dialog.

  4. Sie erhalten die Bestätigung, dass es sich um ein gültiges Power BI-App-Paket handelt.You should receive an approval that this is a valid Power BI app package.

  5. Machen Sie die Angaben für Allgemeine Informationen.Fill out the General info details.

    • Titel der Übermittlung: Der Name Ihrer Übermittlung im Developer Center.Submission title: How your submission will be named in the developer center
    • Version: Die Versionsnummer wird automatisch aus dem Add-In-App-Paket übernommen.Version: Your version number is auto-populated from your add-in app package.
    • Veröffentlichungsdatum (UTC): Wählen Sie das Datum aus, an dem die App im Store veröffentlicht werden soll.Release Date (UTC): Select a date for your app to release to the store. Bei Auswahl eines in der Zukunft liegenden Datums ist die App erst ab diesem Datum im Store verfügbar.If a future date is chosen, your app will not be available in the store until that date is reached.
    • Kategorie: Als erste Kategorie wird automatisch „Datenvisualisierung und BI“ eingetragen.Category: The first category will be auto populated as "Data Visualization + BI". So werden alle benutzerdefinierten Power BI-Visualisierungen gekennzeichnet. Sie können bis zu zwei zusätzliche Kategorien angeben, um Benutzern die Suche nach Ihrer Visualisierung zu erleichtern.That's how all Power BI custom visuals will be tagged.You may provide up to 2 additional categories, for help users easily search for your visual
    • Testhinweise: Optionale Angabe, wenn Sie Anweisungen für Tester bei Microsoft bereitstellen möchten.Testing notes: optional, if you'd like to provide some instructions for the testers at Microsoft
    • In meiner App ist Kryptografie oder Verschlüsselung enthalten bzw. wird von dieser aufgerufen, unterstützt oder verwendet: Lassen Sie diese Option deaktiviert.My app calls, supports, contains, or uses cryptography or encryption: leave unchecked
    • Dieses Add-In im Office-Add-In-Katalog auf iPad verfügbar machen: Lassen Sie diese Option deaktiviert.Make this add-in available in the Office add-in catalog on iPad: leave unchecked
  6. Laden Sie das Logo für Ihre Visualisierung hoch, indem Sie das Symbol + unter App-Logo auswählen.Upload your visual's logo by selecting the + under App logo. Wählen Sie dann im Dialogfeld „Datei öffnen“ die Symboldatei aus.Then select the icon file in the open file dialog. Dies muss eine PNG-, JPG-, JPEG- oder GIF-Datei sein.The file must be .png, .jpg, .jpeg or .gif. Die Bildgröße muss genau 300 px (Breite) x 300 px (Höhe) betragen, und die Dateigröße darf 512 KB nicht überschreiten.It must be exactly 300px (width) x 300px (height) and no larger than 512kb in size.

  7. Geben Sie die Details für Supportdokumente ein.Fill out the Support documents details.

    • Link zum SupportdokumentSupport document link
    • Link zum DatenschutzdokumentPrivacy document link
    • VideolinkVideo link
    • LizenzbedingungenEnd User License Agreement (EULA)

      Sie müssen eine Datei mit den Lizenzbedingungen hochladen.You must upload a EULA file. Dabei kann es sich um eigene Lizenzbedingungen oder die Standardlizenzbedingungen im Office Store für benutzerdefinierte Power BI-Visualisierungen handeln.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Wenn Sie die Standardlizenzbedingungen verwenden möchten, fügen Sie im Verkäuferdashboard im Dialogfeld zum Hochladen der Datei mit den Lizenzbedingungen die folgende URL ein:https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.

  8. Wählen Sie Weiter aus, um zur Seite Details zu gelangen.Select Next to proceed to the Details page.
  9. Wählen Sie Sprache aus, und wählen Sie eine Sprache aus der Liste.Select Language and pick a language from the list.

  10. Geben Sie die Details in „Beschreibung“ ein.Fill out the "Description" details.

    • App-Name (in dieser Sprache): Geben Sie den Titel der App ein, der in der digitalen Ladenzeile angezeigt werden soll.App name (for this language): Enter the title of your app as it should appear in the storefront.
    • Kurzbeschreibung: Geben Sie die Kurzbeschreibung der App mit bis zu 100 Zeichen ein, die in der digitalen Ladenzeile angezeigt werden soll.Short description: Enter the short description of your app, up to 100 characters, as it should appear in the storefront. Diese Beschreibung wird zusammen mit dem Logo auf den Seiten der obersten Ebene angezeigt.This description will show up in the top level pages along with the logo. Sie können die Beschreibung aus dem PBIVIZ-Paket verwenden.You can use the description from the pbiviz package.
    • Ausführliche Beschreibung: Geben Sie eine ausführlichere Beschreibung der App ein. Diese wird für Kunden auf der Seite „App-Details“ angezeigt.Long description: Provide a more detailed description of your app that customers will see on your app details page. Wenn Sie Ihr visuelles Element als Open Source-Element bereitstellen und so der Community die Möglichkeit geben möchten, Ihr Element zu verbessern, geben Sie hier den Link zu dem öffentlichen Repository (beispielsweise GitHub) an.If you'd like to let the community improve your visual by making it open source, provide the link to the public repository, such as GitHub, here.
  11. Laden Sie mindestens einen Screenshot hoch.Upload at least one screenshot. Dabei kann es sich um eine PNG-, JPG-, JPEG- oder GIF-Datei handeln.The format can be .png, .jpg, .jpeg or .gif. Die Größe muss exakt 1366 px (Breite) x 768 px (Höhe) betragen.It must be exactly 1366px (width) x 768px (height). Die Dateigröße darf 1024 KB nicht überschreiten.It can be no larger than 1024kb for the file size. Um den Nutzen der Screenshots zu erhöhen, fügen Sie Textblasen hinzu, die den Wertbeitrag wichtiger Features, die in den einzelnen Screenshots gezeigt werden, erläutern.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
  12. Wenn Sie weitere Sprachen hinzufügen möchten, wählen Sie Sprache hinzufügen aus, und wiederholen Sie die Schritte 10 und 11.If you'd like to add more languages, select Add a language and repeat steps 10 and 11. Durch das Hinzufügen weiterer Sprachen erhöhen Sie die Wahrscheinlichkeit, dass Benutzer die Details der benutzerdefinierten Visualisierung in der eigenen Sprache anzeigen können.Adding more languages will help your users view the custom visual details in their own language. Für Sprachen, die nicht aufgeführt werden, wird standardmäßig die erste ausgewählte Sprache verwendet.Languages that will not be listed will default to the first language selected.
  13. Nachdem Sie das Hinzufügen von Sprachen abgeschlossen haben, wählen Sie Weiter aus, um zur Seite Zugriff blockieren zu gelangen.When you are done adding languages, select Next to proceed to the Block access page.
  14. Wenn Sie die Verwendung oder den Kauf Ihrer App durch Kunden in bestimmten Ländern oder Regionen verhindern möchten, aktivieren Sie das Kontrollkästchen, und treffen Sie eine Auswahl aus der Liste.If you want to prevent customers in specific countries or regions from using or purchasing your app, check the box and select from the list.
  15. Wählen Sie Weiter aus, um zur Seite Preise zu gelangen.Select Next to proceed to the Pricing page.
  16. Derzeit werden nur kostenlose Visuals unterstützt, und zusätzliche Käufe im Visual (In-App-Käufe) sind unzulässig.Currently, only free visuals are supported and additional purchases inside the visual (In-App purchase) are not allowed. Wählen Sie Diese App ist kostenlos aus.Select This app is free.

    Hinweis

    Wenn Sie eine andere als die kostenlose Option auswählen oder per In-App-Kauf zu erwerbende Inhalte im übermittelten Visual enthalten sind, wird die Übermittlung zurückgewiesen.If you select any other option other than free, or have an In-App purchase content in the submitted visual, the submission will be rejected.

  17. Sie können Als Entwurf speichern auswählen und das benutzerdefinierte visuelle Element später übermitteln oder es durch Auswählen von Zur Genehmigung übermitteln an den Office Store übermitteln.You can now select Save as draft" and submit later, or select **Submit for approval to submit the custom visual to the Office store.

Nachverfolgen des Übermittlungsstatus und der VerwendungTracking submission status and usage

Sie können sich mit den Überprüfungsrichtlinien vertraut machen.You can review the validation policies.

Nach der Übermittlung können Sie im App-Dashboard den Übermittlungsstatus anzeigen.After submission, you will be able to view the submission status in the app dashboard.

Zertifizieren Ihrer VisualisierungCertify your visual

Sobald Ihre Visualisierung erstellt wurde, können Sie veranlassen, dass die Visualisierung zertifiziert wird.Once your visual is created, you can optionally get your visual certified. Dies bedeutet, sie kann im Power BI-Dienst ausgeführt und mit anderen Funktionen des Diensts, z. B. Exportieren nach PowerPoint, verwendet werden.This means it can run within the Power BI service and be used with other features of the service such as exporting to PowerPoint. Weitere Informationen finden Sie unter Wie wird ein benutzerdefiniertes visuelles Element zertifiziert?For more information, see Getting a custom visual certified.

Nächste SchritteNext steps

Erstellen benutzerdefinierter Visualisierungen mithilfe von EntwicklertoolsUse developer tools to create custom visuals
Visualisierungen in Power BIVisualizations in Power BI
Benutzerdefinierte Visualisierungen in Power BICustom Visualizations in Power BI
Wie wird ein benutzerdefiniertes visuelles Element zertifiziert?Getting a custom visual certified

Weitere Fragen?More questions? Stellen Sie Ihre Frage in der Power BI-Community.Try asking the Power BI Community