Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym artykule opisano architekturę zestawu narzędzi Microsoft Fabric Extensibility Toolkit oraz sposób integracji niestandardowych obciążeń z platformą Fabric. Wyjaśniono w nim składniki środowiska uruchomieniowego, przepływy między frontendem Fabric, twoim zadaniem i usługami Fabric oraz sposób, w jaki model manifestu i elementu sprawiają, że zadania są natywnie zintegrowane z Fabric.
Składniki architektury
Fronton sieci szkieletowej (host)
Frontend Fabric jest środowiskiem hosta. Renderuje obciążenie jako iFrame i udostępnia bezpieczny interfejs API hosta do iFrame, dzięki czemu obciążenie może wchodzić w interakcje z Fabric, zachowując jednocześnie izolację. Host jest odpowiedzialny za inicjalizowanie obciążenia zgodnie z jego manifestem (punktami wejścia, trasami i możliwościami), zarządzanie tokenami uwierzytelniającymi za pośrednictwem Microsoft Entra ID oraz pośredniczenie w wywołaniach z obciążenia do publicznych interfejsów API i usług platformy Fabric.
Aplikacja internetowa do zarządzania obciążeniem
Obciążenie to aplikacja internetowa (na przykład React lub Angular), która jest hostowana w chmurze. Framework ładuje go w elemencie iFrame i udostępnia interfejsy API hosta do integracji z platformą. Aplikacja implementuje trasy i warstwy interfejsu użytkownika zadeklarowane w manifeście, używa tokenów Microsoft Entra ID (dostarczonych przez hosta) do wywoływania publicznych interfejsów API Fabric, a w razie potrzeby, własnych usług zaplecza, i postępuje zgodnie ze wskazówkami dotyczącymi UX Fabric, aby wyglądała i zachowywała się jak środowisko natywne.
Usługa szkieletowa i publiczne interfejsy API
Usługa Fabric udostępnia publiczne interfejsy API do odczytywania i zapisywania metadanych i zawartości, zarządzania elementami i integracji z możliwościami platformy. Obciążenia używają tych interfejsów API za pomocą tokenów z zakresem wydanych przez Microsoft Entra ID — na przykład do wykonywania operacji CRUD oraz działań cyklu życia na elementach, dostępu do danych i treści przechowywanych w OneLake oraz uczestnictwa w funkcjach obszaru roboczego, takich jak wyszukiwanie i odkrywanie. Aby uzyskać informacje na temat punktów końcowych, zakresów i tożsamości, zobacz Fabric Public REST APIs.
Microsoft Entra (uwierzytelnianie)
Uwierzytelnianie i autoryzacja są obsługiwane przez identyfikator Firmy Microsoft Entra. Manifest obciążenia deklaruje wymagane uprawnienia; Host sieci szkieletowej uzyskuje odpowiednie tokeny i wymusza zgodę i dostęp zgodnie z tymi deklaracjami.
Model obciążenia i manifest
Obciążenia są definiowane przez manifest opisujący ich tożsamość, możliwości, trasy, punkty wejścia interfejsu użytkownika i wymagane uprawnienia. Manifest jest kontraktem między aplikacją internetową a usługą Fabric. Aby uzyskać wskazówki dotyczące schematu, przykładów i walidacji, zobacz Omówienie manifestu.
Elementy i uczestnictwo natywne
Obciążenia zwykle współtworzyją jeden lub więcej typów elementów. Elementy utworzone przez obciążenie są wyświetlane w obszarach roboczych i zachowują się jak natywne elementy sieci szkieletowej. Uczestniczą one we współpracy i udostępnianiu, można je odnajdywać w wyszukiwaniu, śledzić operacje cyklu życia i zarządzania, oraz przechowywać dane za pośrednictwem usługi OneLake, korzystając z publicznych interfejsów API usługi Fabric do operacji CRUD.
Kompletny przepływ
- Użytkownik otwiera obszar roboczy i przechodzi do elementu lub punktu wejścia udostępnionego przez pakiet zadań.
- Fabric frontend ładuje aplikację internetową w elemencie iFrame na podstawie manifestu.
- Host zdobywa tokeny Microsoft Entra z wymaganymi zakresami i udostępnia interfejs API hosta dla iFrame.
- Oprogramowanie robocze wywołuje publiczne interfejsy API Fabric (i, jeśli ma to zastosowanie, własne usługi) przy użyciu tych tokenów.
- Dane elementów są przechowywane w usłudze OneLake, a metadane elementów są zarządzane za pośrednictwem interfejsów API Fabric, więc zachowują się jak każdy inny element Fabric.
Dalsze kroki
Aby lokalnie rozwijać i publikować obciążenie robocze, zobacz Publikowanie obciążenia roboczego. Aby uzyskać wskazówki dotyczące schematu manifestu i lokalnego programowania, zobacz Omówienie manifestu, DevServer i DevGateway. Aby uzyskać wskazówki dotyczące punktów końcowych interfejsu API, zakresów i tożsamości, zobacz Fabric Public REST APIs.