Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
- Otwórz Microsoft Fabric.
- Otwórz obszar roboczy zawierający element Real-Time Dashboard.
- Upewnij się, że obszar roboczy jest przypisany do aktywnej pojemności Microsoft Fabric.
- 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.
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.
Zaloguj się do portalu Azure.
Wybierz dzierżawcę Microsoft Entra, wybierając swoje konto w prawym górnym rogu strony.
Wybierz pozycję Rejestracje aplikacji. Jeśli ta opcja nie jest widoczna, wyszukaj ją.
W Rejestracje aplikacji wybierz pozycję Nowa rejestracja.
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.
(Opcjonalnie) W polu Identyfikator URI przekierowania dodaj adres URL przekierowania.
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.
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.
W rejestracji aplikacji otwórz uprawnienia interfejsu API.
Wybierz pozycję Dodaj uprawnienie.
Dodaj delegowane uprawnienia zgodne ze swoim scenariuszem.
Jeśli Twoja organizacja wymaga zgody administratora, poproś administratora dzierżawy o udzielenie zgody.
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:
- Node.js i npm do instalacji pakietu Fabric Embed SDK
- Edytor kodu, taki jak Visual Studio Code
- Microsoft Authentication Library (MSAL) dla języka JavaScript na potrzeby uwierzytelniania Microsoft Entra ID
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.
Pobierz identyfikator obszaru roboczego za pomocą interfejsu API „List Workspaces”:
GET https://api.fabric.microsoft.com/v1/workspacesZnajdź obszar roboczy według jego
displayNamewartości i skopiuj jegoidwartość.Uzyskaj identyfikator elementu pulpitu nawigacyjnego czasu rzeczywistego za pomocą interfejsu API List Items:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboardZastąp
<workspaceId>element identyfikatorem obszaru roboczego z poprzedniego kroku. W odpowiedzi znajdź element Real-Time Dashboard na podstawie jegodisplayNamei 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.