¿Cómo integrar informes de Microsoft Power BI en aplicaciones Umbraco?

Resumen

Guía para integrar informes y paneles de Power BI en Umbraco . Integre Microsoft Power BI con Umbraco mediante el plugin miniOrange Power BI Integrator . Esta guía le mostrará los pasos para integrar informes, paneles, mosaicos, conjuntos de datos o modelos semánticos de Power BI en sus páginas y entradas de Umbraco, permitiendo a los usuarios visualizar elementos interactivos de Power BI directamente desde el sitio web de Umbraco. También puede habilitar la seguridad a nivel de fila (RLS) para obtener una visualización granular y personalizada de los gráficos de Power BI en Umbraco.

Descargar

Planes de Precios

Requisitos previos: descarga e instalación

El integrador miniOrange Umbraco requiere:

Una aplicación de Umbraco ejecutándose en la versión 9 a 15.

La aplicación debe estar conectada a un MS SQL Server(Si no, podemos sugerir la versión adecuada según su base de datos).

Si su aplicación no utiliza una base de datos, también podemos proporcionar una versión que funcione sin una base de datos.

A Microsoft Power BI cuenta.

Añadiendo miniOrange a la aplicación Umbraco

Instale la Paquete Nuget del integrador miniOrange PowerBI utilizando el Administrador de paquetes Nuget o CLI.

Paquete NuGet

CLI de .NET

PM> NuGet\Install-Package miniOrange.Umbraco.PowerBI.Integrator

Una vez instalada, simplemente cree la aplicación para agregarla Vistas y archivos estáticos de miniOrange.

Agregue los siguientes detalles en su programa.cs .

                
                      using miniOrange.Umbraco.PowerBI;
                    
                     using Umbraco_PowerBI_Integrator;

                      using Umbraco_PowerBI_Integrator.RouteObserver;
                    
                      WebApplicationBuilder builder =  WebApplication.CreateBuilder(args);

  builder.Services.AddMiniOrangeServices(builder.Configuration);

                      builder.CreateUmbracoBuilder()
                    
.AddBackOffice()

.AddWebsite()

.AddDeliveryApi()

.AddComposers()

.Build()

  WebApplication app =  builder.Build();

  await app.BootUmbracoAsync();

  app.UseStaticFiles();

  app.UseUmbraco()

.WithMiddleware(u =>

{

              u.UseBackOffice();

              u.UseWebsite();

              u.AppBuilder.UseminiOrangeUmbracoPowerBIMiddleware();

})

.WithEndpoints(u =>

{

              u.UseInstallerEndpoints();

              u.UseBackOfficeEndpoints();

              u.UseWebsiteEndpoints();

});

  await app.RunAsync();

Construya y ejecute la aplicación.

Configurar Azure AD para la integración de PowerBI

Realizaremos algunas configuraciones de PowerBI dentro del panel de miniOrange

1. Configure el registro de la aplicación Azure AD

Inicia sesión en Azure AD portal como administrador.

Se le presentará la pantalla de inicio de Azure Active Directory.

En la sección de servicios de Azure, seleccione ID de entrada de Microsoft.

Azure Active Directory - Pantalla de inicio

En la pestaña izquierda, en la sección administrar, seleccione Registros de aplicaciones.

Azure Active Directory: Registros de aplicaciones

Haga clic en nuevo registro.

Azure Active Directory: nuevos registros

Asignar el Nombre que se ve en la pagina en el campo de nombre y elija el Tipo de cuenta.

En la sección URI de redirección campo, proporcione la URL base de su Sitio de Umbraco y haga clic en el ícono de Registrarse .

Azure Active Directory: Registrar una aplicación

Después del registro de una aplicación, Azure AD asigna una clave única ID de aplicación a su aplicación.

Navegue a la pestaña Pestaña Vista general, en el panel izquierdo.

Copia el ID de aplicación y conectar Id. de directorio, este será tu ID de cliente y Identificación del inquilino.

Azure Active Directory: identificador de aplicación único

Desde el panel de navegación izquierdo, navegue hasta el Certificados y secretos .

Haga clic en un nuevo secreto de cliente. Ingrese la descripción y el tiempo de vencimiento y haga clic en el ADD .

Azure Active Directory: certificados y secretos

Copie el valor de Llave secreta. Este será tu Clave secreta del cliente.

2. Agregue permisos de API a su aplicación de Azure AD:

Vaya al Permisos API desde el panel de navegación izquierdo y haga clic en agregar un permiso .

Seleccionar Microsoft Graph (Lazy section loading) bajo la sección API de Microsoft .

Seleccionar Permisos de aplicación y busca el El sistema de reservas de escritorios, interactivo y fácil de usar, ayuda a gestores y empresas a adaptarse a la nueva rutina laboral. El sistema inteligente optimiza espacios y horarios según necesidades reales..

En El sistema de reservas de escritorios, interactivo y fácil de usar, ayuda a gestores y empresas a adaptarse a la nueva rutina laboral. El sistema inteligente optimiza espacios y horarios según necesidades reales. selecciona Usuario. Leer y Usuario.Leer.todo permisos y haga clic en el Agregar permisos botón.(gráfico de microsoft)

Haga clic en agregar permiso, desplácese hacia abajo y seleccione Servicio Power BI bajo solicitud opción de permiso de api.

Seleccionar Permiso de delegado y busca el Reportes.

En Informes selecciona Informe.Leer.Todo permiso y haga clic en el Agregar permiso botón. (Power BI)

Ahora puedes ver todos los permisos en el permiso de API ,

Haga clic en otorgar consentimiento de administrador para el directorio predeterminado y haga clic en Sí: al otorgar la confirmación del consentimiento del administrador.

Otorgar consentimiento del administrador

Ha configurado correctamente la aplicación Azure AD.

3. Configure los ajustes del grupo de seguridad de Azure AD

En la página de inicio del directorio activo de Azure, navegue hasta Grupos Desde el panel izquierdo.

Haga clic en Nuevo grupo para agregar un nuevo grupo de seguridad.

Seleccione el elemento Tipo de grupo as Seguridad desde el menú desplegable e ingrese el Nombre del grupo as Permitir las API de administración de Power BI.

Una vez que haya ingresado los detalles, haga clic en el Botón Crear para crear un nuevo grupo de seguridad.

Busque y seleccione grupos de seguridad recién creados (Permitir API de administración de Power BI).

Azure Active Directory: nuevos grupos de seguridad creados

Navegue a la pestaña Miembros pestaña del panel izquierdo y haga clic en Añadir miembros.

Azure Active Directory: Agregar miembros

Ahora busque el nombre de la aplicación que ha configurado previamente y haga clic en el selecciona .

Ha configurado correctamente la aplicación Azure AD para lograr la sincronización de usuarios y la integración de Power BI en su aplicación Umbraco.

Configurar PowerBI para la integración.

Vaya a la Power BI panel e inicie sesión como administrador.

Estará representado con la pantalla de inicio de Power BI.

En la esquina superior derecha, haga clic en icono de configuración como se muestra a continuación.

En la sección gobernanza y conocimientos haga clic en el botón portal de administración .

En la sección portal de administración sección, debajo de la configuración del inquilino, desplácese hasta la configuración de desarrollador.

Haga clic en Permitir que los principales de servicio creen y utilicen perfiles.

Active la característica de palanca y luego haga clic en Aplicar.

PowerBI - Configuración de inquilinos del portal de administración

Desplácese hacia abajo hasta la sección Configuración de API de administrador, habilite el interruptor y luego elija la opción de grupos de seguridad específicos.

Busque Grupo de usuarios de Power BI de Umbraco a continuación, haga clic en Aplicar.

Grupo de usuarios de Power BI de Umbraco

Vuelve a la página de inicio. Selecciona el Espacios de trabajo pestaña del panel izquierdo y luego seleccione su espacio de trabajo de la lista.

Navegue a la pestaña Administrar el acceso .

En la sección Administrar el acceso sección, haga clic en agregar Agregar personas o grupos.

Busca la aplicación que has configurado previamente. En el menú desplegable seleccione el Viewer y haga clic en Agregar Botón para asignar esta aplicación de Azure AD a su Espacio de trabajo de Power BI.

Seleccione el elemento (reporte) que desea incrustar en el Página o publicación de Umbraco.

Luego copia el ID_espacio de trabajo y Informe_ID desde la URL como se muestra en la imagen a continuación y téngala a mano ya que la necesitará en el futuro.

Configurar el complemento miniOrange con la configuración de PowerBI

Visita la aplicación Umbraco.

En la URL base de su aplicación, agregue el /?acción=config parámetro de consulta.(/?acción=config)

Se le mostrará con el formulario de inscripción, rellena y haz clic en el Botón de registro.

Una vez registrado, se le mostrará el panel de administración de miniOrange.

Vaya a la Configuración de autenticación tabula e ingresa ID de cliente, secreto de cliente e ID de inquilino de su aplicación Azure AD y luego haga clic en Guardar.

Umbraco - Configuración de autenticación

Ahora ve al Configuración de Power BI pestaña e ingrese el Nombre del informe, ID del espacio de trabajo y Informe_ID de su informe

Se generará el script que muestra ID_espacio de trabajo y Informe_ID de su Informe de Power BI.

Inicie sesión en su cuenta de Umbraco BackOffice.

En la pestaña de contenido -> Haga clic en la opción Informes de PowerBI.

En la versión de prueba de miniOrange, solo podrá acceder al informe tras iniciar sesión con su cuenta de Entra ID. Haga clic en el botón "Iniciar sesión" e inicie sesión con su cuenta de Entra ID.

Se le mostrará el informe de PowerBI tan pronto como inicie sesión.

Ponte en contacto

Contáctanos en umbracosupport@xecurify.com y nuestro equipo te ayudará a configurar la integración de Power BI en Umbraco. También te ayudaremos a elegir la solución o el plan más adecuado según tus necesidades.

Contenido