Integración de Power BI con Ágora: informes en Connect Manager

Integración de Power BI con Ágora: muestra informes de Power BI en el panel de Analítica de Connect Manager, con filtro de fechas y seguridad por filas.

La integración de Microsoft Power BI muestra informes de Power BI dentro del panel de Analítica de Connect Manager, colgados de cada local, con el filtro de fechas del panel y, si se quiere, seguridad por filas. Sirve para que los clientes de Ágora vean sus cuadros de mando entrando con su cuenta de Connect Manager, sin iniciar sesión en Microsoft. Este manual es para el técnico que da de alta el informe y prepara el modelo para que encaje.

Qué hace la integración#

Añade a un local un informe de Power BI con un nombre y la URL del informe. Los identificadores del área de trabajo y del informe se sacan solos de la URL.
Con la aplicación de Connect Manager en Microsoft Entra ID, pide a Power BI la URL de inserción segura y el modelo del informe y genera un token de inserción de solo lectura cada vez que alguien abre el informe.
En el panel de Analítica, cada usuario elige el informe en el buscador de la barra superior (Buscar panel...). Ve los de todos los locales a los que tiene acceso: asignados a él, de sus grupos o, si tiene el permiso de herencia, de su distribuidor.
Filtra el informe por fechas desde la barra: Rango de tiempo... (Esta semana, Semana pasada, Hace 2 semanas, Este mes, Mes pasado, Hace 2 meses, Este año, Año pasado) o Desde... y Hasta.... El filtro se aplica sobre la tabla Fechas, columna Fecha, y se intenta llevar también a los segmentadores de la página abierta.
Seguridad por filas (RLS) opcional: el informe recibe como identidad el correo del usuario del panel con el rol TenantRole, así que cada uno ve solo sus filas.
Muestra la navegación de páginas a la izquierda, oculta el panel de filtros y las cabeceras de los visuales, y tiene un botón de Modo Presentación a pantalla completa.

Qué no hace#

No lee Ágora ni lleva datos a Power BI: el modelo, su origen de datos y su actualización se preparan en Power BI. Connect Manager solo enseña el informe ya publicado.
No deja editar ni exportar: el token es de solo lectura y las cabeceras de los visuales están ocultas.
No admite enlaces de «Publicar en la web», URLs sin /groups/…/reports/… (como las de reportEmbed) ni informes de «Mi área de trabajo».
No usa la cuenta de Microsoft de cada persona: solo filtra por el correo del usuario del panel si se activa RLS.
Trabaja con un único inquilino de Microsoft, el configurado en el servidor de Connect Manager.
No renueva el token con el informe abierto: tras mucho rato hay que volver a elegirlo o recargar la página.
El formulario del local está pensado para un informe por local (ver «Errores frecuentes»).

Requisitos#

Informe publicado en Power BI Service en un área de trabajo compartida (no «Mi área de trabajo») del inquilino de Microsoft que usa Connect Manager.
La aplicación ConnectManager Analytics App añadida al área de trabajo con rol Miembro o Administrador. Su registro en Microsoft Entra ID y sus credenciales en el servidor los mantiene FOS.
Para que funcione el filtro de fechas del panel: una tabla llamada exactamente Fechas con una columna Fecha de tipo fecha, relacionada con los datos del informe.
Para RLS: un rol llamado exactamente TenantRole cuyo filtro compare la columna de correo con USERPRINCIPALNAME(). Los correos de esa tabla tienen que coincidir con los de las cuentas del panel.
Usuarios con cuenta de Connect Manager, el permiso Entorno: Acceder a Analytics y acceso al local donde se cuelga el informe.
Quién hace qué: el autor del informe (FOS o el cliente) lo publica, da acceso a la aplicación y prepara las tablas de fechas y de RLS. FOS da de alta la integración en /admin y los permisos de los usuarios. El cliente dice qué personas deben verlo.

[!NOTE] Microsoft limita los tokens de inserción de las áreas de trabajo que no están en una capacidad (Power BI Embedded, Premium o Fabric): sin capacidad sirven para desarrollo y pruebas. Confirma con FOS la capacidad del área de trabajo antes de pasar el informe a producción.

Datos que necesitamos#

Dato	Quién lo facilita / dónde se saca	Ejemplo o formato	Obligatorio
URL del informe en Power BI Service	Autor del informe: barra de direcciones del navegador con el informe abierto	`https://app.powerbi.com/groups/11111111-2222-3333-4444-555555555555/reports/66666666-7777-8888-9999-000000000000/ReportSection`	Sí
Nombre descriptivo	FOS o el cliente; es lo que verán los usuarios en el buscador	`Ventas diarias`	Sí
Local del que se cuelga	FOS	`Restaurante Demo`	Sí
¿El modelo tiene el rol `TenantRole`?	Autor del informe	Sí / No	Sí
Correos de las personas que verán el informe	Cliente; con RLS, deben estar en la tabla de accesos del modelo	`persona@empresa.es`	Sí

Configuración paso a paso#

En Power BI#

Publica el informe desde Power BI Desktop (Publicar) en un área de trabajo compartida.
En el área de trabajo, Administrar acceso → Agregar personas o grupos → busca ConnectManager Analytics App → rol Miembro (o Administrador) → Agregar.
Comprueba que el modelo tiene la tabla Fechas con la columna Fecha. Sin ella el informe se ve, pero el filtro de fechas del panel no hace nada.
Si cada usuario debe ver solo lo suyo: en Power BI Desktop, Modelado → Administrar roles, crea el rol TenantRole sobre la tabla de accesos con el filtro [Tu_Columna_Con_El_Email] = USERPRINCIPALNAME() y vuelve a publicar.
Abre el informe en el navegador y copia la URL completa. Tiene que contener /groups/ y /reports/.

En Connect Manager#

Entra en /admin → Seguridad → Locales, abre el local y, en el bloque Ecosistema Conectado, pulsa Añadir Integración.
En Ajustes Generales, elige en Servicio / Proveedor la opción Microsoft Power BI (Analytics) y deja activado Estado Operativo.
En la sección Microsoft Power BI:
- Nombre Descriptivo: el nombre que verán los usuarios en el buscador, que los ordena alfabéticamente. Conviene incluir el local si el usuario ve varios.
- URL de Embebido (Embed URL): la URL copiada del navegador. No hace falta escribir ningún identificador a mano.
- Activar Row-Level Security (RLS): solo si el modelo tiene el rol TenantRole. Si el modelo tiene roles y lo dejas apagado, Microsoft no genera el token.
Pulsa Crear. La fila aparece con el nombre descriptivo, la integración Microsoft Power BI y la categoría analytics.
Para retirarlo sin borrarlo, edita la integración y apaga Estado Operativo: deja de salir en el buscador.

Usuarios#

Cada persona necesita el permiso Entorno: Acceder a Analytics y acceso al local: asignado a su usuario, a uno de sus grupos o a su distribuidor (con el permiso de herencia).
Entran en https://hub.connectmanager.es/analytics con correo y contraseña, o con Microsoft o Google si su cuenta de Connect Manager tiene ese mismo correo. El menú de usuario lleva a la Guía de Integración PBI, un resumen interno de estos pasos; donde habla de Workspace ID, Report ID y «Habilitar RLS», hoy basta con la URL y el interruptor de RLS de este manual.

Cómo funciona#

Al entrar en Analítica, el panel reúne los informes de Power BI activos de los locales que puede ver el usuario, pero no carga ninguno hasta que se elige. Cuando el usuario elige uno, el servidor de Connect Manager pide un token a Microsoft Entra ID con la aplicación de Connect Manager, saca de la URL los identificadores del área de trabajo y del informe y pregunta a Power BI por el informe para obtener su URL segura y su modelo. Si la integración tiene RLS, añade como identidad el correo del usuario con el rol TenantRole. Después pide a Power BI un token de inserción de solo lectura y se lo pasa a la página, que carga el informe con el SDK de Power BI mientras enseña el aviso «Sincronizando Sistema». Al cambiar las fechas, la página aplica el filtro al informe abierto sin volver a pedir token.

sequenceDiagram
    participant U as Usuario
    participant P as Panel de Analítica
    participant CM as Servidor Connect Manager
    participant AAD as Microsoft Entra ID
    participant PBI as Power BI
    U->>P: Elige un informe en el buscador
    P->>CM: Pide el informe de ese local
    CM->>AAD: Token de la aplicación de Connect Manager
    AAD-->>CM: Token de acceso
    CM->>PBI: Datos del informe a partir de la URL
    PBI-->>CM: URL de inserción y modelo
    CM->>PBI: Token de solo lectura, con el correo si hay RLS
    PBI-->>CM: Token de inserción
    CM-->>P: Token y URL de inserción
    P->>PBI: Carga el informe en la página
    U->>P: Cambia el rango de fechas
    P->>PBI: Filtro sobre la tabla Fechas, columna Fecha

Si el identificador del área de trabajo o del informe no se puede sacar de la URL, el servidor no carga nada: así nunca se cae en un informe por defecto que podría enseñar datos de otro cliente. No hay tareas programadas ni reintentos: todo ocurre al elegir el informe, y si Microsoft no responde el usuario ve el error en ese momento.

Comprobar que funciona#

En Power BI, la aplicación ConnectManager Analytics App aparece en Administrar acceso del área de trabajo como Miembro o Administrador.
En el bloque Ecosistema Conectado del local, la fila del informe tiene marcada la columna Activo.
Entra en /analytics con un usuario que tenga acceso al local y elige el informe en Buscar panel...: tras «Sincronizando Sistema» se ve el informe con sus páginas a la izquierda.
Elige Este mes en Rango de tiempo... y comprueba que las cifras cambian.
Con RLS, entra con un usuario de la tabla de accesos (ve sus filas) y con otro que no esté (no ve datos).
Pulsa el botón de pantalla completa para comprobar el modo presentación.

Errores frecuentes y solución#

Síntoma	Causa	Solución
«El sistema no detecta ningún conector analítico configurado en tu cuenta. Por favor, solicita acceso a la central.»	El usuario no tiene acceso a ningún local con un informe de Power BI activo.	Da acceso al local o activa Estado Operativo en la integración.
Aviso «Error cargando integración» con «Fallo de Seguridad Bloqueado: Los IDs del panel no existen ni se pudieron extraer de la URL de este cliente…»	La URL no contiene `/groups/…/reports/…` (enlace de «Publicar en la web», `reportEmbed` o similar).	Copia la URL del informe abierto en Power BI Service.
«Error cargando integración» con un texto que empieza por «Error de Microsoft Power BI:»	Power BI no genera el token: la aplicación no está en el área de trabajo, el informe está en «Mi área de trabajo», el modelo tiene RLS y el interruptor está apagado, o el interruptor está encendido y no existe el rol `TenantRole`.	Revisa el acceso de la aplicación y que el interruptor de RLS coincida con el modelo.
Al elegir el informe no pasa nada y no sale ningún mensaje	El servidor no ha conseguido el token de Microsoft Entra ID (credenciales de la aplicación en el servidor).	Avisa a FOS: el motivo queda en el registro del servidor.
En el recuadro del informe, «Conexión Rechazada» y «Error de token o Iframe cerrado por Microsoft.»	Power BI rechaza la carga, a menudo porque el token ha caducado con el informe abierto mucho rato.	Vuelve a elegir el informe o recarga la página. Si se repite al momento, revisa permisos y capacidad del área de trabajo.
El filtro de fechas del panel no cambia nada	El modelo no tiene la tabla `Fechas` con la columna `Fecha` con esos nombres exactos.	Crea o renombra la tabla y la columna, y vuelve a publicar.
Con RLS, un usuario no ve ningún dato	Su correo en Connect Manager no coincide con el de la tabla de accesos.	Corrige el correo en el modelo o en la cuenta del panel.
Al guardar: «Este local ya tiene una integración de tipo «powerbi». Solo se permite una por local.»	El local ya tiene dos informes de Power BI: con dos, el formulario no deja crear un tercero ni guardar cambios en los existentes.	Cuelga el informe de otro local del mismo cliente, o borra uno y vuelve a crearlo.
En el inicio de sesión con Microsoft o Google vuelve al login con el error `account_not_found`	No hay cuenta de Connect Manager con ese correo.	FOS crea la cuenta con ese correo y los permisos.

Preguntas frecuentes#

¿Cómo integro un informe de Power BI en Connect Manager?#

Publica el informe en un área de trabajo compartida, añade la aplicación ConnectManager Analytics App como Miembro y, en /admin → Seguridad → Locales, añade al local la integración Microsoft Power BI (Analytics) con un nombre y la URL del informe.

¿Por qué no se aplica el filtro de fechas del panel a mi informe?#

El panel filtra siempre sobre la tabla Fechas, columna Fecha. Si el modelo usa otros nombres, el filtro no encuentra dónde aplicarse.

¿Puede cada usuario ver solo los datos de su local?#

Sí, con seguridad por filas: crea en el modelo el rol TenantRole con el filtro [Tu_Columna_Con_El_Email] = USERPRINCIPALNAME() y activa Activar Row-Level Security (RLS) en la integración. Connect Manager envía como identidad el correo del usuario del panel.

¿Se puede usar un enlace de «Publicar en la web»?#

No. La integración necesita la URL del informe con /groups/ y /reports/ para generar un token privado; con otros enlaces se bloquea a propósito.

¿Connect Manager lleva los datos de Ágora a Power BI?#

Esta integración no: solo enseña informes ya hechos. Para alimentar un modelo hay dos API de Connect Manager con clave propia: la de pedidos de delivery (/app → Configuración → Integraciones) y la de reseñas del club (/fidelizacion → Configuración → Integraciones, con las consultas para Power BI Desktop en la pestaña Power BI de «Ver credenciales»).

¿Los usuarios necesitan cuenta de Power BI?#

No para verlo en el panel: entran con su cuenta de Connect Manager y el token lo genera la aplicación de Connect Manager. La cuenta de Power BI la necesita quien construye y publica el informe.