Dotyczy wersji: 2024 R1 i powyżej; autorzy: Przemysław Sierant, Krystyna Gawryał
Wprowadzenie
Począwszy od wersji WEBCON BPS 2020 mamy możliwość osadzenia raportu Power BI na dashboardzie w Portalu. Umożliwia on prezentację dowolnego zestawu danych, przygotowanego wcześniej w usłudze Power BI. Mamy możliwość osadzenia zarówno widoku całego raportu, jak również poszczególnych jego elementów.
Konfiguracja
Do prawidłowego działania raportów Power BI osadzonych w WEBCON BPS Portal konieczne jest podanie prawidłowego identyfikatora Application ID w Konfiguracji systemu.
W jaki sposób możemy uzyskać identyfikator? W tym celu musimy przeprowadzić rejestrację BPS Portal w usłudze Azure AD. Rejestrację można przeprowadzić przy pomocy narzędzia Power BI Embedding setup dostępnego pod adresem https://app.powerbi.com/embedsetup lub bezpośrednio w portalu Azure. W tym pierwszym przypadku wybieramy opcję Embed for your organization.
Następnie logujemy się do Power BI i klikamy Next.
Po zalogowaniu się trzeba uzupełnić następujące informacje:
- Nazwa aplikacji,
- Typ aplikacji – Server-side web application (for web apps or web APIs),
- Adres Portalu (np. https://webcon.com/WEBCONBPS),
- Adres powrotny – tu wymagane jest podanie adresu w postaci: <adres portalu>/powerbiredirect (np. https://webcon.com/WEBCONBPS/powerbiredirect).
Następnie wybieramy uprawnienia dostępu API i klikamy Register.
Po poprawnym zarejestrowaniu aplikacji otrzymamy identyfikator Application ID, który należy uzupełnić w Konfiguracji systemu WEBCON BPS.
Następnie w portalu Azure na stronie Authentication zarejestrowanej aplikacji konieczne jest aktywowanie opcji Access tokens (used for implicit flows) oraz ID tokens (used for implicit and hybrid flows). Dodatkowo należy zaznaczyć opcję Accounts in any organizational directory (Any Microsoft Entra ID tenant – Multitenant).
Prawidłowe działanie raportu Power BI wymaga również utworzenia nowej platformy typu Single-page application. W tym celu w sekcji Platform configurations wybierz Add a platform, a następnie dedykowaną opcję po prawej stronie, tak jak przedstawiono na rysunku poniżej.
W związku z tym, że dla nowo utworzonej aplikacji włączono ustawienia niejawnego przydzielania uprawnień, konieczna jest migracja adresów powrotnych URI. W tym celu w sekcji Web klikamy na strzałkę po prawej stronie wyświetlanego komunikatu i zaznaczamy pola wyboru obok dwóch adresów URI w dodatkowym oknie (patrz rysunek poniżej). Potwierdzamy konfigurację, wybierając przycisk Configure.
W następstwie tego działania wskazane adresy URI pojawią się w sekcji Single-page application.
Po wykonaniu wszystkich powyższych instrukcji i zapisaniu zmian w WEBCON BPS Designer Studio zalecane jest ponowne wczytanie konfiguracji.
Pełna instrukcja rejestracji aplikacji w Azure dostępna jest pod adresem: https://learn.microsoft.com/en-us/power-bi/developer/embedded/register-app.
Przykład użycia
Dodajmy teraz dowolny raport BI – na stronie głównej WEBCON BPS Portal przejdźmy do dowolnej aplikacji, na której dodamy nowy dashboard. W konfiguracji osadzamy nowy komponent o nazwie „Power BI”.
Podczas pierwszej konfiguracji (lub gdy token uwierzytelnienia wygaśnie) użytkownik zostanie poproszony o zalogowanie się do konta z dostępem do usługi Power BI. Po poprawnym zalogowaniu wyświetlone zostanie okno konfiguracji komponentu Power BI.
Od teraz wszyscy użytkownicy z dostępem do usługi Power BI mogą cieszyć się możliwościami, jakie dają dostępne w nim opcje, w zaciszu własnego Portalu 😉
