Configurar la inserción de Microsoft Fabric para elementos de panel en tiempo real

Configura la inserción de Microsoft Fabric antes de insertar un elemento de panel en tiempo real en una aplicación web de JavaScript o TypeScript. Debe disponer de un área de trabajo asignada a una capacidad de Microsoft Fabric, acceso al elemento de panel en tiempo real, un registro de aplicaciones de Microsoft Entra ID con permisos delegados y herramientas de desarrollo local.

Microsoft Fabric Embed es una característica en versión preliminar pública para incrustar elementos compatibles de Microsoft Fabric.

Note

Microsoft Fabric Embed está en versión preliminar pública. Para conocer los tipos de elementos compatibles, la autenticación y las limitaciones relacionadas con el contrato de versión preliminar, consulte Limitaciones de Microsoft Fabric Embed.

Requisitos previos para la configuración de Microsoft Fabric Embed

Para ver una lista de requisitos previos, consulte ¿Qué necesito para usar Microsoft Fabric Embed?

Configuración del área de trabajo de Fabric

Microsoft Fabric Insertar admite el acceso de usuario delegado. El usuario de Microsoft Entra ID que ha iniciado sesión debe poder abrir el elemento del panel en tiempo real en Microsoft Fabric antes de que ese mismo elemento pueda mostrarse en una aplicación incrustada.

  1. Abra Microsoft Fabric.
  2. Abra el espacio de trabajo que contiene el elemento «Panel en tiempo real».
  3. Confirme que el área de trabajo está asignada a una capacidad de Microsoft Fabric activa.
  4. Confirme que los usuarios que ven el elemento panel de Real-Time incrustado tienen el visor o un acceso superior al área de trabajo y al elemento panel de Real-Time.

Comprobación satisfactoria: el área de trabajo muestra una asignación de capacidad activa y el usuario puede abrir directamente el elemento Panel en tiempo real en el portal de Microsoft Fabric.

Captura de pantalla de un área de trabajo con un panel de Real-Time.

Importante

Si un usuario que ha iniciado sesión no tiene acceso al área de trabajo o al elemento del panel en tiempo real en Microsoft Fabric, la inserción de Microsoft Fabric no muestra el elemento en la aplicación incrustada.

Registro de una aplicación de Microsoft Entra ID para el inicio de sesión de usuario

Su aplicación de JavaScript o TypeScript necesita un registro de aplicaciones de Microsoft Entra ID para permitir que los usuarios inicien sesión y solicitar tokens de acceso delegados para Microsoft Fabric Embed.

  1. Inicie sesión en Azure Portal.

  2. Seleccione su tenant de Microsoft Entra seleccionando su cuenta en la esquina superior derecha de la página.

  3. Seleccione Registros de aplicaciones. Si no ve esta opción, búsquela.

  4. En Registros de aplicaciones, seleccione Nuevo registro.

  5. Rellene los campos siguientes:

    • Nombre : asigne un nombre a la aplicación.
    • Tipo de cuenta admitido : seleccione quién puede usar la aplicación. Seleccione Solo cuentas de este directorio organizacional para aplicaciones de un solo inquilino, o Cuentas de cualquier directorio organizacional para escenarios entre inquilinos.

  6. (Opcional) En el cuadro URI de redirección , agregue una dirección URL de redireccionamiento.

  7. Seleccione Registrar. Una vez registrada la aplicación, se le dirigirá a la página de información general de la aplicación, donde puede obtener el identificador de aplicación. Copie y guarde el identificador de aplicación y toda la información del cuadro Resumen para su uso posterior. El entorno de inserción de Microsoft Fabric está listo para usarse. Captura de pantalla del nuevo registro de aplicaciones en Entra ID.

Comprobación correcta: el resumen del registro de la aplicación muestra el identificador de cliente y el identificador del inquilino que usa su aplicación para autenticarse con Biblioteca de autenticación de Microsoft (MSAL).

Note

Mantenga estos valores disponibles. Los usa al configurar la autenticación en la aplicación.

Agregar permisos delegados de API para Microsoft Fabric Embed

La aplicación debe solicitar permisos delegados de API para la incrustación en Fabric, el acceso de lectura a elementos y la detección opcional del espacio de trabajo. Use permisos delegados de usuario para Microsoft Fabric Embed.

  1. En el registro de la aplicación, abra permisos de API.

  2. Seleccione Agregar un permiso.

  3. Agregue los permisos delegados que coincidan con el escenario.

  4. Si su organización requiere el consentimiento del administrador, pida a un administrador de inquilinos que conceda consentimiento.

    Captura de pantalla de los permisos de API.

Note

Solicite los permisos delegados con privilegios mínimos para su escenario:

Permiso Cuándo usarlo Purpose
Fabric.Embed Necesario para Microsoft Fabric Embed. Permite que la aplicación inserte elementos de Microsoft Fabric admitidos.
KQLDashboard.Read.All Permiso de lectura preferido para los elementos del panel en tiempo real. Permite a la aplicación leer los elementos del panel en tiempo real a los que puede acceder el usuario que ha iniciado sesión.
Item.Read.All Úselo solo si su caso requiere un acceso de lectura más amplio a los elementos de Fabric. Permite que la aplicación lea los elementos de Fabric a los que puede acceder el usuario que ha iniciado sesión.
Workspace.Read.All Solo es necesario cuando la aplicación usa Microsoft Fabric API REST para detectar identificadores de área de trabajo o de elemento. Permite la detección de áreas de trabajo de solo lectura para el usuario que ha iniciado sesión.

Comprobación superada: el registro de la aplicación incluye Fabric.Embed, un permiso de lectura de un elemento y Workspace.Read.All únicamente si su aplicación usa las API REST de Microsoft Fabric para descubrir identificadores.

Instalación de herramientas de desarrollo local para la aplicación web

Instale estas herramientas y bibliotecas para la aplicación JavaScript o TypeScript que aloja el elemento de panel en tiempo real incrustado:

Instalación del paquete del SDK de inserción de Fabric en la aplicación web

Instale el paquete en versión preliminar pública Fabric Embed SDK en la aplicación web que aloja el elemento de panel en tiempo real incrustado. El nombre y la versión del paquete pueden cambiar durante la versión preliminar. Utilice el nombre de paquete que proporciona su versión preliminar.

npm install @microsoft/fabric-embed

Comprobación superada: el paquete Fabric Embed SDK aparece en las dependencias de package.json su aplicación.

Recopila los identificadores del área de trabajo y del panel de Real-Time

También puede recopilar mediante programación el identificador del área de trabajo y el identificador del elemento del panel en tiempo real mediante las API REST de Microsoft Fabric. Use Microsoft Fabric API REST cuando el script de instalación o la aplicación necesite detectar identificadores en lugar de copiarlos desde el portal de Microsoft Fabric.

  1. Obtenga el identificador del área de trabajo con list workspaces API:

    GET https://api.fabric.microsoft.com/v1/workspaces

    Busque el espacio de trabajo por su displayName y copie el valor de id.

  2. Obtenga el ID del elemento del panel en tiempo real con la API List Items:

    GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboard

    Reemplace <workspaceId> por el identificador del área de trabajo del paso anterior. En la respuesta, busque el elemento del panel en tiempo real por su displayName y copie el valor de id. Use ese valor como identificador de elemento en la configuración de inserción.

Note

En la API REST de Microsoft Fabric, el valor del tipo de elemento para un elemento de panel en tiempo real es KQLDashboard.

Opcionalmente, valide el identificador de elemento llamando a:

GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items/<itemId>

Utilice la Get Item API para confirmar que el identificador del área de trabajo y el identificador del elemento corresponden al elemento esperado del panel en tiempo real.

Comprobación satisfactoria: la respuesta de List Items incluye el panel esperado displayName, un valor id para el identificador del elemento y el valor del tipo de elemento KqlDashboard.

Pasos siguientes

  • Last updated on