Delen via

Een Power BI-visual verpakken

  • Artikel

Voordat u uw aangepaste visual in Power BI Desktop kunt laden of met de community kunt delen in de Power BI Visual Gallery, moet u deze inpakken. Met deze zelfstudie gaat u het volgende doen:

Eigenschapswaarden invoeren

  1. Stop in PowerShell de visual als deze wordt uitgevoerd.

  2. Navigeer in VS Code naar de hoofdmap van uw visualproject en open het bestand pbiviz.json .

  3. Stel in het visual object de displayName waarde in op de weergavenaam van uw visual.

    Screenshot of VS Code, which shows the display name value is set to Circle Card.

    De weergavenaam van de visual wordt weergegeven in het deelvenster Visualisaties van Power BI wanneer u de cursor boven het visualpictogram beweegt.

  4. Vul of wijzig de volgende velden in het bestand pbiviz.json :

    • visualClassName
    • description

    visualClassName is optioneel, maar description moet worden ingevuld om de pakketopdracht uit te voeren.

  5. Vul de gitHubUrl URL's in supportUrl die een gebruiker kan bezoeken om ondersteuning te krijgen en het GitHub-project van uw visual weer te geven.

    De volgende code toont supportUrl en gitHubUrl voorbeelden:

    {
    "supportUrl": "https://community.powerbi.com",
    "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
}

  6. Voer uw naam en e-mailadres in het author object in.

  7. Sla het pbiviz.json-bestand op.

Het pictogram bijwerken (optioneel)

  1. In het bestand pbiviz.json ziet u dat het document een pad naar een pictogram in het assets object definieert. Het pictogram is de afbeelding die wordt weergegeven in het deelvenster Visualisaties in Power BI. Het moet een PNG-indelingsbestand en 20 x 20 pixels zijn.

  2. Kopieer in Windows Verkenner het bestand icon.png dat u wilt gebruiken en plak het om het standaard icon.png-bestand in de map assets te vervangen.

  3. Vouw in VS Code in het deelvenster Explorer de map assets uit en selecteer vervolgens het bestand icon.png .

  4. Controleer het pictogram.

De visual verpakken

  1. Zorg ervoor dat alle bestanden in VS Code worden opgeslagen.

  2. Voer in PowerShell de volgende opdracht in om een pbiviz-bestand te genereren:

    pbiviz package

    Met deze opdracht maakt u een pbiviz-bestand in de map /dist/ van uw visualproject en overschrijft u een eerder pbiviz-bestand dat mogelijk bestaat.

    Screenshot of Windows Explorer, which shows the folder hierarchy of the Power BI visual project. The dist folder is highlighted.

Het pakket wordt uitgevoerd naar de map /dist/ van het project. Het pakket bevat alles wat nodig is om de aangepaste visual te importeren in het Power BI-service of een Power BI Desktop-rapport. U hebt de aangepaste visual verpakt en deze is klaar voor gebruik.

Gerelateerde inhoud