Pakke et Power BI-visualobjekt

Før du kan laste inn det egendefinerte visualobjektet i Power BI Desktop eller dele det med fellesskapet i visualobjektgalleriet i Power BI, må du pakke det. Ved hjelp av denne opplæringen gjør du følgende:

Angi egenskapsverdier

  1. Stopp visualobjektet i PowerShell hvis det kjører.

  2. til rotmappen for det visuelle prosjektet i VS Code, og åpne pbiviz.json-filen .

  3. Angi verdien til visningsnavnet for visualobjektet visualdisplayName i objektet.

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

    Visningsnavnet for visualobjektet vises i Visualiseringer-ruten i Power BI når du holder markøren over visualobjektikonet.

  4. Fyll ut eller endre følgende felt i pbiviz.json-filen :

    • visualClassName
    • description

    visualClassName er valgfritt, men description må fylles ut for at pakkekommandoen skal kunne kjøres.

  5. supportUrl Fyll ut og gitHubUrl med nettadressene som en bruker kan besøke for å få støtte og vise visualobjektets GitHub-prosjekt.

    Følgende kode viser supportUrl og gitHubUrl eksempler:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Skriv inn navn og e-post i author objektet.

  7. Lagre pbiviz.json-filen.

Oppdater ikonet (valgfritt)

  1. Legg merke til at dokumentet definerer en bane til et ikon i assets objektet i pbiviz.json-filen. Ikonet er bildet som vises i Visualiseringer-ruten i Power BI. Det må være en PNG-formatfil og 20 x 20 piksler.

  2. Kopier icon.png-filen du vil bruke, i Windows Utforsker, og lim den deretter inn for å erstatte standardikonet.png-filen i aktivamappen.

  3. Utvid aktivamappen i Explorer-ruten i VS Code, og velg deretter icon.png-filen.

  4. Se gjennom ikonet.

Pakke visualobjektet

  1. Kontroller at alle filene er lagret i VS Code.

  2. I PowerShell skriver du inn følgende kommando for å generere en pbiviz-fil :

    pbiviz package
    

    Denne kommandoen oppretter en pbiviz-fil i /dist/ -katalogen for det visuelle prosjektet, og overskriver alle tidligere pbiviz-filer som kan eksistere.

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

Pakken sendes til /dist/ -mappen for prosjektet. Pakken inneholder alt som kreves for å importere det egendefinerte visualobjektet til enten Power Bi-tjeneste eller en Power BI Desktop-rapport. Du pakket det egendefinerte visualobjektet, og det er klart for bruk.