Udostępnij za pośrednictwem

Integracja systemu wizualizacji usługi Power BI

  • Artykuł

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:

Na poniższej ilustracji pokazano, jak w Power BI przetwarzane są typowe akcje oparte na wizualizacjach, takie jak wybieranie zakładki.

Diagram procesu wizualizacji usługi Power BI.

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 metoda enumerateObjectInstances). 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 nowy options obiekt do update 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 nowy options obiekt. Obiekty options mają zagnieżdżone viewport 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 odpowiednim filter obiektem wewnątrz options 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: