Vytvorenie balíka vizuálu služby Power BI

Skôr než budete môcť načítať vlastný vizuál do aplikácie Power BI Desktop alebo ho zdieľať s komunitou v galérii vizuálov Power BI, musíte ho zabaliť. V tomto kurze:

Zadanie hodnôt vlastností

  1. Ak je v prostredí PowerShell spustený, zastavte vizuál.

  2. V nástroji VS Code prejdite do koreňového priečinka projektu vizuálu a otvorte súbor pbiviz.json .

  3. V objekte visual nastavte displayName hodnotu, ktorá má byť zobrazovaným názvom vášho vizuálu.

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

    Zobrazovaný názov vizuálu sa zobrazí na table Vizualizácie služby Power BI, keď ukážete kurzorom na ikonu vizuálu.

  4. V súbore pbiviz.json vyplňte alebo upravte nasledujúce polia:

    • visualClassName
    • description

    visualClassName je voliteľný, ale description na spustenie príkazu balíka musí byť vyplnený.

  5. Vyplňte URL adresy, ktoré môže používateľ navštíviť, aby ste získali podporu a zobrazili projekt vášho vizuálu supportUrlgitHubUrl v službe GitHub.

    Nasledujúci kód zobrazuje supportUrl a gitHubUrl príklady:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Zadajte do objektu svoje meno a e-mail author .

  7. Uložte súbor pbiviz.json.

Aktualizovať ikonu (voliteľné)

  1. V súbore pbiviz.json si všimnite, že dokument definuje cestu k ikone v objekte assets . Ikona je obrázok, ktorý sa zobrazí na table Vizualizácie v službe Power BI. Musí to byť súbor vo formáte PNG s veľkosťou 20 x 20 pixelov.

  2. V Prieskumníkovi skopírujte súbor icon.png , ktorý chcete použiť, a potom ho prilepte, aby nahradil súbor default icon.png , ktorý sa nachádza v priečinku položiek .

  3. V nástroji VS Code na table Prieskumník rozbaľte priečinok položiek a potom vyberte súbor icon.png .

  4. Skontrolujte ikonu.

Vytvorenie balíka vizuálu

  1. V nástroji VS Code sa uistite, že sú všetky súbory uložené.

  2. V prostredí PowerShell zadajte nasledujúci príkaz, čím vygenerujete súbor pbiviz :

    pbiviz package
    

    Tento príkaz vytvorí súbor pbiviz v adresári /dist/ vášho projektu vizuálu a prepíše akýkoľvek predchádzajúci súbor pbiviz, ktorý môže existovať.

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

Výstupy balíka do priečinka /dist/ projektu. Balík obsahuje všetko potrebné na import vlastného vizuálu buď do služba Power BI, alebo do zostavy aplikácie Power BI Desktop. Zabalil ste vlastný vizuál a je pripravený na použitie.