Report BI Module

Esta biblioteca facilita la integración de reportes de Power BI dentro de una aplicación React. Con esta herramienta, puedes embeber fácilmente reportes interactivos y dashboards de Power BI directamente en tus componentes React.

Características

• Integración Sencilla: Embeber reportes de Power BI en tus componentes React con una mínima configuración.
• Interactividad: Proporciona soporte para la interacción completa con los reportes de Power BI, incluyendo la aplicación de filtros y la manipulación de datos.
• Personalización: Configura y personaliza la apariencia y el comportamiento de los reportes embebidos.
• Seguridad: Soporte para la autenticación y el manejo seguro de tokens de acceso de Power BI.

Instalación

Primero, instala la biblioteca a través de npm o yarn:

npm install @team_apolo/[email protected]

o

yarn add @team_apolo/[email protected]

Uso Básico

Para empezar a usar la biblioteca, sigue estos pasos básicos:

1. Importa la biblioteca en el booting:

   import ReportBiModule from '@team_apolo/reports-powerbi';

2. Configura el módulo:

   const report = ReportBiModule({path: '/powerBI/:moduleId',version: 1, permissions: []})

3. Registra el módulo en el menú:

     export default async function (brix: Core.Launcher) {
       brix.registerLayout(DefaultLayout, {
   
         //register module on menus
         menuItems: MenuBuilder
           .addItem(
             'description',
             'Modulo regional Reporte de ventas',
             getDynamicPath(report.getDefinition().path, moduleIdTest)
           )//add some other items
           .toArray(),
   
         setters: (set: any) => {
           ...
         },
       });
   
       //more stuff
     }

4. Registra el módulo en brix:

     export default async function (brix: Core.Launcher) {
       //some stuff(like the previous menu registration)
       //register module
       brix
         .registerModule(biModule, {
         BACKEND_BASE_URL: "https://api.staging.cencox.xyz/apolo-app-platcom-platform/bff-api",
         getTenantConfig: async () => {
           const dataToken = await AuthService.getInfoToken();
           return {
             tenant_id: dataToken?.user_config?.active_tenant?._id || dataToken?.tenants[0]?._id,
             country: (dataToken.user_config.active_tenant.scope?.country_code || dataToken?.tenants[0]?.scope?.country_code) ?? '',
             businessUnit: (dataToken.user_config.active_tenant.scope?.business_unit || dataToken?.tenants[0]?.scope?.business_unit) ?? '',
             division: dataToken.user_config.active_brand ?? ''
           };
         },
         getTokenProvider: async () => AuthService.getAuth().access_token,
         getApplicationID: async () =>
         applicationIdTest,
         LoadingComponent: Gadgets.Components.LoadingPage
       })
       .registerMiddleware(PermissionMiddleware, {
           validateModuleURL: biModule.getDefinition().path,
           permissionsModule: biModule.getDefinition().permissions || [],
       });
       //register other modules
   }

Configuración de Props

• path (obligatorio): El path por el que se accede al módulo.
• version (opcional): Un number que especifica la versión
• permission (opcional): Un array con los permisos

Múltiples reportes

Se pueden crear múltiples instancias del módulo, siempre que se registren con diferentes path de acceso

Requisitos

• React: Esta biblioteca requiere React 16.8 o superior.
• Power BI: Necesitas tener acceso a Power BI y las credenciales necesarias para generar los tokens de acceso y URLs de embebido.