Udostępnij za pośrednictwem


Co to jest osadzony interfejs API klienta analizy usługi Power BI?

Napiwek

Aby eksperymentować z interfejsami API w czasie rzeczywistym, korzystając z własnego raportu lub przykładowego raportu, odwiedź osadzony plac zabaw analizy usługi Power BI

Interfejs API klienta usługi Power BI to biblioteka po stronie klienta, która umożliwia programowe sterowanie osadzoną zawartością usługi Power BI przy użyciu języka JavaScript lub TypeScript.

Interfejsy API klienta umożliwiają komunikację między elementami usługi Power BI (takimi jak raporty i pulpity nawigacyjne) oraz kodem aplikacji. Zapewnia to elastyczność tworzenia środowiska użytkownika końcowego zgodnie z projektem.

Jak działa biblioteka klienta?

Interfejsy API klienta komunikują się z osadzonym elementem usługi Power BI, takim jak raport lub pulpit nawigacyjny. Element iframe tworzy separację między aplikacją hostingową a elementem usługi Power BI, upewniając się, że dane są zabezpieczone.

Diagram przedstawiający interfejsy API języka JavaScript usługi Power BI w odniesieniu do usługi Power BI.

  • aplikacja kliencka — cały zrzut ekranu jest przykładem aplikacji klienckiej.

  • Osadzony raport — osadzony raport wyświetlany obecnie w aplikacji.

  • granicy elementu iFrame — osadzony raport jest hostowany wewnątrz elementu iFrame. Diagram przedstawia granicę.

  • interfejsy API klienta — użyj interfejsów API klienta do komunikacji między aplikacją internetową a składnikiem osadzonym. Na przykład podczas wywoływania report.setPage(…) zostanie zmieniona aktywna strona raportu. Po zmianie strony pageChanged zdarzenie będzie emitowane przez raport i można dodać dodatkowy kod w procedurze obsługi zdarzeń. Aby uzyskać więcej informacji, zobacz nawigacji na stronie.

Jaki jest ten zestaw dokumentacji?

Ten zestaw dokumentacji zawiera listę interfejsów API dla następujących składników:

  • powerbi-client — główna biblioteka klienta usługi Power BI zawierająca wszystkie interfejsy API klienta usługi Power BI, z wyjątkiem powerbi-report-authoring. Ta biblioteka definiuje klasy dla różnych elementów usługi Power BI, które można osadzać. Biblioteka powerbi-client umożliwia kontrolowanie osadzanej zawartości.

  • powerbi-models — zawiera modele obiektów dla interfejsów API klienta usługi Power BI. Dla każdego modelu istnieje interfejs TypeScript, definicja schematu JSON i funkcja walidacji, aby upewnić się, że dany obiekt jest prawidłowym modelem.

  • powerbi-report-authoring — rozszerzenie biblioteki klienta. Te interfejsy API ułatwiają tworzenie wizualizacji i tworzenie raportu po jego załadowaniu. Biblioteka powerbi-report-authoring umożliwia programowe edytowanie osadzonych raportów.

Zestaw dokumentacji zawiera również artykuły, w których wyjaśniono, jak używać interfejsów API wraz z przykładami kodu. Artykuły są podzielone na następujące sekcje:

  • Omówienie — dodatkowe informacje o osadzonej analizie usługi Power BI.

  • Playground prezentuje — dowiedz się, jak szybko korzystać z osadzonej analizy w aplikacjach przy użyciu osadzonego placu zabaw analizy usługi Power BI.

  • Rozpocznij osadzanie — dowiedz się, jak osadzić poszczególne elementy usługi Power BI, takie jak raporty i pulpity nawigacyjne.

  • Podstawowe pojęcia — zapoznaj się z niektórymi pojęciami, które powinien znać każdy deweloper.

  • osadzanie raportów — dodatkowe koncepcje osadzania mają zastosowanie tylko w przypadku raportów.

  • operacje raportów — dostosowywanie osadzonego raportu w celu zapewnienia lepszego środowiska użytkownika dla klientów.

  • Osadzanie raportów dla organizacji — tworzenie lepszych osadzonych raportów podczas osadzania przy użyciu osadzania dla rozwiązania organizacji.

  • tworzenie raportów — artykuły przeznaczone dla interfejsów API tworzenia raportów powerbi-report-authoring, co umożliwia tworzenie i personalizowanie wizualizacji po załadowaniu raportu.

Wpis Resources zawiera zasoby przydatne dla deweloperów usługi Power BI.

Nuta

Zaleca się przejrzenie tych artykułów podczas eksperymentowania z narzędziem osadzonej analizy usługi Power BI.