Cómo Integrar Power BI en ForceManager
🔗 Esta función está disponible para todos los planes.
Para obtener información detallada sobre cada plan, puedes consultar 👉 aquí
Power BI integra insights completos, interactivos y en tiempo real directamente en ForceManager. Veamos cómo puedes integrar Power BI de manera transparente y mejorar la funcionalidad de ForceManager.
Requisitos previos
Antes de comenzar, asegúrate de tener:
Un inquilino de Microsoft Entra y un usuario organizacional maestro.
Una cuenta de Power BI Pro. Estos elementos son cruciales para un proceso de integración sin problemas, lo que te permite gestionar e implementar soluciones de Power BI de manera efectiva.
Haz clic en los siguientes enlaces si es necesario.
Consideraciones
La analítica integrada de Power BI ofrece dos soluciones:
Embedido para tus clientes
Embedido para tu organización
La solución de embedido para tus clientes te permite construir una aplicación que utiliza una autenticación no interactiva contra Power BI.
Es probable que tus clientes sean usuarios externos y no necesitan iniciar sesión utilizando credenciales de Power BI para ver el contenido embedido.
La solución de embedido para tu organización te permite construir una aplicación que requiere iniciar sesión utilizando credenciales de Power BI.
Una vez que los usuarios han iniciado sesión, solo pueden consumir el contenido embedido al que tienen acceso en el servicio de Power BI.
Esta solución está dirigida a grandes organizaciones que están construyendo una aplicación para usuarios internos.
Dicho esto, está claro que:
El método de embedido para tus clientes solo debe utilizarse para exponer datos a los clientes, es decir, datos no sensibles o secretos que deben permanecer dentro de la intranet de la empresa o detrás de un sistema de autenticación por usuario. Por otro lado, este método es el único que permite utilizar un sistema de autenticación automática (principal de servicio o usuario maestro) sin requerir que cada usuario se autentique.
El método de embedido para tu organización, por el contrario, está destinado a ser utilizado por usuarios internos, sin embargo, los usuarios deben autenticarse con su ID de Microsoft Entra, lo que hace que el proceso de autenticación no sea fluido. Sinceramente, no se sabe si hay una versión fluida/silenciosa para este tipo de inicio de sesión, pero por lo que se ha investigado, no hay formas de admitir un inicio de sesión automático incrustado que aproveche algún tipo de concesión, fuera del alcance directo de SSO de MS, basado en un proceso de autenticación que ocurrió en la aplicación que alberga el informe incrustado.
Entonces, ahora centraremos nuestra atención en la forma en que se puede configurar la incrustación para tus clientes para implementar un informe incrustado de Power BI en una aplicación web sin requerir autenticaciones adicionales.
Incrustar contenido para clientes
La documentación a seguir está aquí. TL;DR; lo que un cliente de ForceManager tendría que proporcionar a ForceManager, al permitir que un informe de PowerBI se acceda dentro de ForceManager, son las siguientes informaciones: clientId, workspaceId, reportId, clientSecret, tenantId. Luego, internamente en su inquilino de Azure, los clientes de ForceManager deben seguir una serie de pasos para generar esa información y configurar su propia aplicación de PowerBI y Azure para ser capaz de compartir datos de informes.
Para crear una aplicación de muestra incrustada para tus clientes, un cliente de ForceManager debe seguir estos pasos:
Selecciona tu método de autenticación
El método a utilizar es el del principal de servicio, el que básicamente permite que una aplicación autentique tu aplicación con Entra ID. Después de que se haya autenticado, la aplicación puede acceder a los recursos del inquilino de Microsoft Entra. Este tipo de método permite que una aplicación interactúe a través de API con Microsoft básicamente, por eso no requiere una autenticación por usuario para acceder al informe.
Registrar una aplicación de Microsoft Entra
El elemento central para exponer un informe (literalmente un espacio de trabajo de PowerBI) es crear primero una aplicación con el ID de Microsoft Entra. Para ello, solo es necesario seguir las instrucciones en Registrar tu aplicación.
Es posible crearla manualmente o automatizarla mediante la herramienta de configuración de análisis embedido de Power BI, que es bastante potente. La herramienta automática básicamente presenta un proceso paso a paso que el usuario puede seguir para crear una aplicación incrustada para tus clientes.
La configuración requiere:
Elige como solución de incrustación la opción "Embed for your costumers".
Paso 1: Inicia sesión en Power BI con tu usuario maestro (PowerBI Pro).
Paso 2: Registra tu aplicación
Proporcionando un nombre de aplicación (por ejemplo, Informes incrustados de prueba de PowerBI); especificando los accesos a la API.
Para este fin, es suficiente dar permiso para Leer todos los informes.
Haz click en Register
Paso 3: Creación de un espacio de trabajo
El ID de Aplicación de tu aplicación de Microsoft Entra se muestra en el cuadro de Resumen. Copia este valor para usarlo más adelante.
Paso 4 - Importación de contenido
Es opcional y se puede omitir.
Paso 5 - Conceder permisos (Solo para incrustar para tus clientes)
Esto se realiza simplemente presionando el botón correspondiente en la interfaz presentada. Selecciona Conceder permisos y en el diálogo selecciona Aceptar. Este paso permite que tu aplicación de Microsoft Entra acceda a las API que seleccionaste (también conocidas como ámbitos) con tu usuario registrado. Este usuario también es conocido como el usuario maestro.
Una vez hecho esto, en la izquierda aparece un ID de aplicación que debe ser anotado (por ejemplo, 4e9ead49-8c6c-4e6d-b98f-25f88861b74f).
Paso 6 - Configurar tu entorno
La analítica incrustada de Power BI atiende a diferentes necesidades, incluyendo la incrustación para clientes ("La aplicación es propietaria de los datos") y la incrustación para tu organización ("El usuario es propietario de los datos"). Para esta guía, nos centraremos en el método "Incrustar para tus clientes", perfecto para ofrecer análisis completos sin iniciar sesión de usuarios individuales.
Paso 7 - Crear y publicar un informe de Power BI
El siguiente paso es crear un informe y cargarlo en tu espacio de trabajo. Puedes crear tu propio informe usando Power BI Desktop y luego publicarlo en tu espacio de trabajo.
Por razones de prueba, es posible descargar informes predefinidos en el repositorio de muestras de Power BI Desktop en Github.
Paso 8 - Obtener los valores de los parámetros de incrustación
Para incrustar tu contenido, necesitas obtener ciertos valores de parámetros. Para el método de autenticación del principal de servicio, necesitas:
ID de cliente: este es el ID de aplicación que ya tienes.
ID de espacio de trabajo: puedes encontrar el ID de espacio de trabajo en la configuración del portal de administración seleccionando "Detalles" junto al nombre del espacio de trabajo. Alternativamente, obtén el GUID del ID de espacio de trabajo, inicia sesión en el servicio de Power BI, abre el informe que deseas incrustar. Copia el GUID de la URL. El GUID es el número entre /groups/ y /reports/.
ID de informe: para obtener el GUID del ID de informe, inicia sesión en el servicio de Power BI. Abre el informe que deseas incrustar. Copia el GUID de la URL. El GUID es el número entre /reports/ y /ReportSection/. ID de inquilino: para obtener el GUID del ID de inquilino, inicia sesión en Microsoft Azure. Busca "Registros de aplicaciones" y selecciona el enlace "Registros de aplicaciones". Selecciona la aplicación de Microsoft Entra que estás utilizando para incrustar tu contenido de Power BI, por ejemplo, Informes incrustados de prueba de PowerBI. Desde la sección de Resumen, copia el GUID de la ID de directorio (inquilino).
Secreto de cliente: esto se puede generar como de costumbre desde Azure, dentro de la sección "Administrar -> Certificados y secretos" de la aplicación (la aplicación aparece nuevamente en los "Registros de aplicaciones" de Azure). En "Secretos de cliente", selecciona "Nuevo secreto de cliente". En la ventana emergente "Agregar un secreto de cliente", proporciona una descripción para el secreto de tu aplicación, selecciona cuándo expira el secreto de la aplicación (por ejemplo, 2 años) y selecciona "Agregar". Desde la sección de "Secretos de cliente", copia la cadena en la columna "Valor" del nuevo secreto de la aplicación recién creado. El valor del secreto del cliente es tu secreto de cliente. Asegúrate de copiar el valor del secreto de cliente cuando aparezca por primera vez. Después de navegar lejos de esta página, el secreto del cliente estará oculto y no podrás recuperar su valor.
Paso 9 - Acceso a API del principal de servicio
Para que una aplicación de Microsoft Entra pueda acceder al contenido y las API de Power BI, un administrador de Power BI necesita habilitar el acceso del principal de servicio en el portal de administración de Power BI. Esto debería estar habilitado por defecto.
Si no lo está, sigue estas instrucciones para hacerlo. Para que una aplicación de Microsoft Entra pueda acceder al contenido y las API de Power BI, un administrador de Power BI necesita habilitar el acceso del principal de servicio en el portal de administración de Power BI. Si no eres el administrador de tu inquilino, pide al administrador del inquilino que habilite la configuración del inquilino para ti.
En el servicio de Power BI, selecciona Configuración > Configuración > Portal de administración (arriba).
Selecciona Configuración de inquilino y luego desplázate hacia abajo hasta la sección Configuración de desarrollador.
Expande Permitir que los principales de servicio usen las API de Power BI y habilita esta opción (abajo).
Paso 10 - Habilitar el acceso al espacio de trabajo
Para permitir que tu aplicación de Microsoft Entra acceda a objetos como informes en el servicio de Power BI, el principal de servicio debe ser añadido como miembro o administrador de tu espacio de trabajo. Esto es muy importante, de lo contrario, el informe incrustado no se mostrará debido a un error de no autorización.
Para hacerlo:
Inicia sesión en el servicio de Power BI.
Desplázate hasta el espacio de trabajo para el que deseas habilitar el acceso y, desde el "Menú Más", selecciona "Acceso al espacio de trabajo".
En el "Panel de acceso", copia el nombre del principal de servicio, que es el nombre que diste a tu aplicación de Microsoft Entra, por ejemplo, Informes incrustados de prueba de PowerBI.
Paso 11 - Embede tu contenido
Si todo está configurado correctamente, deberías poder embedir tu informe en una aplicación de terceros. Ten en cuenta que los servicios de Microsoft pueden tardar un poco en propagar los diferentes accesos (API, espacio de trabajo, ...), por lo que eventualmente podrías experimentar problemas de no autorización a corto plazo.
Cuando hablamos de embedir, nos referimos específicamente a proporcionar una experiencia de usuario en ForceManager que permita a nuestro cliente de ForceManager proporcionar los valores de los parámetros de incrustación necesarios para permitir que nuestro frontend/backend interactúe con Microsoft y Power BI de manera que se pueda mostrar un informe deseado dentro de la aplicación web de ForceManager.
De esta manera, el cliente puede consumir los paneles de PowerBI ya creados directamente desde ForceManager.
Durante el desarrollo del código interno, es posible explorar aplicaciones de integración de Power BI preexistentes proporcionadas por Microsoft.
Hay una carpeta de ejemplos para desarrolladores de Power BI en Github que contiene implementaciones de aplicaciones en diferentes lenguajes (Node, Python, Java, ...).