Cómo agregar Deneb a tu reporte de Power BI

Para usar Deneb en un reporte necesitas dos cosas: el visual agregado a tu reporte y los campos que le vas a pasar. Lo demás es la especificación, que ya empezaste a escribir.

Power BI Desktop funciona solo en Windows (Windows 10 o posterior). Si usas Mac, puedes hacer todo el curso en estas páginas y llevar tu especificación a un reporte desde el servicio de Power BI en el navegador (app.powerbi.com):

• Con la licencia gratuita puedes crear y editar reportes en Mi área de trabajo para tu propio uso. Para compartirlos o trabajar en el área de trabajo de tu equipo necesitas Power BI Pro o Premium por usuario.
• Para registrarte necesitas un correo de trabajo o de escuela. Microsoft no acepta cuentas personales como Gmail o Hotmail.
• Deneb es gratuito y está certificado por Microsoft, pero quien administra Power BI en tu organización puede bloquear los visuales de AppSource. Si no ves la opción para agregarlo, pregúntale a esa persona.

Cómo instalar Deneb y ponerlo en tu página

Deneb se descarga desde AppSource, la tienda de visuales de Power BI, y queda disponible entre los íconos de tu panel de visualizaciones. Los pasos son los mismos en Power BI Desktop y en el servicio en el navegador. Te damos el nombre de cada menú en español y, entre paréntesis, en inglés, por si tu Power BI está en ese idioma.

dataset: la única tabla que ve tu especificación

En los visuales nativos de Power BI repartes tus campos en varios pozos: uno para el eje horizontal, otro para el eje vertical y otro para la leyenda. Deneb tiene un solo pozo de datos llamado Values, porque tu especificación en JSON se encarga de decidir en encoding qué campo va en cada eje y qué marca se dibuja.

Aunque tu modelo de Power BI tenga diez tablas con cincuenta columnas, a Deneb solo le llega la tabla que Power BI arma con los campos que arrastraste a Values. Si una columna de tu modelo se quedó fuera de Values, para tu especificación no existe.

Dentro de Deneb, esa tabla que recibe el visual se llama siempre dataset. Sin importar si en tu modelo la tabla original se llama Ventas, Hechos o Sucursales, toda especificación para Deneb pide los datos de la misma manera:

Las columnas de dataset toman el nombre que muestra el visual en el pozo Values:

• Si arrastras la columna Sucursal, en tu especificación escribes "field": "Sucursal".
• Si arrastras una columna numérica y Power BI la resume mostrándola como Suma de Ventas, el campo en dataset se llama "Suma de Ventas", con todo y espacios. Para escribir especificaciones más limpias, conviene hacer doble clic sobre el campo en Values y renombrarlo a Ventas antes de abrir el editor.
• Los acentos y los espacios se conservan tal cual: Categoría llega como Categoría.
• Si el nombre visible incluye un punto (.), corchetes ([ o ]), una diagonal invertida (\) o comillas dobles ("), Deneb reemplaza cada uno de esos caracteres por un guion bajo (_). Por ejemplo, un campo llamado Ventas.MXN se convierte en Ventas_MXN dentro de dataset.

Además, Deneb recibe un máximo de 30,000 filas por omisión. Para los resúmenes de un reporte —como las 6 sucursales, los 6 meses y las 3 categorías de Café La Ceiba, que suman a lo más 108 filas— ese límite sobra. Solo lo alcanzas si arrastras una columna con decenas de miles de registros individuales.

Si tu gráfica sale vacía en Power BI, pégale tu especificación a tu Maestro junto con los nombres de tus campos.

Inténtalo

Imagina que agregaste un visual de Deneb a tu reporte y arrastraste Categoría y Meta al pozo Values. Escribe en una nota o en papel la especificación completa para dibujar una gráfica de barras con la suma de Meta por Categoría.

Revisa tu respuesta contra estos cuatro puntos:

• Los datos piden "data": { "name": "dataset" }.
• La marca es "mark": "bar".
• El eje de categorías usa "field": "Categoría" (con acento en la í) y "type": "nominal".
• El eje numérico usa "aggregate": "sum", "field": "Meta" y "type": "quantitative".