Bagikan melalui


Mengemas visual Power BI

Sebelum Anda bisa memuat visual kustom Anda ke Power BI Desktop atau membagikannya dengan komunitas di Galeri Visual Power BI, Anda perlu mengemasnya. Dengan menggunakan tutorial ini, Anda akan:

Memasukkan nilai properti

  1. Di PowerShell, hentikan visual jika sedang berjalan.

  2. Di Visual Studio Code, navigasikan ke folder akar proyek visual Anda dan buka file pbiviz.json.

  3. visual Di objek , atur nilai ke displayName apa yang Anda inginkan untuk menjadi nama tampilan visual Anda.

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

    Nama tampilan visual muncul di panel Visualisasi Power BI saat Anda mengarahkan kursor ke ikon visual.

  4. Isi atau ubah bidang berikut dalam file pbiviz.json :

    • visualClassName
    • description

    visualClassName bersifat opsional, tetapi description harus diisi agar perintah paket dapat dijalankan.

  5. supportUrl Isi dan gitHubUrl dengan URL yang dapat dikunjungi pengguna untuk mendapatkan dukungan dan melihat proyek GitHub visual Anda.

    Kode berikut menunjukkan supportUrl dan gitHubUrl contoh:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Masukkan nama dan email Anda di objek author.

  7. Simpan file pbiviz.json.

Memperbarui ikon (opsional)

  1. Dalam file pbiviz.json, perhatikan bahwa dokumen mendefinisikan jalur ke ikon di assets objek. Ikon adalah gambar yang muncul di panel Visualisasi di Power BI. Ini harus berupa file format PNG dan 20 x 20 piksel.

  2. Di Windows Explorer, salin file icon.png yang ingin Anda gunakan, lalu tempelkan untuk mengganti file icon.png default yang terletak di folder aset.

  3. Di Visual Studio Code, di panel Explorer, perluas folder aset , lalu pilih file icon.png .

  4. Tinjau ikon.

Mengemas visualnya

  1. Di Visual Studio Code, pastikan semua file disimpan.

  2. Di PowerShell, masukkan perintah berikut untuk membuat file pbiviz:

    pbiviz package
    

    Perintah ini membuat file pbiviz di direktori /dist/ proyek visual Anda, dan menimpa file pbiviz sebelumnya yang mungkin ada.

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

Paket keluaran ke folder /dist/ proyek. Paket berisi semua yang diperlukan untuk mengimpor visual kustom ke dalam laporan Power BI Desktop atau layanan Power BI. Anda mengemas visual kustom, dan siap digunakan.