Samouczek: osadzanie zawartości usługi Power BI przy użyciu przykładowego osadzania dla aplikacji klientów

DOTYCZY: Aplikacja jest właścicielem danych Użytkownik jest właścicielem danych

Analiza osadzona i usługa Power BI Embedded (oferta platformy Azure) umożliwiają osadzanie zawartości usługi Power BI, takiej jak raporty, pulpity nawigacyjne i kafelki, do aplikacji.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

Aby korzystać z aplikacji, użytkownicy nie muszą logować się do usługi Power BI ani mieć licencji usługi Power BI.

Zalecamy użycie metody osadzania dla klientów w celu osadzenia zawartości usługi Power BI, jeśli jesteś niezależnym dostawcą oprogramowania (ISV) lub deweloperem, który chce tworzyć aplikacje dla innych firm.

Przykładowe specyfikacje kodu

Ten samouczek zawiera instrukcje dotyczące konfigurowania przykładowej aplikacji osadzania dla klientów w jednej z następujących platform:

• .NET Framework
• .NET Core
• Java
• Node JS
• Python

Przykłady kodu obsługują następujące przeglądarki:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Wymagania wstępne

Przed rozpoczęciem tego samouczka sprawdź, czy masz następujące zależności usługi Power BI i kodu:

• Zależności usługi Power BI

  • Twoja własna instancja Microsoft Entra.

  • Aby uwierzytelnić aplikację w usłudze Power BI, musisz wykonać jedną z następujących czynności:

    • Główna jednostka usługi - obiekt głównej jednostki usługi Microsoft Entra, który umożliwia usłudze Microsoft Entra ID uwierzytelnianie Twojej aplikacji.

    • Licencja usługi Power BI Pro — jest to użytkownik główny i aplikacja używa jej do uwierzytelniania w usłudze Power BI.

    • Licencja usługi Power BI Premium na użytkownika (PPU) — jest to użytkownik nadrzędny, a aplikacja wykorzystuje go do uwierzytelniania w usłudze Power BI.

    Uwaga

    Aby przejść do środowiska produkcyjnego, potrzebujesz zasobów.

• Zależności kodu

Metoda

Aby utworzyć aplikację osadzania przykładową dla klientów, wykonaj następujące kroki:

1. Wybierz metodę uwierzytelniania.

2. Zarejestruj aplikację Firmy Microsoft Entra.

3. Tworzenie obszaru roboczego usługi Power BI.

4. Tworzenie i publikowanie raportu usługi Power BI.

5. Pobierz wartości parametrów osadzania.

6. Dostęp do interfejsu API jednostki usługi

7. Włącz dostęp do obszaru roboczego.

8. Osadź zawartość.

Krok 1. Wybieranie metody uwierzytelniania

Rozwiązanie osadzone różni się w zależności od wybranej metody uwierzytelniania. Dlatego ważne jest, aby zrozumieć różnice między metodami uwierzytelniania i zdecydować, który najlepiej odpowiada Twojemu rozwiązaniu.

W poniższej tabeli opisano kilka kluczowych różnic między jednostką usługi i głównymi metodami uwierzytelniania użytkowników .

Krok 2. Rejestrowanie aplikacji Firmy Microsoft Entra

Zarejestrowanie aplikacji przy użyciu identyfikatora Entra firmy Microsoft umożliwia:

Aby zarejestrować aplikację w usłudze Microsoft Entra ID, postępuj zgodnie z instrukcjami w temacie Rejestrowanie aplikacji.

Krok 3. Tworzenie obszaru roboczego usługi Power BI

Usługa Microsoft Fabric przechowuje raporty, pulpity nawigacyjne i kafelki w obszarze roboczym. Aby osadzić te elementy, należy je utworzyć i przekazać do przestrzeni roboczej.

Aby utworzyć obszar roboczy, wykonaj następujące czynności:

1. Zaloguj się do Fabric.
2. Wybierz pozycję Obszary robocze.
3. Wybierz pozycję + Nowy obszar roboczy.
4. Nadaj obszarowi roboczemu nazwę i wybierz pozycję Zastosuj.

Krok 4. Tworzenie i publikowanie raportu usługi Power BI

Następnym krokiem jest utworzenie raportu i przesłanie go do przestrzeni roboczej. Możesz utworzyć własny raport przy użyciu programu Power BI Desktop, a następnie opublikować go w obszarze roboczym. Możesz też przesłać przykładowy raport do przestrzeni roboczej.

Aby pobrać przykładowy raport (nie włączono usługi Direct Lake) i opublikować go w obszarze roboczym, wykonaj następujące kroki:

1. Otwórz folder przykładów programu Power BI Desktop w usłudze GitHub.

2. Wybierz pozycję Kod , a następnie wybierz pozycję Pobierz plik ZIP.

   

3. Wyodrębnij pobrany plik ZIP i przejdź do folderu Przykładowe raporty .

4. Wybierz raport, który chcesz osadzić, i opublikuj go w obszarze roboczym.

Krok 5. Pobieranie wartości parametrów osadzania

Aby osadzić zawartość, należy uzyskać określone wartości parametrów. W poniższej tabeli przedstawiono wymagane wartości i wskazuje, czy mają zastosowanie do metody uwierzytelniania jednostki usługi, metody uwierzytelniania użytkownika głównego lub obu tych metod.

Przed osadzeniem zawartości upewnij się, że masz wszystkie wartości wymienione poniżej. Niektóre wartości mogą się różnić w zależności od używanej metody uwierzytelniania.

Parametr	Jednostka usługi	Użytkownik główny
identyfikator klienta
Identyfikator obszaru roboczego
Identyfikator raportu
Klucz tajny klienta
Identyfikator klienta		wymagane tylko dla środowiska Node JS
Nazwa użytkownika usługi Power BI
Hasło usługi Power BI

ID klienta

Aby uzyskać identyfikator GUID klienta (znany również jako identyfikator aplikacji), wykonaj następujące kroki:

1. Zaloguj się do platformy Microsoft Azure.

2. Wyszukaj Rejestracje aplikacji i wybierz link Rejestracje aplikacji.

3. Wybierz aplikację Microsoft Entra używaną do osadzania zawartości usługi Power BI.

4. W sekcji Przegląd skopiuj GUID identyfikatora aplikacji (klienta).

Identyfikator obszaru roboczego

Aby uzyskać identyfikator GUID obszaru roboczego, wykonaj następujące kroki:

1. Zaloguj się w usłudze Power BI.

2. Otwórz raport, który chcesz osadzić.

3. Skopiuj identyfikator GUID z adresu URL. Identyfikator GUID jest liczbą między /groups/ i /reports/.

   

Alternatywnie identyfikator obszaru roboczego można znaleźć w ustawieniach portalu administracyjnego, wybierając pozycję Szczegóły obok nazwy obszaru roboczego.

Identyfikator raportu

Aby uzyskać GUID raportu, wykonaj następujące kroki:

1. Zaloguj się w usłudze Power BI.

2. Otwórz raport, który chcesz osadzić.

3. Skopiuj identyfikator GUID z adresu URL. Identyfikator GUID jest liczbą między /reports/ i /ReportSection.

   

Tajemnica klienta

Aby uzyskać klucz tajny klienta, wykonaj następujące kroki:

1. Zaloguj się do platformy Microsoft Azure.

2. Wyszukaj Rejestracje aplikacji i wybierz link Rejestracje aplikacji.

3. Wybierz aplikację Microsoft Entra używaną do osadzania zawartości usługi Power BI.

4. W obszarze Zarządzanie wybierz pozycję Certyfikaty i wpisy tajne.

5. W obszarze Tajne klienta wybierz pozycję Nowy tajny klienta.

6. W oknie podręcznym Dodawanie wpisu tajnego klienta podaj opis wpisu tajnego aplikacji, wybierz, kiedy wpis tajny aplikacji wygaśnie, a następnie wybierz pozycję Dodaj.

7. W sekcji Wpisy tajne klienta skopiuj ciąg w kolumnie Wartość nowo utworzonego wpisu tajnego aplikacji. Wartość tajnego kodu klienta to identyfikator klienta.

Identyfikator dzierżawy

Aby uzyskać identyfikator dzierżawy (GUID), wykonaj następujące kroki:

1. Zaloguj się do platformy Microsoft Azure.

2. Wyszukaj Rejestracje aplikacji i wybierz link Rejestracje aplikacji.

3. Wybierz aplikację Microsoft Entra używaną do osadzania zawartości usługi Power BI.

4. W sekcji Przegląd skopiuj identyfikator GUID katalogu (dzierżawcy).

Nazwa użytkownika i hasło usługi Power BI

Uzyskaj nazwę użytkownika i hasło użytkownika usługi Power BI, którego używasz jako użytkownik główny. Jest to ten sam użytkownik, którego użyto do utworzenia obszaru roboczego i przekazania raportu do usługa Power BI.

Krok 6. Dostęp do interfejsu API jednostki usługi

Aby aplikacja Firmy Microsoft Entra mogła uzyskiwać dostęp do zawartości i interfejsów API usługi Power BI, administrator usługi Power BI musi włączyć dostęp jednostki usługi w portalu administracyjnym usługi Power BI. Jeśli nie jesteś administratorem swojej dzierżawy, skontaktuj się z administratorem dzierżawy, aby ten włączył ustawienia dzierżawy dla ciebie.

1. W usłudze Power BI wybierz Ustawienia>Ustawienia>Portal administracyjny.

   

2. Wybierz Ustawienia dzierżawy, a następnie przewiń w dół do sekcji Ustawienia dewelopera.

3. Rozwiń Jednostki usługi mogą używać Fabric APIs i włącz tę opcję.

   

Krok 7. Włączanie dostępu do obszaru roboczego

Aby włączyć dostęp aplikacji Microsoft Entra do obiektów, takich jak raporty, pulpity nawigacyjne i modele semantyczne w usłudze Power BI, dodaj service principal lub użytkownika głównego jako członka lub administratora do obszaru roboczego.

1. Zaloguj się do Fabric.

2. Przewiń do obszaru roboczego, dla którego chcesz włączyć dostęp, a następnie wybierz pozycję Zarządzaj dostępem.

   

3. W okienku Dostęp, w zależności od używanej metody uwierzytelniania, skopiuj główną jednostkę usługi lub użytkownika głównego do pola tekstowego Wprowadź adres e-mail.

   Uwaga

   Jeśli używasz identyfikatora usługi, jego nazwa to nazwa nadana aplikacji Microsoft Entra.

4. Wybierz Dodaj.

Krok 8. Osadzanie zawartości

Przykładowa aplikacja wbudowana w Power BI umożliwia utworzenie osadzenia aplikacji Power BI dla klientów.

Wykonaj następujące kroki, aby zmodyfikować przykładową aplikację osadzania dla klientów , aby osadzić raport usługi Power BI.

1. Otwórz folder przykłady dla deweloperów usługi Power BI.

2. Wybierz pozycję Kod , a następnie wybierz pozycję Pobierz plik ZIP.

   

3. Wyodrębnij pobrany plik ZIP i przejdź do folderu PowerBI-Developer-Samples-master .

4. W zależności od języka, którego aplikacja ma używać, otwórz jeden z następujących folderów:

   • .NET Core
   • .NET Framework
   • Java
   • Node JS
   • Python

   Uwaga

   Przykładowe aplikacje wbudowane dla klientów obsługują tylko struktury wymienione powyżej. Przykładowa aplikacja React obsługuje tylko osadzanie dla rozwiązania organizacji.

5. Otwórz folder Osadź dla klientów.

Tworzenie aplikacji

Po skonfigurowaniu i uruchomieniu przykładowej aplikacji osadzania dla klientów możesz rozpocząć tworzenie własnej aplikacji.

Wypróbuj plac zabaw analiz wbudowanych Power BI, aby rozpocząć tworzenie i być na bieżąco z wszystkimi nowymi funkcjami i aktualizacjami usługi Power BI Embedded.

Gdy wszystko będzie gotowe, zapoznaj się z wymaganiami dotyczącymi przenoszenia do środowiska produkcyjnego . Potrzebujesz również pojemności i należy zapoznać się z artykułem dotyczącym planowania pojemności, aby ustalić, która jednostka SKU najlepiej odpowiada Twoim potrzebom.

Zagadnienia i ograniczenia

Obowiązują następujące ograniczenia dotyczące trybu Direct Lake:

• Wymaga tokenu osadzania V2.
• Jeśli używasz głównej jednostki usługi, potrzebujesz połączenia Fixed Identity (No-SSO).
• Obecnie ustawienie jednostki usługi jako metody uwierzytelnienia w połączeniu o nazwie Fixed Identity jest jedyną opcją obsługiwaną przez automatyzację. Inne metody są obsługiwane ręcznie za pośrednictwem portalu.

Powiązana zawartość

• Przenoszenie do środowiska produkcyjnego
• Osadź dla swojej organizacji
• Osadzanie raportów podzielonych na strony

Masz więcej pytań? Zapytaj Społeczność usługi Power BI.