Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini menjelaskan arsitektur Microsoft Fabric Extensibility Toolkit dan bagaimana beban kerja kustom terintegrasi dengan platform Fabric. Ini menjelaskan komponen runtime, aliran antara frontend Fabric, beban kerja Anda, dan layanan Fabric, dan bagaimana model manifes dan item membuat beban kerja terasa asli di Fabric.
Komponen arsitektur
Frontend Fabric (host)
Frontend Fabric adalah lingkungan host. Ini merender beban kerja Anda sebagai iFrame dan mengekspos API host yang aman ke iFrame sehingga beban kerja dapat berinteraksi dengan Fabric sambil tetap terisolasi. Host bertanggung jawab untuk melakukan bootstrap beban kerja sesuai dengan manifesnya (titik masuk, rute, dan kemampuan), mengelola token autentikasi melalui ID Microsoft Entra, dan melakukan mediasi panggilan dari beban kerja ke API publik Fabric dan layanan platform.
Aplikasi web beban kerja
Beban kerja Anda adalah aplikasi web (misalnya, React atau Angular) yang Anda host di cloud Anda. Fabric memuatnya dalam iFrame dan menyediakan API host untuk diintegrasikan dengan platform. Aplikasi ini mengimplementasikan rute dan permukaan UI yang dideklarasikan dalam manifesnya, menggunakan token ID Microsoft Entra (disediakan oleh host) untuk memanggil API publik Fabric dan, jika diperlukan, layanan back-end Anda sendiri, dan mengikuti panduan Fabric UX sehingga terlihat dan berperilaku seperti pengalaman asli.
Layanan fabric dan API publik
Layanan Fabric mengekspos API publik untuk membaca dan menulis metadata dan konten, mengelola item, dan mengintegrasikan dengan kemampuan platform. Beban kerja memanggil API ini menggunakan token terlingkup yang dikeluarkan melalui ID Microsoft Entra—misalnya, untuk melakukan operasi ITEM CRUD dan tindakan siklus hidup, mengakses data dan konten yang disimpan di OneLake, dan berpartisipasi dalam fitur ruang kerja seperti pencarian dan penemuan. Untuk titik akhir, cakupan, dan panduan identitas, lihat FABRIC Public REST API.
Microsoft Entra (autentikasi)
Autentikasi dan otorisasi ditangani oleh ID Microsoft Entra. Manifes beban kerja menyatakan izin yang dibutuhkan; host Fabric memperoleh token yang sesuai dan memberlakukan persetujuan dan akses sesuai dengan deklarasi tersebut.
Model beban kerja dan manifes
Beban kerja ditentukan oleh manifes yang menjelaskan identitas, kemampuan, rute, titik masuk UI, dan izin yang diperlukan. Manifes adalah kontrak antara aplikasi web Anda dan Fabric. Untuk skema, contoh, dan panduan validasi, lihat Gambaran Umum Manifes.
Item dan partisipasi lokal
Beban kerja biasanya memberikan satu atau lebih jenis item. Item yang dibuat oleh beban kerja Anda muncul di ruang kerja dan berperilaku seperti item Fabric asli. Mereka berpartisipasi dalam kolaborasi dan berbagi, dapat ditemukan dalam pencarian, mengikuti operasi siklus hidup dan tata kelola, dan menyimpan data melalui OneLake saat menggunakan API publik Fabric untuk CRUD.
Alur menyeluruh
- Pengguna membuka ruang kerja dan menavigasi ke item atau titik entri yang disediakan oleh tugas kerja Anda.
- Frontend Fabric memuat aplikasi web Anda di iFrame berdasarkan manifes.
- Penyedia memperoleh Microsoft Entra tokens dengan cakupan yang diperlukan oleh beban kerja Anda dan mengekspos API penyedia ke iFrame.
- Perangkat kerja memanggil API publik Fabric (dan, jika berlaku, layanan milik Anda sendiri) menggunakan token ini.
- Data item disimpan di OneLake dan metadata item dikelola melalui FABRIC API sehingga berperilaku seperti item Fabric lainnya.
Langkah selanjutnya
Untuk mengembangkan dan menerbitkan beban kerja Anda secara lokal, lihat Menerbitkan beban kerja Anda. Untuk skema manifes dan panduan pengembangan lokal, lihat Gambaran umum manifes, DevServer, dan DevGateway. Untuk titik akhir API, cakupan, dan panduan identitas, lihat FABRIC Public REST API.