Share via


Power BI görseli paketleme

Özel görselinizi Power BI Desktop'a yükleyebilmeniz veya Power BI Görsel Galerisi'ndeki toplulukla paylaşabilmeniz için önce paketlemeniz gerekir. Bu öğreticiyi kullanarak şunları yapacaksınız:

Özellik değerlerini girin

  1. PowerShell'de çalışıyorsa görseli durdurun.

  2. VS Code'da görsel projenizin kök klasörüne gidin ve pbiviz.json dosyasını açın.

  3. nesnesinde visual , değeri görselinizin görünen adı olmasını istediğiniz değere ayarlayın displayName .

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

    İmleci görsel simgesinin üzerine getirdiğinizde Görsel Öğeler bölmesinde görselin görünen adı görüntülenir.

  4. pbiviz.json dosyasında aşağıdaki alanları doldurun veya değiştirin:

    • visualClassName
    • description

    visualClassName isteğe bağlıdır, ancak description paket komutunun çalışması için doldurulması gerekir.

  5. supportUrl Destek almak ve görselinizin GitHub projesini görüntülemek için kullanıcının ziyaretebileceği URL'lerle ve gitHubUrl bilgilerini doldurun.

    Aşağıdaki kodda ve gitHubUrl örnekleri gösterilmektedirsupportUrl:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Nesneye author adınızı ve e-postanızı girin.

  7. pbiviz.json dosyasını kaydedin.

Simgeyi güncelleştirme (isteğe bağlı)

  1. pbiviz.json dosyasında, belgenin nesnedeki assets bir simgenin yolunu tanımladığını göreceksiniz. Simge, Power BI'daki Görselleştirmeler bölmesinde görünen resimdir. PNG biçimli bir dosya ve 20 x 20 piksel olmalıdır.

  2. Windows Gezgini'nde, kullanmak istediğiniz icon.png dosyasını kopyalayın ve ardından assets klasöründe bulunan varsayılan icon.png dosyasını değiştirmek için yapıştırın.

  3. VS Code'da, Gezgin bölmesinde assets klasörünü genişletin ve icon.png dosyasını seçin.

  4. Simgeyi gözden geçirin.

Görseli paketleme

  1. VS Code'da tüm dosyaların kaydedildiğinden emin olun.

  2. PowerShell'de bir pbiviz dosyası oluşturmak için aşağıdaki komutu girin:

    pbiviz package
    

    Bu komut görsel projenizin /dist/ dizininde bir pbiviz dosyası oluşturur ve mevcut olabilecek önceki pbiviz dosyalarının üzerine yazar.

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

Paket, projenin /dist/ klasörüne çıkar. Paket, özel görseli Power BI hizmeti veya Power BI Desktop raporuna aktarmak için gereken her şeyi içerir. Özel görseli paketlediğiniz için kullanıma hazır.