Udostępnij za pośrednictwem

Integracja systemu wizualizacji usługi Power BI

  • Artykuł

W tym artykule opisano interfejs API wizualizacji oraz sposób, w jaki usługa Power BI obsługuje interakcje między Tobą, wizualizacją i hostem.

Akcje i kolejne aktualizacje w usłudze Power BI można inicjować ręcznie lub automatycznie. Typy aktualizacji:

Na poniższej ilustracji przedstawiono sposób typowych akcji opartych na wizualizacjach, takich jak wybieranie zakładki, proces w usłudze Power BI.

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 odbierać rzeczywiste wartości właściwości, usługa Power BI wywołuje getFormattingModel metodę wizualizacji (interfejsy API starsze niż wywołanie enumerateObjectInstances wersji 5.0). Interfejs API zwraca nowoczesne składniki, właściwości i rzeczywiste wartości modelu okienka formatu.

    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 pobiera nową aktualizację options obiektów, gdy istnieją nowe dane w jednym z zagnieżdżonych obiektów. Sposób aktualizowania zależy od konfiguracji mapowania widoku danych 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 pobiera nowe przefiltrowane dane lub pobiera te same dane z tablicą wyróżnień.

    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 wykonaj następujące czynności:

    • 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 odebranych wyborów lub filter obiektu.

      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świetlić więcej informacji o punkcie danych za pomocą interfejsu API etykietek narzędzi usługi Power BI. Po umieszczeniu wskaźnika myszy nad elementem wizualizacji wizualizacja może obsłużyć zdarzenie i wyświetlić dane dotyczące skojarzonego elementu etykietki narzędzia. Wizualizacja może wyświetlać standardową etykietkę narzędzia lub etykietkę narzędzia strony raportu.

    Aby uzyskać więcej informacji, zobacz Dodawanie etykietek narzędzi do wizualizacji usługi Power BI.

  • Zmień właściwości wizualizacji (na przykład przez rozwinięcie drzewa), a wizualizacja zapisuje nowy stan we właściwościach wizualizacji.

    Wizualizacja może zapisywać wartości właściwości za pośrednictwem interfejs API usługi 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, aby filtrować dane w innych wizualizacjach. Dostępnych jest kilka typów filtrów, w tym filtry podstawowe, zaawansowane i krotki.

    Aby uzyskać więcej informacji, zobacz Interfejs API filtrów wizualnych w wizualizacjach usługi Power BI.

  • Wybierz elementy w wizualizacji.

    Aby uzyskać więcej informacji na temat wyborów w wizualizacji usługi Power BI, zobacz Dodawanie interakcyjności do wizualizacji przy użyciu wybranych wizualizacji usługi 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.

    Wizualizacja przetwarza część danych 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ń wyzwala.

    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: