Xetux Docs
PowerBI

Instalación y Publicación de Paneles Power BI

Guía técnica para el despliegue del On-premises Data Gateway y la publicación de reportes .pbix en el servicio web de Power BI.

Instalación y Publicación de Paneles Power BI

La integración de Power BI con Xetux permite la visualización avanzada de datos operativos en tiempo real. Este proceso requiere la sincronización entre el servidor local (donde reside la base de datos) y el servicio en la nube de Microsoft mediante una puerta de enlace de datos.

Prerrequisitos de Software

Antes de iniciar la configuración, asegúrate de contar con las siguientes herramientas instaladas y actualizadas en el servidor:

  1. On-premises Data Gateway (Modo Estándar)
  2. Power BI Desktop
  3. Plantilla de Reporte Xetux (.pbix)
  4. Opcional. .NET Framework 4.8
Importante: Las plantillas actualizadas son compatibles únicamente con versiones recientes del sistema Xetux. El uso de plantillas nuevas en sistemas desactualizados puede generar errores de esquema SQL.

Fase 1: Configuración del Gateway y Herramientas

El Gateway actúa como el puente de comunicación seguro entre la base de datos local de SQL Server y la nube de Power BI.

Instalación y Autenticación del Gateway

  1. Ejecuta el instalador del Gateway y selecciona Modo Estándar. (Nota: Si ya está instalado, el software detectará y realizará una actualización automática).
  2. Inicia sesión con la cuenta de Microsoft (email corporativo o máster) donde se alojarán los reportes.
  3. Selecciona la opción Registrar una nueva puerta de enlace en este equipo.

Registro de Identidad

  1. Nombre: Copia el nombre del servidor desde las Propiedades del Sistema de Windows (ej. XTX-CAMPOMAR-SRV).
  2. Clave de recuperación: Utiliza la contraseña estándar de soporte técnico: k8a3z7up.

Actualizar Power BI Desktop (Opcional)

Asegúrate de tener la última versión instalada ejecutando el instalador oficial. Al igual que el Gateway, se actualizará automáticamente si detecta una versión previa.


Fase 2: Gestión y Configuración del Archivo .pbix

Procederemos a preparar la plantilla de diseño conectándola con los datos de la sucursal local.

Nomenclatura y Ubicación

  1. Descarga el archivo de la plantilla desde el enlace de los prerrequisitos (PowerBiModelSales.pbix).
  2. Cambia el nombre de la plantilla al nombre del negocio/sucursal (ej. Campomar - Masarik.pbix).
  3. Mueve el archivo al directorio de soporte estándar en esta ruta:
C:\Users\Administrador\Documents\PBIx

Actualización de Orígenes de Datos

  1. Abre el archivo renombrado con Power BI Desktop.
  2. Ve a Archivo > Opciones y configuraciones.
  3. Haz clic en Configuración de Orígenes de datos y luego en Cambiar origen de datos.
  4. Cambia la opción de servidor por el Nombre del sistema (Nombre del equipo/servidor) para apuntar a la instancia local actual, y cierra la ventana.

Aplicar cambios y conectar a SQL Server

En la barra de mensaje amarilla/roja superior, selecciona Aplicar Cambios.

Comenzarán a mostrarse ventanas emergentes. Debes seleccionar Ejecutar hasta llegar a la ventana nombrada "Data Base SQL Server".

  • Ahí, selecciona la opción que incluye el nombre del servidor y la base de datos XETUXPOS.
  • Después de esa ventana, sigue seleccionando Ejecutar en las ventanas siguientes.

Fase 3: Publicación y Conexión Web

Una vez que la información esté lista y cargada en el reporte local, conectaremos el reporte publicado en la nube con la base de datos local a través del Gateway.

Publicar el reporte

Desde Power BI Desktop, haz clic en el botón Publicar del menú superior, coloca tus credenciales (si lo solicita) y selecciona Mi área de trabajo (My workspace) como destino.

Configuración en Power BI Web

  1. Ingresa a app.powerbi.com con el acceso de la cuenta correspondiente.
  2. Ve a My Workspace.
  3. Busca el archivo de tipo Conjunto de Datos / Semantic (Modelo semántico) del reporte recién publicado.
  4. Haz clic en los 3 puntos ... y selecciona Settings (Configuración).

Vincular y Configurar el Gateway

  1. Dirígete a la sección Gateway and Cloud (Conexiones de puerta de enlace).
  2. Selecciona el gateway instalado en la Fase 1, haz clic en el botón de "play" (>) y elige la opción Add to gateway.
  3. Llena los campos de configuración de la siguiente manera:
    • Connection name: [Nombre del equipo]
    • Server: [Nombre del equipo]
    • Database: XETUXPOS
    • Auth: Basic
Credenciales: En el método de autenticación (Basic o Windows), coloca el usuario y contraseña de la base de datos correspondiente al "Power User" para que el Gateway pueda realizar las consultas. Luego presiona Create.

Mapeo de Fuentes

  1. Regresa a la sección Gateway and Cloud.
  2. En la opción Maps to, vincula la fuente de datos SQL local seleccionando el nombre del equipo correspondiente.
  3. Haz clic en Apply.

Ve a tu Workspace y confirma abriendo el reporte. Si ya muestra datos, la conexión está lista.

Actualización Automática: Una vez configurado el mapeo, se recomienda programar una actualización automática (Scheduled Refresh) en esa misma pantalla de configuración para asegurar que los datos en la nube se refresquen sin intervención manual.

Fase 4: Crear Paneles Individuales (Dashboards)

El objetivo final es crear un Dashboard específico y optimizado para la sucursal.

Observación: Te recomendamos abrir el Dashboard de otra sucursal en una pestaña paralela para usarlo como referencia e inspirarte en la distribución.

Crear el Dashboard

En tu Workspace, haz clic en New Item (Nuevo elemento) y selecciona Dashboard.

Pinear (Anclar) elementos

  1. Ve al Report (Reporte) que acabas de configurar.
  2. Ve anclando (pineando) los elementos visuales a tu nuevo Dashboard, asegurándote de que los datos correspondan a la sucursal correcta.

Ajustar diseño y subtítulos

  1. Acomoda los elementos conforme al diseño de referencia, tanto en su vista Web como en la vista Móvil.
  2. Si algún elemento requiere subtítulos, haz clic en los 3 puntos ... del elemento para editarlo y coloca el texto correspondiente en el campo Subtitle.

Organizar archivos

Para mantener el orden, asegúrate de que los 3 archivos estén listos en tu Workspace:

  1. Semantic (Conjunto de datos)
  2. Report (Reporte)
  3. Dashboard (Panel)

Asegúrate de que lleven el Nombre de la sucursal y ubicación para diferenciarlos más fácilmente del resto de conexiones en el área de trabajo.

Copyright © 2026