Del via


Pak en Power BI-visualisering

Før du kan indlæse din brugerdefinerede visualisering i Power BI Desktop eller dele den med community'et i Power BI Visual Gallery, skal du pakke den. Ved hjælp af dette selvstudium skal du:

Angiv egenskabsværdier

  1. I PowerShell skal du stoppe visualiseringen, hvis den kører.

  2. I VS Code skal du navigere til rodmappen for dit visuelle projekt og åbne filen pbiviz.json .

  3. I objektet visual skal du angive værdien displayName til det, du vil være visualiseringens viste navn.

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

    Visualiseringens viste navn vises i ruden Visualiseringer i Power BI, når du holder markøren over ikonet for visualiseringen.

  4. Udfyld eller rediger følgende felter i filen pbiviz.json :

    • visualClassName
    • description

    visualClassName er valgfri, men description skal udfyldes, for at pakkekommandoen kan køre.

  5. Udfyld supportUrl og gitHubUrl med de URL-adresser, som en bruger kan besøge for at få support og få vist gitHub-projektet for din visualisering.

    Følgende kode viser supportUrl og gitHubUrl eksempler:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Angiv dit navn og din mail i objektet author .

  7. Gem filen pbiviz.json.

Opdater ikonet (valgfrit)

  1. Bemærk, at dokumentet definerer en sti til et ikon i objektet i assets filen pbiviz.json. Ikonet er det billede, der vises i ruden Visualiseringer i Power BI. Det skal være en PNG-formatfil og 20 x 20 pixel.

  2. I Windows Stifinder skal du kopiere den icon.png-fil , du vil bruge, og derefter indsætte den for at erstatte standardfilen icon.png , der er placeret i mappen assets .

  3. Udvid mappen assets i ruden Stifinder i VS Code, og vælg derefter filen icon.png.

  4. Gennemse ikonet.

Pak visualiseringen

  1. I VS Code skal du sikre dig, at alle filer er gemt.

  2. I PowerShell skal du angive følgende kommando for at generere en pbiviz-fil :

    pbiviz package
    

    Denne kommando opretter en pbiviz-fil i mappen /dist/ for dit visuelle projekt og overskriver eventuelle tidligere pbiviz-filer , der kan findes.

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

Pakken udskrives i mappen /dist/ for projektet. Pakken indeholder alt, hvad der kræves for at importere den brugerdefinerede visualisering til enten Power BI-tjeneste eller en Power BI Desktop-rapport. Du pakkede den brugerdefinerede visualisering, og den er klar til brug.