Najpierw musisz wiedzieć, że istnieją dwa tryby osadzania usługi Power BI — user owns data
a app owns data
. W pierwszym trybie, podczas osadzania, użytkownik uwierzytelni się przy użyciu własnego konta Power BI Pro, tzn. każdy z użytkowników potrzebuje licencji Power BI Pro. W przypadku późniejszego potrzebujesz tylko jednego „konta głównego”, które będzie używane do uwierzytelniania. Różnice w implementacji nie są ogromne, więc opiszę app owns data
.
Musisz wykonać następujące czynności:
-
Zarejestruj aplikację - przejdź do dev.powerbi.com/apps i zarejestruj natywną aplikację. Wybierz uprawnienia, które chcesz przyznać (jeśli nie jesteś pewien, w pierwszych testach po prostu przyznaj je wszystkie). Skopiuj przewodnik — to jest identyfikator aplikacji, czyli identyfikator klienta.
-
Następnym krokiem jest uwierzytelnienie z aplikacji i uzyskanie tokena dostępu. Użyj Biblioteki uwierzytelniania usługi Azure Active Directory ( ADAL) w tym celu - wywołaj niektóre z
acquireToken
metodyAuthenticationContext
klasa. -
Użyj tego tokenu dostępu, aby wywołać interfejs API REST usługi Power BI i uzyskać
embedUrl
elementu, który chcesz osadzić, np. raport . -
Użyj klienta Power BI JavaScript faktycznie osadzić ten element. Musisz zainicjować jedną klasę konfiguracji osadzania i przekazać informacje o typie elementu (raport, dashboard, kafelek), gdzie go znaleźć (embedUrl), uwierzytelnianiu (token dostępu), niektórych innych opcjach konfiguracyjnych (pokaż lub ukryj panel filtrów, nawigacja itp.), filtrach do zastosowania oraz wkrótce. Jeśli będziesz korzystać z otrzymanego powyżej tokena dostępu, ustaw
tokenType
byćAAD
. Ten token ma wiele uprawnień, więc ze względów bezpieczeństwa możesz użyćEmbed
zamiast tokena. W takim przypadku użyj tokena dostępu, aby ponownie wywołać interfejs API REST (np. Raporty GenerujTokenInGroup ). -
Zadzwoń na
powerbi.embed
metoda klienta JavaScript przekazuje osadzoną konfigurację, aby zwizualizować ten element Power BI w Twojej aplikacji.
Oto kilka zasobów, które powinieneś przeczytać:
- Samouczek:osadzanie mocy Zawartość BI w aplikacji dla Twoich klientów
- Samouczek:Osadź zawartość usługi Power BI w aplikacji dla swojej organizacji
- Podstawy osadzania
- Wbudowany plac zabaw usługi Power BI
- Przykłady dla programistów PowerBI