Tworzenie pakietu wizualizacji usługi Power BI

Aby można było załadować wizualizację niestandardową do programu Power BI Desktop lub udostępnić ją społeczności w galerii wizualizacji usługi Power BI, musisz ją spakować. Korzystając z tego samouczka, wykonasz następujące elementy:

Wprowadź wartości właściwości

  1. W programie PowerShell zatrzymaj wizualizację, jeśli jest uruchomiona.

  2. W programie VS Code przejdź do folderu głównego projektu wizualizacji i otwórz plik pbiviz.json .

  3. visual W obiekcie ustaw displayName wartość na nazwę wyświetlaną wizualizacji.

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

    Nazwa wyświetlana wizualizacji jest wyświetlana w okienku Wizualizacje usługi Power BI po umieszczeniu kursora na ikonie wizualizacji.

  4. Wypełnij lub zmodyfikuj następujące pola w pliku pbiviz.json :

    • visualClassName
    • description

    visualClassName parametr jest opcjonalny, ale description musi zostać wypełniony, aby można było uruchomić polecenie pakietu.

  5. supportUrl Podaj adresy gitHubUrl URL, które użytkownik może odwiedzić, aby uzyskać pomoc techniczną i wyświetlić projekt GitHub wizualizacji.

    Poniższy kod pokazuje supportUrl i gitHubUrl przykłady:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Wprowadź swoje imię i nazwisko i adres e-mail w author obiekcie.

  7. Zapisz plik pbiviz.json.

Aktualizowanie ikony (opcjonalnie)

  1. W pliku pbiviz.json zwróć uwagę, że dokument definiuje ścieżkę do ikony w assets obiekcie. Ikona to obraz wyświetlany w okienku Wizualizacje w usłudze Power BI. Musi to być plik w formacie PNG i 20 x 20 pikseli.

  2. W Eksploratorze Windows skopiuj plik icon.png , którego chcesz użyć, a następnie wklej go, aby zastąpić domyślny plik icon.png znajdujący się w folderze assets .

  3. W programie VS Code w okienku Eksplorator rozwiń folder assets , a następnie wybierz plik icon.png .

  4. Przejrzyj ikonę.

Pakowanie wizualizacji

  1. W programie VS Code upewnij się, że wszystkie pliki są zapisywane.

  2. W programie PowerShell wprowadź następujące polecenie, aby wygenerować plik pbiviz :

    pbiviz package
    

    To polecenie tworzy plik pbiviz w katalogu /dist/ projektu wizualizacji i zastępuje dowolny poprzedni plik pbiviz, który może istnieć.

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

Pakiet jest zwracany do folderu /dist/ projektu. Pakiet zawiera wszystkie elementy wymagane do zaimportowania wizualizacji niestandardowej do usługa Power BI lub raportu programu Power BI Desktop. Wizualizacja niestandardowa została spakowana i jest gotowa do użycia.