Paketera ett visuellt Power BI-objekt

Innan du kan läsa in ditt anpassade visuella objekt i Power BI Desktop eller dela det med communityn i Power BI Visual Gallery måste du paketera det. Med den här självstudien kommer du att:

• Ange egenskapsvärden och metadata för det visuella objektet.
• Uppdatera ikonen.
• Paketera det anpassade visuella objektet.

Ange egenskapsvärden

1. I PowerShell stoppar du det visuella objektet om det körs.

2. I VS Code navigerar du till rotmappen för ditt visuella projekt och öppnar filen pbiviz.json .

3. visual I objektet anger displayName du värdet till det du vill ska vara det visuella objektets visningsnamn.

   

   Det visuella objektets visningsnamn visas i fönstret Visualiseringar i Power BI när du hovrar markören över den visuella ikonen.

4. Fyll i eller ändra följande fält i filen pbiviz.json :

   • visualClassName
   • description

   visualClassName är valfritt, men description måste fyllas i för att paketkommandot ska kunna köras.

5. Fyll i supportUrl och gitHubUrl med de URL:er som en användare kan besöka för att få support och visa ditt visuella objekts GitHub-projekt.

   Följande kod visar supportUrl och gitHubUrl exempel:

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

6. Ange ditt namn och din e-postadress i author objektet.

7. Spara filen pbiviz.json.

Uppdatera ikonen (valfritt)

1. Observera att dokumentet definierar en sökväg till en ikon i objektet i assets filen pbiviz.json. Ikonen är den bild som visas i fönstret Visualiseringar i Power BI. Det måste vara en PNG-formatfil och 20 x 20 bildpunkter.

2. I Utforskaren kopierar du filen icon.png som du vill använda och klistrar sedan in den för att ersätta standardfilen icon.png som finns i mappen assets .

3. I VS Code går du till fönstret Utforskaren , expanderar mappen assets och väljer sedan filen icon.png .

4. Granska ikonen.

   

Paketera det visuella objektet

1. Kontrollera att alla filer sparas i VS Code.

2. I PowerShell anger du följande kommando för att generera en pbiviz-fil :

   pbiviz package
   

   Det här kommandot skapar en pbiviz-fil i katalogen /dist/ i ditt visuella projekt och skriver över alla tidigare pbiviz-filer som kan finnas.

   

Paketet matar ut till mappen /dist/ i projektet. Paketet innehåller allt som krävs för att importera det anpassade visuella objektet till antingen Power BI-tjänst eller en Power BI Desktop-rapport. Du har paketerat det anpassade visuella objektet och det är redo att användas.

Relaterat innehåll

Publicera visuella Power BI-objekt till Partnercenter

Importera ett anpassat visuellt objekt