Pakietowanie wizualizacji 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:

• Podaj wartości właściwości i metadane elementu wizualnego.
• Zaktualizuj ikonę.
• Spakuj wizualizację dostosowaną.

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 tę, którą chcesz ustawić jako nazwę wyświetlaną elementu wizualnego.

   

   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. Podaj adresy URL w polach supportUrl i gitHubUrl, które użytkownik może odwiedzić, aby uzyskać pomoc techniczną i wyświetlić projekt GitHub dla Twojej 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 assets w 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 zasobów .

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

4. Przejrzyj ikonę.

   

Przygotowanie 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ć.

   

Pakiet zapisuje pliki do folderu /dist/ projektu. Pakiet zawiera wszystkie elementy wymagane do zaimportowania wizualizacji niestandardowej do usługi Power BI lub raportu programu Power BI Desktop. Spakowałeś wizualizację niestandardową i jest gotowa do użycia.

Treści powiązane

• Publikowanie wizualizacji usługi Power BI w Centrum partnerskim
• Importowanie wizualizacji niestandardowej