Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se describe la arquitectura del Kit de herramientas de extensibilidad de Microsoft Fabric y cómo se integran las cargas de trabajo personalizadas con la plataforma Fabric. Explica los componentes en tiempo de ejecución del entorno, los flujos entre el frontend de Fabric, sus cargas de trabajo y los servicios de Fabric, y cómo los modelos de manifiestos y elementos hacen que las cargas de trabajo se sientan nativas en Fabric.
Componentes arquitectónicos
Front-end de tejido (host)
El front-end de Fabric es el entorno de host. Renderiza la carga de trabajo como un iFrame y expone una API de host segura al iFrame para que la carga de trabajo pueda interactuar con Fabric mientras permanece aislada. El host es responsable de arrancar la carga de trabajo según su manifiesto (puntos de entrada, rutas y funcionalidades), administrar tokens de autenticación a través del identificador de Entra de Microsoft y mediar llamadas de la carga de trabajo a las API públicas y los servicios de plataforma de Fabric.
Aplicación web de carga de trabajo
La carga de trabajo es una aplicación web (por ejemplo, React o Angular) que usted hospeda en su nube. Fabric lo carga en un iFrame y proporciona API de host para integrarse con la plataforma. La aplicación implementa las rutas y las superficies de IU declaradas en su manifiesto, usa Microsoft Entra ID tokens (proporcionados por el host) para llamar a las API públicas de Fabric y, si es necesario, sus propios servicios de back-end, y sigue las instrucciones de UX de Fabric para que se vea y se comporte como una experiencia nativa.
Servicio de Fabric y API públicas
El servicio Fabric expone las API públicas para leer y escribir metadatos y contenido, administrar elementos e integrarlos con las funcionalidades de la plataforma. Las cargas de trabajo llaman a estas API mediante tokens con ámbito emitidos a través de Microsoft Entra ID, por ejemplo, para realizar acciones CRUD sobre elementos y ciclos de vida, acceder a los datos y el contenido almacenados en OneLake y participar en funciones del área de trabajo, como búsqueda y descubrimiento. Para ver puntos de conexión, ámbitos e instrucciones de identidad, consulte las API rest públicas de Fabric.
Microsoft Entra (autenticación)
El identificador de Entra de Microsoft controla la autenticación y la autorización. El manifiesto de la carga de trabajo declara los permisos que necesita; El host de Fabric obtiene los tokens adecuados y aplica el consentimiento y el acceso según esas declaraciones.
Modelo y manifiesto de carga de trabajo
Las cargas de trabajo se definen mediante un manifiesto que describe su identidad, funcionalidades, rutas, puntos de entrada de interfaz de usuario y permisos necesarios. El manifiesto es el contrato entre la aplicación web y Fabric. Para ver el esquema, los ejemplos y las instrucciones de validación, vea Información general del manifiesto.
Elementos y participación nativa
Normalmente, las cargas de trabajo incluyen uno o varios tipos de elementos. Los elementos creados por tu carga de trabajo aparecen en áreas de trabajo y se comportan como elementos nativos de Fabric. Participan en la colaboración y el uso compartido, se pueden detectar en la búsqueda, siguen las operaciones de ciclo de vida y la gobernanza, y almacenan datos a través de OneLake utilizando las API públicas de Fabric para CRUD.
Flujo de extremo a extremo
- Un usuario abre un área de trabajo y navega a un elemento o punto de entrada proporcionado por la carga de trabajo.
- El front-end de Fabric carga la aplicación web en un iFrame basado en el manifiesto.
- El host adquiere tokens de Microsoft Entra con los ámbitos que requiere la carga de trabajo y expone una API de host al iFrame.
- La carga de trabajo llama a las API públicas de Fabric (y, si procede, sus propios servicios) mediante estos tokens.
- Los datos de elementos se almacenan en OneLake y los metadatos de elementos se administran a través de las API de Fabric, por lo que se comporta como cualquier otro elemento de Fabric.
Pasos siguientes
Para desarrollar localmente y publicar la carga de trabajo, consulte Publicación de la carga de trabajo. Para obtener instrucciones sobre el esquema de manifiesto y el desarrollo local, consulte Introducción al manifiesto, DevServer y DevGateway. Para ver los puntos de conexión de API, los ámbitos y la guía sobre identidad, consulte las API REST públicas de Fabric.