Saltearse al contenido
Nappai Documentation

Power BI

Bienvenido al componente Power BI dentro del sistema de automatización Nappai. Este componente funciona como un puente seguro y automatizado que te permite conectar tu cuenta de Nappai directamente con Microsoft Power BI.

Su propósito principal es facilitarte la gestión de tus informes, conjuntos de datos y espacios de trabajo (workspaces) sin necesidad de escribir código complejo. Puedes utilizarlo para consultar información, verificar el estado de tus reportes o automatizar flujos de trabajo basados en tus datos.

¿Cómo funciona?

Imagina este componente como un asistente personal que sabe hablar el idioma de Power BI. Cuando lo configuras en tu flujo de automatización, este componente realiza las siguientes acciones de manera automática:

  1. Búsqueda y Enlace: Utiliza los identificadores (IDs) que proporcionas para encontrar exactamente el informe o el conjunto de datos que deseas gestionar dentro de tu cuenta de Power BI.
  2. Validación de Seguridad: Verifica automáticamente que tienes los permisos necesarios (por ejemplo, permisos de “Solo lectura” o “Edición”) para realizar la acción solicitada.
  3. Ejecución Automatizada: Interactúa con los servidores de Power BI en segundo plano para realizar la tarea (como consultar metadatos o actualizar estados).
  4. Resultados Claros: Al finalizar, te devuelve un resultado claro que indica si la operación fue exitosa y, en caso de éxito, te entrega la información solicitada lista para ser usada en pasos siguientes de tu automatización.

Este componente está optimizado para funcionar dentro de flujos de automatización, lo que significa que está diseñado para ser rápido, confiable y fácil de integrar con otros pasos de tu sistema.

Conexión y Credenciales

Este componente requiere configurar previamente una Credencial de Power BI en el panel de Nappai para poder interactuar con el servicio externo de Microsoft.

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Power BI y completa los campos requeridos (tokens de acceso o claves de API según corresponda).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este componente.

Nota: Sin una credencial válida y con los permisos adecuados en Microsoft Power BI, este componente no podrá acceder a tus datos.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados, permitiendo que los valores cambien automáticamente según el contexto de tu automatización.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo es esencial para identificar qué recursos de Power BI deseas gestionar:

  • Group ID: Identificador único del espacio de trabajo (workspace) donde se encuentra el informe o el conjunto de datos. Es como la “carpeta” principal donde resides tus proyectos en Power BI.
  • Report ID: Identificador único del informe de Power BI que deseas gestionar, consultar o modificar. Es el código específico que identifica a ese informe dentro del sistema.
  • Dataset ID: Identificador del conjunto de datos asociado al informe. Los conjuntos de datos son la fuente de información (las tablas y fórmulas) que alimentan a los informes.
  • Access Level: Especifica el nivel de permiso requerido para la operación. Generalmente, seleccionas entre “View” (Solo lectura, para consultar información) o “Edit” (Edición, para modificar recursos).

Salidas

Al ejecutarse, este componente produce las siguientes salidas que puedes utilizar en los pasos posteriores de tu automatización:

  • Success: Indica si la operación se completó sin errores (Verdadero/Falso). Es útil para decidir si debes continuar con el flujo o detenerlo en caso de fallo.
  • Data: Contiene la información devuelta por Power BI (por ejemplo, metadatos del informe, lista de reportes, etc.). Esta es la información principal que podrías necesitar para procesar en pasos siguientes.
  • Error: Si la operación falla, este campo contiene un mensaje detallado que explica la causa del error (como problemas de conexión o permisos insuficientes), lo que facilita la solución de problemas.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se ve la estructura de los datos devueltos cuando la operación es exitosa. Esto te ayudará a entender qué variables puedes “mapear” en los siguientes nodos del flujo. json { “report_id”: “12345678-9abc-def0-1234-567890abcdef”, “name”: “Reporte de Ventas Anual”, “webUrl”: “https://app.powerbi.com/groups/xyz/reports/abc”, “datasetId”: “87654321-fedc-ba09-8765-432109876543”, “state”: “Published”, “size”: 2048576 }

Conectividad

Este componente suele ser el puente de datos en tu flujo de trabajo. Lógicamente, se conecta:

  • Entrada: Recibe instrucciones desde componentes que inician procesos (como “Obtener datos” o “Gatillos de eventos”) o desde validaciones previas que requieren información de Power BI.
  • Salida: Sus salidas (especialmente Data y Success) se conectan comúnmente a:
    • Componentes de Procesamiento de Datos para analizar la información extraída.
    • Componentes de Notificación para alertar sobre el estado de reportes.
    • Componentes de Generación si necesitas usar los metadatos de Power BI para crear informes personalizados.

Ejemplo de Uso

Escenario: Verificar el estado de un informe crítico antes de generar un reporte mensual.

  1. Inicio del Flujo: Un componente de “Programador” activa el flujo cada mañana a las 8:00 AM.
  2. Uso de Power BI: Agregas este componente Power BI y configuras:
    • Report ID: El ID de tu informe de “Ventas Mensuales”.
    • Access Level: Seleccionas “View” porque solo quieres verificar el estado, no editarlo.
  3. Resultado:
    • Si el componente devuelve Success: True y en Data el estado es “Published”, el flujo continúa automáticamente para descargar los datos.
    • Si devuelve Success: False, el flujo envía una alerta a tu equipo indicando que el informe podría estar caído o sin actualizar.

Consejos y Mejores Prácticas

  • Mantén tus IDs actualizados: Asegúrate de que los Group ID, Report ID y Dataset ID que ingreses sean siempre los correctos. Si cambias de lugar un informe en Power BI, es posible que su ID no cambie, pero es bueno verificar que sigan apuntando al recurso correcto.
  • Usa permisos mínimos: Selecciona el nivel de acceso (Access Level) más bajo posible que cumpla tu necesidad (ej. “View” en lugar de “Edit”) para mantener tu cuenta segura.
  • Valida tus credenciales: Si el componente falla al inicio, verifica primero que tu credencial de Power BI en Nappai esté vigente y no haya expirado.
  • Aprovecha el Mapeo: Si tienes varios informes, usa el Modo de Mapeo para conectar el ID de un componente anterior (como una lista de tareas) directamente a la entrada Report ID, evitando configurar manualmente cada informe.

Consideraciones de Seguridad

  • Protección de Credenciales: Nunca compartas ni publiques tus credenciales de Nappai ni tus tokens de acceso. Están encriptadas y solo son accesibles dentro de tu panel seguro.
  • Acceso Restringido: Asegúrate de que la cuenta de Power BI vinculada tenga acceso únicamente a los recursos que necesita (Principio de Mínimo Privilegio).
  • Auditoría: Las operaciones realizadas con este componente quedan registradas en los logs de Microsoft Power BI y de Nappai, permitiendo rastrear quién o qué automatización accedió a tus datos.