Konfigurowanie osadzania w Microsoft Fabric dla elementów pulpitu nawigacyjnego czasu rzeczywistego

Skonfiguruj Microsoft Fabric Embed przed osadzeniem elementu pulpitu nawigacyjnego Real-Time w aplikacji internetowej napisanej w JavaScript lub TypeScript. Należy mieć obszar roboczy przypisany do pojemności Microsoft Fabric, dostęp użytkownika do elementu pulpitu nawigacyjnego Real-Time, rejestrację aplikacji Microsoft Entra ID z delegowanymi uprawnieniami i lokalnymi narzędziami programistycznymi.

Microsoft Fabric Embed to funkcja publicznej wersji zapoznawczej do osadzania obsługiwanych elementów Microsoft Fabric.

Uwaga / Notatka

Microsoft Fabric Embed jest dostępny w publicznej wersji zapoznawczej. Aby uzyskać informacje o obsługiwanych typach elementów, uwierzytelnianiu i ograniczeniach umowy wersji zapoznawczej, zobacz Ograniczenia usługi Microsoft Fabric Embed.

Wymagania wstępne dotyczące konfiguracji osadzania Microsoft Fabric

Aby wyświetlić listę wymagań wstępnych, zobacz Czego potrzebuję, aby korzystać z osadzania w usłudze Microsoft Fabric?

Konfigurowanie obszaru roboczego Fabric

Microsoft Fabric Embed obsługuje delegowany dostęp użytkowników. Zalogowany użytkownik usługi Microsoft Entra ID musi móc otworzyć element Real-Time Dashboard w usłudze Microsoft Fabric, zanim ten sam element będzie mógł być wyświetlany w aplikacji osadzonej.

  1. Otwórz Microsoft Fabric.
  2. Otwórz obszar roboczy zawierający element Real-Time Dashboard.
  3. Upewnij się, że obszar roboczy jest przypisany do aktywnej pojemności Microsoft Fabric.
  4. Upewnij się, że użytkownicy wyświetlający osadzony element Real-Time Dashboard mają uprawnienia Przeglądający lub wyższe do obszaru roboczego i samego elementu Real-Time Dashboard.

Weryfikacja zakończona powodzeniem: obszar roboczy wyświetla aktywne przypisanie do zasobu mocy obliczeniowej, a użytkownik może bezpośrednio otworzyć element Dashboard czasu rzeczywistego w portalu Microsoft Fabric.

Zrzut ekranu przedstawiający obszar roboczy z pulpitem nawigacyjnym Real-Time.

Ważna

Jeśli zalogowany użytkownik nie ma dostępu do obszaru roboczego lub elementu pulpitu nawigacyjnego Real-Time w Microsoft Fabric, Microsoft Fabric Embed nie renderuje elementu w osadzonej aplikacji.

Rejestrowanie aplikacji Microsoft Entra ID na potrzeby logowania użytkownika

Twoja aplikacja JavaScript lub TypeScript wymaga rejestracji aplikacji Microsoft Entra ID, aby umożliwić użytkownikom logowanie i żądać tokenów dostępu delegowanego na potrzeby osadzania Microsoft Fabric.

  1. Zaloguj się do portalu Azure.

  2. Wybierz dzierżawcę Microsoft Entra, wybierając swoje konto w prawym górnym rogu strony.

  3. Wybierz pozycję Rejestracje aplikacji. Jeśli ta opcja nie jest widoczna, wyszukaj ją.

  4. W Rejestracje aplikacji wybierz pozycję Nowa rejestracja.

  5. Wypełnij następujące pola:

    • Nazwa — nadaj aplikacji nazwę.
    • Obsługiwany typ konta — wybierz, kto może korzystać z aplikacji. Wybierz Konta tylko w tym katalogu organizacyjnym dla aplikacji jednotenantowych lub Konta w dowolnym katalogu organizacyjnym dla scenariuszy międzydzierżawowych.
  6. (Opcjonalnie) W polu Identyfikator URI przekierowania dodaj adres URL przekierowania.

  7. Wybierz opcję Zarejestruj. Po zarejestrowaniu aplikacji zostanie wyświetlona strona przeglądu aplikacji, na której można uzyskać identyfikator aplikacji. Skopiuj i zapisz identyfikator aplikacji oraz wszystkie informacje w polu Podsumowanie do późniejszego użycia. Środowisko osadzania Microsoft Fabric jest gotowe do użycia. Zrzut ekranu przedstawiający rejestrację nowej aplikacji w Entra ID.

Weryfikacja powodzenia: na stronie przeglądu rejestracji aplikacji są wyświetlane identyfikator klienta i identyfikator dzierżawy, których aplikacja używa do uwierzytelniania za pomocą biblioteki Microsoft Authentication Library (MSAL).

Uwaga / Notatka

Zachowaj te wartości dostępne. Są one używane podczas konfigurowania uwierzytelniania w aplikacji.

Dodaj delegowane uprawnienia interfejsu API dla Microsoft Fabric Embed

Aplikacja musi zażądać delegowanych uprawnień interfejsu API do osadzania w usłudze Fabric, dostępu do odczytu elementów oraz opcjonalnego wykrywania obszarów roboczych. Użyj delegowanych uprawnień użytkownika na potrzeby osadzania w Microsoft Fabric.

  1. W rejestracji aplikacji otwórz uprawnienia interfejsu API.

  2. Wybierz pozycję Dodaj uprawnienie.

  3. Dodaj delegowane uprawnienia zgodne ze swoim scenariuszem.

  4. Jeśli Twoja organizacja wymaga zgody administratora, poproś administratora dzierżawy o udzielenie zgody.

    Zrzut ekranu przedstawiający uprawnienia interfejsu API.

Uwaga / Notatka

Poproś o uprawnienia delegowane o najmniejszym wymaganym zakresie dla swojego scenariusza:

Uprawnienie Kiedy należy go używać Purpose
Fabric.Embed Wymagane dla Microsoft Fabric Embed. Umożliwia aplikacji osadzanie obsługiwanych elementów Microsoft Fabric.
KQLDashboard.Read.All Preferowane uprawnienie do odczytu dla elementów pulpitu nawigacyjnego Real-Time. Umożliwia aplikacji odczytywanie elementów pulpitu nawigacyjnego Real-Time, do których może uzyskiwać dostęp zalogowany użytkownik.
Item.Read.All Użyj tylko wtedy, gdy scenariusz wymaga szerszego dostępu do odczytu elementu Fabric. Umożliwia aplikacji odczytywanie elementów usługi Fabric, do których zalogowany użytkownik ma dostęp.
Workspace.Read.All Wymagane tylko wtedy, gdy aplikacja używa interfejsów API REST Microsoft Fabric do odnajdywania identyfikatorów obszarów roboczych lub elementów. Umożliwia zalogowanemu użytkownikowi wykrywanie obszarów roboczych w trybie tylko do odczytu.

Weryfikacja powodzenia: rejestracja aplikacji obejmuje Fabric.Embed, uprawnienie do odczytu pojedynczego elementu oraz Workspace.Read.All tylko wtedy, gdy aplikacja używa interfejsów API REST usługi Microsoft Fabric do wykrywania identyfikatorów.

Instalowanie lokalnych narzędzi programistycznych dla aplikacji internetowej

Zainstaluj następujące narzędzia i biblioteki dla aplikacji JavaScript lub TypeScript, która hostuje osadzony element pulpitu nawigacyjnego Real-Time:

Zainstaluj pakiet SDK Fabric Embed w aplikacji internetowej

Zainstaluj pakiet Fabric Embed SDK w publicznej wersji zapoznawczej w aplikacji internetowej, która hostuje osadzony element pulpitu nawigacyjnego czasu rzeczywistego. Nazwa i wersja pakietu mogą ulec zmianie podczas korzystania z wersji zapoznawczej. Użyj nazwy pakietu udostępnionej w wersji zapoznawczej.

npm install @microsoft/fabric-embed

Sprawdzenie poprawności: pakiet SDK Fabric Embed widnieje w zależnościach aplikacji package.json.

Zbieranie identyfikatorów obszarów roboczych i pulpitów nawigacyjnych Real-Time

Identyfikator obszaru roboczego i identyfikator elementu pulpitu nawigacyjnego Real-Time można również zbierać programowo przy użyciu interfejsów API REST Microsoft Fabric. Użyj interfejsów API REST Microsoft Fabric, gdy skrypt konfiguracji lub aplikacja musi odnaleźć identyfikatory zamiast kopiować je z portalu Microsoft Fabric.

  1. Pobierz identyfikator obszaru roboczego za pomocą interfejsu API „List Workspaces”:

    GET https://api.fabric.microsoft.com/v1/workspaces
    

    Znajdź obszar roboczy według jego displayName wartości i skopiuj jego id wartość.

  2. Uzyskaj identyfikator elementu pulpitu nawigacyjnego czasu rzeczywistego za pomocą interfejsu API List Items:

    GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboard
    

    Zastąp <workspaceId> element identyfikatorem obszaru roboczego z poprzedniego kroku. W odpowiedzi znajdź element Real-Time Dashboard na podstawie jego displayName i skopiuj wartość id. Użyj tej wartości jako identyfikatora elementu w konfiguracji osadzania.

Uwaga / Notatka

W interfejsie API REST Microsoft Fabric wartość typu elementu dla elementu pulpitu nawigacyjnego Real-Time to KQLDashboard.

Opcjonalnie, zweryfikuj identyfikator elementu, wywołując:

GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items/<itemId>

Użyj interfejsu Get Item API, aby potwierdzić, że identyfikator obszaru roboczego i identyfikator elementu wskazują oczekiwany element pulpitu nawigacyjnego czasu rzeczywistego.

Weryfikacja powodzenia: odpowiedź List Items zawiera oczekiwany panel displayName, wartość id dla identyfikatora elementu oraz wartość typu elementu KqlDashboard.

Następne kroki