本文說明 Microsoft Fabric 擴充性工具組的架構，以及自訂工作負載如何與 Fabric 平台整合。 它說明執行階段元件，以及 Fabric 前端、您的工作負載與 Fabric 服務之間的流程，還有資訊清單和項目模型如何使工作負載在 Fabric 中運行時顯得如同原生應用一般。
架構元件
Fabric前端（主機）
Fabric前端是主機環境。 它會將您的工作負載轉譯為 iFrame，並將安全主機 API 公開給 iFrame，讓工作負載可以在保持隔離的同時與 Fabric 互動。 主機負責根據工作負載的資訊清單 （進入點、路由和功能） 啟動、透過 Microsoft Entra ID 管理驗證權杖，以及調解從工作負載到 Fabric 公用 API 和平台服務的呼叫。
工作負載 Web 應用程式
您的工作負載是您在雲端中託管的 Web 應用程式 （例如 React 或 Angular）。 Fabric 將其載入到 iFrame 中，並提供主機 API 以與平台整合。 應用程式會實作其資訊清單中宣告的路由和 UI 介面、使用 Microsoft Entra ID 權杖 （由主機提供） 來呼叫 Fabric 公用 API，並視需要呼叫您自己的後端服務，並遵循 Fabric UX 指引，使其外觀和行為都像原生體驗。
Fabric 服務和公用 API
Fabric 服務會公開公用 API，用於讀取和寫入中繼資料和內容、管理項目，以及與平台功能整合。 工作負載會使用透過 Microsoft Entra ID 發出的範圍權杖來呼叫這些 API，例如，執行專案 CRUD 作業和生命週期動作、存取儲存在 OneLake 中的資料和內容，以及參與工作區功能，例如搜尋和探索。 如需端點、範圍和身分識別指引，請參閱 Fabric 公用 REST API。
Microsoft Entra （驗證）
驗證和授權是由 Microsoft Entra ID 處理。 工作負載的清單宣告其所需的許可，Fabric 主機會取得適當的權杖，並依據這些宣告執行同意和存取控制。
工作負載模型和清單
工作負載是由資訊清單定義，該資訊清單描述其身分識別、功能、路由、UI 進入點和必要的許可權。 資訊清單是您的 Web 應用程式與 Fabric 之間的合約。 如需結構描述、範例和驗證指引，請參閱 資訊清單概觀。
項目和本地參與
工作負載通常會提供一或多個項目類型。 工作負載所建立的項目會出現在工作區中，其行為類似於原生 Fabric 項目。 它們參與共同作業和共用、可在搜尋中探索、遵循生命週期作業和治理，以及透過 OneLake 儲存資料，同時使用適用於 CRUD 的 Fabric 公用 API。
端對端流程
- 使用者開啟工作區，並導覽至工作負載所提供的項目或進入點。
- Fabric 前端會根據資訊清單將 Web 應用程式載入 iFrame。
- 主機會取得具有您的工作負載所需的範圍的 Microsoft Entra 權杖，並將主機 API 公開給 iFrame。
- 工作負載會使用這些權杖呼叫 Fabric 公用 API （以及您自己的服務，如果適用的話）。
- 專案資料會儲存在 OneLake 中，而專案中繼資料會透過 Fabric API 進行管理，因此其行為就像任何其他 Fabric 專案一樣。
後續步驟
若要在本機開發並發佈工作負載，請參閱 發佈工作負載。 如需資訊清單結構描述和本機開發指引，請參閱 資訊清單概觀、 DevServer 和 DevGateway。 如需 API 端點、範圍和身分識別指引，請參閱 Fabric 公用 REST API。