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:

• Konfigurowanie środowiska osadzonego.
• Skonfiguruj przykładową aplikację osadzania dla klientów (znaną również jako aplikacja jest właścicielem danych).

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.

Ważne

Jeśli osadzasz zawartość dla chmury krajowej/regionalnej, kilka pierwszych kroków tego samouczka jest różnych. Aby uzyskać szczegółowe informacje, zobacz Osadzanie zawartości dla chmur krajowych/regionalnych.

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 dzierżawa firmy Microsoft Entra.

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

    • Jednostka usługi — obiekt jednostki usługi Entra firmy Microsoft, który umożliwia usłudze Microsoft Entra ID uwierzytelnianie 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 główny i aplikacja używa jej do uwierzytelniania w usłudze Power BI.

    Uwaga

    Aby przejść do środowiska produkcyjnego, potrzebujesz pojemności.

• Zależności kodu

.NET Core

• Zestaw .NET Core 3.1 SDK (lub nowszy)

• Zintegrowane środowisko projektowe (IDE). Zalecamy użycie jednego z następujących środowisk:

  • Program Visual Studio

  • Visual Studio Code

.NET Framework

• .NET Framework 4.8

• Program Visual Studio

Java

• JDK (lub JRE)

• Eclipse IDE — sprawdź, czy masz środowisko Eclipse dla deweloperów języka Java EE (wersja enterprise)

• Dystrybucje binarne apache Tomcat

Node JS

• Node.js

• Zintegrowane środowisko projektowe (IDE). Zalecamy użycie jednego z następujących środowisk:

  • Program Visual Studio

  • Visual Studio Code

Python

• Python 3 (lub nowszy)

  Uwaga

  • Jeśli instalujesz język Python po raz pierwszy, wybierz opcję Dodaj język Python do ŚCIEŻKI , aby dodać instalację do zmiennej PATH .
  • Jeśli masz już zainstalowany język Python , sprawdź, czy zmienna PATH zawiera jego ścieżkę instalacji. Aby uzyskać więcej informacji, zobacz dokumentację Excursus: Setting environment variables Python (ten link dotyczy języka Python 3).

• Zintegrowane środowisko projektowe (IDE). Zalecamy użycie jednego z następujących środowisk:

  • Program Visual Studio

  • Visual Studio Code

Method

Aby utworzyć przykładową aplikację osadzania 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 .

Kwestie wymagające rozważenia	Jednostka usługi	Użytkownik główny
Mechanizm	Obiekt jednostki usługi aplikacji Microsoft Entra umożliwia usłudze Microsoft Entra ID uwierzytelnianie osadzonej aplikacji rozwiązania w usłudze Power BI.	Aplikacja Microsoft Entra używa poświadczeń (nazwy użytkownika i hasła) użytkownika usługi Power BI do uwierzytelniania w usłudze Power BI.
Zabezpieczenia	Jednostka usługi to zalecana metoda autoryzacji identyfikatora Entra firmy Microsoft. Jeśli używasz jednostki usługi, możesz uwierzytelnić się przy użyciu wpisu tajnego aplikacji lub certyfikatu. W tym samouczku opisano tylko używanie jednostki usługi z wpisem tajnym aplikacji. Aby osadzić przy użyciu jednostki usługi i certyfikatu, zapoznaj się z artykułem dotyczącym jednostki usługi z certyfikatem.	Ta metoda uwierzytelniania nie jest tak bezpieczna jak jednostka usługi. Musisz być czujny przy użyciu poświadczeń użytkownika głównego (nazwy użytkownika i hasła). Na przykład nie ujawniaj ich w aplikacji osadzania i często zmieniaj hasło.
Delegowane uprawnienia identyfikatora Entra firmy Microsoft	Niewymagane.	Użytkownik główny lub administrator musi wyrazić zgodę na dostęp aplikacji do uprawnień interfejsu API REST usługi Power BI (nazywanych również zakresami). Na przykład Report.ReadWrite.All.
usługa Power BI dostęp	Nie można uzyskać dostępu do usługa Power BI za pomocą jednostki usługi.	Dostęp do usługa Power BI można uzyskać przy użyciu poświadczeń użytkownika głównego.
Licencja	Nie wymaga licencji Pro. Możesz użyć zawartości z dowolnego obszaru roboczego, którego jesteś członkiem lub administratorem.	Wymaga licencji usługi Power BI Pro lub Premium na użytkownika (PPU).

Krok 2. Rejestrowanie aplikacji Firmy Microsoft Entra

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

• Ustanawianie tożsamości dla aplikacji
• Zezwalanie aplikacji na dostęp do interfejsów API REST usługi Power BI
• Jeśli używasz użytkownika głównego — określ uprawnienia REST aplikacji usługi Power BI

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

Uwaga

Przed zarejestrowaniem aplikacji należy zdecydować, która metoda uwierzytelniania ma być używana, jednostka usługi lub użytkownik główny.

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 obszaru roboczego.

Napiwek

Jeśli masz już obszar roboczy, możesz pominąć ten krok.

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

1. Zaloguj się do sieci szkieletowej.

2. Wybierz pozycję Obszary robocze.

3. Wybierz pozycję + Nowy obszar roboczy.

4. Nadaj obszarowi roboczemu nazwę i wybierz pozycję Zapisz.

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

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

Napiwek

Jeśli masz już obszar roboczy z raportem, możesz pominąć ten krok.

Aby pobrać przykładowy raport 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 Samples Reports .

4. Wybierz raport do osadzenia 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
Client ID
Identyfikator obszaru roboczego
Identyfikator raportu
Klucz tajny klienta
Identyfikator dzierżawy		wymagane tylko dla środowiska Node JS
Nazwa użytkownika usługi Power BI
Hasło usługi Power BI

Client ID

Napiwek

Dotyczy: Użytkownik główny jednostki usługi

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 identyfikator GUID identyfikatora aplikacji (klienta).

Identyfikator obszaru roboczego

Napiwek

Dotyczy: Użytkownik główny jednostki usługi

Aby uzyskać identyfikator GUID identyfikatora 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

Napiwek

Dotyczy: Użytkownik główny jednostki usługi

Aby uzyskać identyfikator GUID identyfikatora 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.

   

Klucz tajny klienta

Napiwek

Dotyczy: Użytkownik główny jednostki usługi

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 Wpisy tajne klienta wybierz pozycję Nowy klucz 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ść wpisu tajnego klienta to identyfikator klienta.

Uwaga

Pamiętaj, aby skopiować wartość wpisu tajnego klienta po jej pierwszym wyświetleniu. Po odejściu od tej strony wpis tajny klienta zostanie ukryty i nie będzie można pobrać jej wartości.

Identyfikator dzierżawy

Napiwek

Dotyczy: Użytkownik główny jednostki usługi

Aby uzyskać identyfikator GUID identyfikatora dzierżawy, 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 identyfikatora katalogu (dzierżawy).

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

Napiwek

Dotyczy: Użytkownik główny jednostki usługi

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

Napiwek

Dotyczy: Użytkownik główny jednostki usługi

Ten krok jest istotny tylko wtedy, gdy używasz metody uwierzytelniania jednostki usługi. Jeśli używasz użytkownika głównego, pomiń ten krok i przejdź do kroku 7 — Włączanie dostępu do obszaru roboczego.

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 dzierżawy, pobierz administratora dzierżawy, aby włączyć ustawienia dzierżawy.

1. W usługa Power BI wybierz pozycję Ustawienia>Portal administracyjny ustawień.>

   

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

3. Rozwiń węzeł Jednostki usługi mogą używać interfejsów API sieci szkieletowej i włączyć tę opcję.

   

Uwaga

W przypadku korzystania z jednostki usługi zaleca się ograniczenie dostępu do ustawień dzierżawy przy użyciu grupy zabezpieczeń. Aby dowiedzieć się więcej na temat tej funkcji, zobacz następujące sekcje w artykule dotyczącym jednostki usługi:

• Tworzenie grupy zabezpieczeń entra firmy Microsoft
• Włączanie ustawień administratora usługa Power BI

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

Aby włączyć obiekty dostępu do aplikacji Microsoft Entra, takie jak raporty, pulpity nawigacyjne i modele semantyczne w usługa Power BI, dodaj jednostkę usługi lub użytkownika głównego jako członek lub administrator do obszaru roboczego.

1. Zaloguj się do sieci szkieletowej.

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 jednostkę usługi lub użytkownika głównego do pola tekstowego Wprowadź adres e-mail.

   Uwaga

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

4. Wybierz Dodaj.

Krok 8. Osadzanie zawartości

Przykładowa aplikacja usługi Power BI embedded umożliwia utworzenie osadzania dla klientów aplikacji Power BI.

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 osadzania 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 Osadzanie dla klientów .

.NET Core

6. Otwórz przykładową aplikację osadzania dla klientów przy użyciu jednej z następujących metod:

   • Jeśli używasz programu Visual Studio, otwórz plik AppOwnsData.sln .

   • Jeśli używasz programu Visual Studio Code, otwórz folder AppOwnsData .

7. Otwórz appsettings.json.

8. W zależności od metody uwierzytelniania wprowadź następujące wartości parametrów:

   Parametr	Jednostka usługi	Użytkownik główny
   AuthenticationMode	ServicePrincipal	Użytkownik główny
   ClientId	Identyfikator klienta aplikacji Entra firmy Microsoft	Identyfikator klienta aplikacji Entra firmy Microsoft
   TenantId	Identyfikator dzierżawy usługi Microsoft Entra	Brak
   PbiUsername	Brak	Nazwa użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
   PbiPassword	Nie dotyczy	Hasło użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
   ClientSecret	Wpis tajny klienta microsoft Entra ID	Nie dotyczy
   WorkspaceId	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego
   ReportId	Identyfikator osadzanego raportu, zobacz Identyfikator raportu	Identyfikator osadzanego raportu, zobacz Identyfikator raportu

9. Uruchom projekt, wybierając odpowiednią opcję:

   • Jeśli używasz programu Visual Studio, wybierz pozycję IIS Express (odtwórz).

   • Jeśli używasz programu Visual Studio Code, wybierz pozycję Uruchom debugowanie>.

.NET Framework

6. Za pomocą programu Visual Studio otwórz plik AppOwnsData.sln .

7. Otwórz plik Web.config.

8. W zależności od metody uwierzytelniania wprowadź następujące wartości parametrów:

   Parametr	Jednostka usługi	Użytkownik główny
   authenticationType	ServicePrincipal	Użytkownik główny
   applicationId	Identyfikator klienta aplikacji Entra firmy Microsoft	Identyfikator klienta aplikacji Entra firmy Microsoft
   workspaceId	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego
   reportId	Identyfikator osadzanego raportu, zobacz Identyfikator raportu	Identyfikator osadzanego raportu, zobacz Identyfikator raportu
   pbiUsername	Nie dotyczy	Nazwa użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
   pbiPassword	Nie dotyczy	Hasło użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
   applicationSecret	Wpis tajny klienta microsoft Entra ID	Nie dotyczy
   tenant	Identyfikator dzierżawy usługi Microsoft Entra	Nie dotyczy

9. Uruchom projekt, wybierając pozycję IIS Express (odtwórz).

Java

6. Otwórz środowisko Eclipse i postępuj zgodnie z instrukcjami opisanymi poniżej.

   Uwaga

   Instrukcje dotyczące przykładowej aplikacji osadzania w języku Java dla klientów można znaleźć w temacie Eclipse IDE for Java EE Developers (enterprise edition). Jeśli używasz innej aplikacji, musisz skonfigurować ją samodzielnie.

7. Dodaj serwer Tomcat do środowiska Eclipse:

   a. Wybierz pozycję Okno>Pokaż serwery widoku.>

   b. Na karcie Serwery wybierz pozycję Brak dostępnych serwerów. Kliknij ten link, aby utworzyć nowy serwer.

   c. W oknie Definiowanie nowego serwera rozwiń węzeł Apache i wybierz serwer Tomcat, który jest uruchomiony na maszynie. Na przykład serwer Tomcat v9.0.

   d. Wybierz Dalej.

   e. W oknie Serwer Tomcat wybierz pozycję Przeglądaj i przejdź do folderu zawierającego serwer Tomcat.

   f. W oknie Serwer Tomcat wybierz pozycję Zainstalowane środowiska JRE.

   g. W oknie Zainstalowane środowiska JRE wybierz dostępne środowisko jre, a następnie wybierz pozycję Zastosuj i zamknij.

   h. W oknie Serwer Tomcat wybierz pozycję Zakończ. Serwer Tomcat można wyświetlić na karcie Serwery .

8. Otwórz projekt w środowisku Eclipse:

   Ważne

   Środowisko Eclipse może napotkać problemy, jeśli nazwa ścieżki jest za długa. Aby uniknąć tego problemu, sprawdź, czy folder przykładowej aplikacji nie jest zbyt głęboko zagnieżdżony w strukturze folderów maszyny.

   a. Wybierz pozycję Plik , a następnie wybierz pozycję Otwórz projekty z systemu plików.

   b. W oknie Importuj projekty z systemu plików lub Archiwum wybierz pozycję Katalog i otwórz folder AppOwnsData .

   c. Wybierz Zakończ.

9. Dodaj serwer Tomcat do projektu:

   a. W okienku Eksplorator pakietów kliknij prawym przyciskiem myszy pozycję AppOwnsData i wybierz pozycję Właściwości.

   b. W oknie Właściwości elementu AppOwnsData wybierz pozycję Docelowe środowiska uruchomieniowe, a następnie wybierz pozycję Apache Tomcat. Ten wybór obejmuje używaną wersję serwera Apache Tomcat , na przykład Apache Tomcat v9.0.

   c. Wybierz pozycję Zastosuj i zamknij.

10. Wypełnij wymagane parametry

    a. W Eksploratorze pakietów rozwiń projekt AppOwnsData.

    b. Rozwiń węzeł Zasoby języka Java.

    c. Rozwiń węzeł src.

    d. Rozwiń węzeł com.embedsample.appoensdata.config.

    e. Otwórz Config.java.

    f. W zależności od metody uwierzytelniania wprowadź następujące wartości parametrów:

    Parametr	Jednostka usługi	Użytkownik główny
    authenticationType	ServicePrincipal	Użytkownik główny
    workspaceId	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego
    reportId	Identyfikator osadzanego raportu, zobacz Identyfikator raportu	Identyfikator osadzanego raportu, zobacz Identyfikator raportu
    clientId	Identyfikator klienta aplikacji Entra firmy Microsoft	Identyfikator klienta aplikacji Entra firmy Microsoft
    pbiUsername	Nie dotyczy	Nazwa użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
    pbiPassword	Nie dotyczy	Hasło użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
    tenantId	Identyfikator dzierżawy usługi Microsoft Entra	Nie dotyczy
    appSecret	Wpis tajny klienta microsoft Entra ID	Nie dotyczy

11. Uruchamianie projektu

    a. W Eksploratorze pakietów kliknij prawym przyciskiem myszy pozycję AppOwnesData.

    b. Wybierz pozycję Uruchom jako>na serwerze.

    c. W oknie Uruchom na serwerze wybierz pozycję Wybierz istniejący serwer i wybierz serwer Tomcat.

    d. Wybierz Zakończ.

Node JS

6. Otwórz folder App Owns Data przy użyciu preferowanego środowiska IDE. Zalecamy użycie jednej z następujących opcji:

   • Program Visual Studio

   • Visual Studio Code

7. Otwórz terminal i zainstaluj wymagane zależności, wykonując następujące polecenie: npm install.

8. Rozwiń folder Config i otwórz config.json.

9. W zależności od metody uwierzytelniania wprowadź następujące wartości parametrów:

   Parametr	Jednostka usługi	Użytkownik główny
   authenticationMode	ServicePrincipal	Użytkownik główny
   clientId	Identyfikator klienta aplikacji Entra firmy Microsoft	Identyfikator klienta aplikacji Entra firmy Microsoft
   workspaceId	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego
   reportId	Identyfikator osadzanego raportu, zobacz Identyfikator raportu	Identyfikator osadzanego raportu, zobacz Identyfikator raportu
   pbiUsername	Nie dotyczy	Nazwa użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
   pbiPassword	Nie dotyczy	Hasło użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
   clientSecret	Wpis tajny klienta microsoft Entra ID	Nie dotyczy
   tenantId	Identyfikator dzierżawy usługi Microsoft Entra	Identyfikator dzierżawy usługi Microsoft Entra

10. Uruchom projekt, wykonując następujące czynności:

    a. W terminalu środowiska IDE wykonaj polecenie npm start.

    b. Otwórz nową kartę w przeglądarce i przejdź do http://localhost:5300adresu .

Python

6. Otwórz program PowerShell lub wiersz polecenia.

7. Sprawdź, czy znajdujesz się w folderze Osadzanie języka Python>dla klientów, a plik requirements.txt znajduje się w folderze i uruchom polecenie .pip3 install -r requirements.txt

8. Otwórz folder App Owns Data przy użyciu preferowanego środowiska IDE. Zalecamy użycie jednego z następujących środowisk:

   • Program Visual Studio

   • Visual Studio Code

9. Otwórz config.py.

10. W zależności od metody uwierzytelniania wprowadź następujące wartości parametrów:

    Parametr	Jednostka usługi	Użytkownik główny
    AUTHENTICATION_MODE	ServicePrincipal	Użytkownik główny
    WORKSPACE_ID	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego	Identyfikator obszaru roboczego z osadzonym raportem, zobacz Identyfikator obszaru roboczego
    REPORT_ID	Identyfikator osadzanego raportu, zobacz Identyfikator raportu	Identyfikator osadzanego raportu, zobacz Identyfikator raportu
    TENANT_ID	Identyfikator dzierżawy usługi Microsoft Entra	Nie dotyczy
    CLIENT_ID	Identyfikator klienta aplikacji Entra firmy Microsoft	Identyfikator klienta aplikacji Entra firmy Microsoft
    CLIENT_SECRET	Wpis tajny klienta microsoft Entra ID	Brak
    POWER_BI_USER	Brak	Nazwa użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI
    POWER_BI_PASS	Nie dotyczy	Hasło użytkownika głównego— zobacz Nazwa użytkownika i hasło usługi Power BI

11. Zapisz plik.

12. Uruchom projekt, wykonując następujące czynności:

    a. W programie PowerShell lub wierszu polecenia przejdź do folderu Osadzanie języka Python>dla klientów>AppOwnesData i wykonaj polecenie .flask run

    b. Otwórz nową kartę w przeglądarce i przejdź do http://localhost:5000adresu .

Tworzenie aplikacji

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

Wypróbuj osadzony plac zabaw dla analizy usługi Power BI, aby rozpocząć opracowywanie i nadążać za 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.

Ważne

Jeśli do programowania użyto bezpłatnych tokenów osadzania wersji próbnej, musisz kupić pojemność dla środowiska produkcyjnego. Do momentu zakupu pojemności baner Wersji bezpłatnej wersji próbnej będzie nadal wyświetlany w górnej części osadzonego raportu.

Powiązana zawartość

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

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