Integracja systemu wizualizacji usługi Power BI
W artykule opisano Visual API oraz sposób, w jaki usługa Power BI obsługuje interakcje między wizualizacją, hostem i Tobą.
Akcje i kolejne aktualizacje w usłudze Power BI można inicjować ręcznie lub automatycznie. Typy aktualizacji:
- Interakcja z wizualizacją za pośrednictwem usługi Power BI.
- Bezpośrednie interakcje z wizualizacją.
- Wizualizacja współdziała z usługą Power BI.
Na poniższej ilustracji pokazano, jak w Power BI przetwarzane są typowe akcje oparte na wizualizacjach, takie jak wybieranie zakładki.
Interakcja z wizualizacją za pośrednictwem usługi Power BI
Wizualizację można zaktualizować za pomocą usługi Power BI w następujący sposób:
Otwórz panel właściwości wizualizacji.
Po otwarciu panelu właściwości wizualizacji usługa Power BI pobiera obsługiwane obiekty i właściwości z pliku capabilities.json wizualizacji. Aby uzyskać rzeczywiste wartości właściwości, usługa Power BI wywołuje metodę wizualizacji
getFormattingModel
(w przypadku interfejsów API starszych niż wersja 5.0 wywoływana jest metodaenumerateObjectInstances
). Interfejs API zwraca nowoczesne elementy modelu panelu formatu, ich właściwości i rzeczywiste wartości.Aby uzyskać więcej informacji, zobacz Możliwości i właściwości wizualizacji usługi Power BI.
Dostosowywanie tytułów wizualizacji, tła, etykiet i legend.
Po zmianie wartości właściwości na panelu Format usługa Power BI wywołuje metodę
update
. Usługa Power BI przekazuje nowyoptions
obiekt doupdate
metody, a obiekty zawierają nowe wartości.Aby uzyskać więcej informacji, zobacz Obiekty i właściwości wizualizacji usługi Power BI.
Zmień rozmiar wizualizacji.
Po zmianie rozmiaru wizualizacji usługa Power BI wywołuje metodę
update
i przekazuje nowyoptions
obiekt. Obiektyoptions
mają zagnieżdżoneviewport
obiekty, które zawierają nową szerokość i wysokość wizualizacji.Zastosuj filtr na poziomie raportu, strony lub wizualizacji.
Usługa Power BI filtruje dane na podstawie warunków filtrowania. Usługa Power BI wywołuje
update
metodę wizualizacji, aby zaktualizować wizualizację przy użyciu nowych danych.Wizualizacja jest aktualizowana o nowe dane
options
obiektów, gdy istnieją nowe dane w jednym z zagnieżdżonych obiektów. Proces aktualizacji zależy od konfiguracji mapowania widoku danych w wizualizacji.Aby uzyskać więcej informacji, zobacz Omówienie mapowania widoku danych w wizualizacjach usługi Power BI.
Wybierz punkt danych w innej wizualizacji w raporcie.
Po wybraniu punktu danych w innej wizualizacji w raporcie usługa Power BI filtruje lub wyróżnia wybrane punkty danych i wywołuje metodę wizualizacji
update
. Wizualizacja otrzymuje nowe przefiltrowane dane albo te same dane z tablicą zaznaczeń.Aby uzyskać więcej informacji, zobacz Wyróżnianie punktów danych w wizualizacjach usługi Power BI.
Wybierz zakładkę w panelu Zakładki raportu.
Po wybraniu zakładki w panelu Zakładki, możesz:
Usługa Power BI wywołuje funkcję, która jest przekazywana i zarejestrowana przez metodę
registerOnSelectionCallback
. Funkcja wywołania zwrotnego pobiera tablice wyborów dla odpowiedniej zakładki.Usługa Power BI wywołuje metodę
update
z odpowiednimfilter
obiektem wewnątrzoptions
obiektu.W obu przypadkach wizualizacja zmienia swój stan zgodnie z otrzymanymi wyborami lub
filter
obiektem.Aby uzyskać więcej informacji na temat zakładek i filtrów, zobacz Interfejs API filtrów wizualnych w wizualizacjach usługi Power BI.
Bezpośrednia interakcja z wizualizacją
Możesz również bezpośrednio korzystać z wizualizacji, aby ją zaktualizować:
Umieść kursor na elemecie danych.
Wizualizacja może wyświetlać więcej informacji o punkcie danych za pomocą interfejsu API wizualizacji danych w usłudze Power BI. Po najechaniu wskaźnikiem myszy na element wizualny, wizualizacja może obsłużyć zdarzenie i wyświetlić dane dotyczące powiązanego elementu tooltipa. Wizualizacja może wyświetlać standardową etykietkę narzędzia lub etykietkę narzędzia strony raportu.
Aby uzyskać więcej informacji, zobacz Dodawanie etykiet narzędziowych do wizualizacji Power BI.
Zmień parametry wizualne (na przykład przez rozwinięcie drzewa), a wizualizacja zapisze nowy stan w tych parametrach.
Wizualizacja może zapisywać wartości właściwości za pośrednictwem interfejsu API Power BI. Na przykład w przypadku interakcji z wizualizacją i konieczności zapisania lub zaktualizowania wartości właściwości wizualizacja może wywołać metodę
persistProperties
.Wybierz adres URL.
Domyślnie wizualizacja nie może bezpośrednio otworzyć adresu URL. Aby otworzyć adres URL na nowej karcie, wizualizacja może wywołać
launchUrl
metodę i przekazać adres URL jako parametr.Aby uzyskać więcej informacji, zobacz Tworzenie adresu URL uruchamiania.
Zastosuj filtr za pomocą wizualizacji.
Wizualizacja może wywołać metodę
applyJsonFilter
i przekazać warunki do filtrowania danych w innych wizualizacjach. Dostępnych jest kilka typów filtrów, w tym filtry podstawowe, zaawansowane i typu tuple.Aby uzyskać więcej informacji, zobacz Interfejs API filtrów wizualnych w wizualizacjach usługi Power BI.
Wybierz elementy w obrazie.
Aby uzyskać więcej informacji na temat wyborów w wizualizacji Power BI, zobacz Dodawanie interaktywności do wizualizacji poprzez wybory w wizualizacji Power BI.
Wizualizacja współdziała z usługą Power BI
Czasami wizualizacja inicjuje komunikację z hostem usługi Power BI bez żadnych danych wejściowych:
Wizualizacja żąda większej ilości danych z usługi Power BI.
Procesy wizualne przetwarzają dane część po części. Metoda
fetchMoreData
interfejsu API żąda następnego fragmentu danych w modelu semantycznym.Aby uzyskać więcej informacji, zobacz Pobieranie dodatkowych danych z usługi Power BI.
Usługa zdarzeń się uruchamia.
Usługa Power BI może wyeksportować raport do formatu PDF lub wysłać raport pocztą e-mail (dotyczy tylko certyfikowanych wizualizacji). Aby powiadomić usługę Power BI o zakończeniu renderowania i że wizualizacja jest gotowa do przechwycenia jako plik PDF lub wiadomość e-mail, wizualizacja powinna wywołać interfejs API zdarzeń renderowania.
Aby uzyskać więcej informacji, zobacz Eksportowanie raportów z usługi Power BI do formatu PDF.
Aby dowiedzieć się więcej o usłudze zdarzeń, zobacz "Renderowanie" zdarzeń w wizualizacjach usługi Power BI.
Powiązana zawartość
Chcesz tworzyć wizualizacje i dodawać je do usługi Microsoft AppSource? Zobacz następujące artykuły: