Skip to content

Plantillas de Deneb y lo que sigue

Guarda tu mancuerna como plantilla para reusarla con otros campos, revisa lo que ya sabes hacer y escoge tu siguiente paso.

3 partes · 4, 3 y 3 min

Curso gratis. Tu Maestro, una IA, .

Ya tienes una gráfica de mancuerna que funciona para Café La Ceiba. El mes que entra, otro reporte va a necesitar esa misma comparación entre meta y resultado, pero con otros campos: "Región" en vez de "Sucursal", "Presupuesto" en vez de "Meta" y "Real" en vez de "Ventas". En una gráfica con tres capas (layer), buscar y cambiar cada nombre a mano dentro del toma tiempo y cualquier acento que falte deja una capa en blanco. Para reusar tu trabajo sin editar el código cada vez, Deneb te permite guardar la especificación como plantilla.

Una plantilla de Deneb guarda tu especificación de con dos ajustes: agrega al inicio una ficha descriptiva (usermeta) y reemplaza los nombres de tus campos por marcadores como __dataset.0__ o __dataset.1__. Tus datos de Café La Ceiba se quedan en tu reporte y nunca viajan dentro del archivo .json. Gracias a eso, puedes compartir la plantilla con otra área de tu empresa sin exponer cifras ni filas de tu tabla.

Este es el recorrido completo para exportar una plantilla desde tu gráfica y abrirla en un reporte distinto:

  1. Exporta tu especificación

    En el editor avanzado de Deneb, selecciona el comando "Generate JSON Template". Escribe un nombre y una descripción que expliquen cuándo usar la gráfica; también puedes registrar el autor y agregar una imagen de vista previa.

  2. Nombra los marcadores

    Deneb convierte cada campo de tu dataset en un marcador como __dataset.0__ y muestra su tipo de dato. Ponle a cada marcador un nombre y una nota que expliquen qué papel juega en la gráfica, como "Categoría que compara" o "Medida real".

  3. Descárgala o cópiala

    Descarga el archivo .json a tu computadora o haz clic en el botón "Copy". Si las políticas de Power BI en tu organización bloquean la descarga de archivos desde un objeto visual, el botón para copiar el texto siempre está disponible.

  4. Ábrela en otro reporte

    Agrega un visual de Deneb nuevo, arrastra las columnas y medidas del nuevo reporte al cuadro "Values", entra a "Create New Specification" y escoge "Existing template". Busca tu archivo .json o pega el texto copiado y asigna un campo a cada marcador.

Cuando exportas la plantilla, Deneb arma por ti el objeto usermeta al principio del archivo. Ahí anota tres bloques de información:

  • deneb: la versión con la que se creó (build), la versión del formato de metadatos (metaVersion) y el motor de la gráfica ("provider": "vegaLite").
  • information: el nombre de la plantilla (name), su descripción (description), quién la hizo (author), un identificador único (uuid) y la fecha en que se generó (generated).
  • datasets: la lista de marcadores dentro de dataset, donde cada clave como __dataset.0__ guarda el nombre amigable que escribiste al exportar.

Si la especificación original tenía una línea $schema en la raíz, Deneb la quita automáticamente al importar la plantilla. En ese momento te pide conectar cada marcador con uno de los campos que pusiste en "Values". Fíjate bien en qué tipo de campo espera cada lugar: un marcador creado a partir de una columna solo acepta columnas, y un marcador creado a partir de una medida solo acepta medidas.

mancuerna-plantilla.jsonlíneas 2–5
{Inicio de las líneas 2–5.   "usermeta": {    "deneb": { "build": "2.0.0", "metaVersion": 2, "provider": "vegaLite" },    "information": { "name": "Mancuerna meta contra real", "description": "Una fila por categoría con meta, real y la distancia entre los dos." },    "datasets": { "dataset": [ { "key": "__dataset.0__", "name": "Categoría que compara" } ] } Fin de las líneas 2–5.  },  "data": { "name": "dataset" },  "encoding": {    "y": { "field": "__dataset.0__", "type": "nominal", "title": null }  }}
Un esquema simplificado de una plantilla: la ficha va en usermeta y los campos se vuelven marcadores. Deneb escribe la ficha completa por ti al exportar.

Nota: Por qué esta página muestra la plantilla como código

El visor de gráficas del curso rechaza especificaciones con usermeta porque ese bloque está reservado para opciones internas del objeto visual. Deneb lo lee al importar la plantilla y usa lo que sigue desde data como tu especificación normal.

Comprueba lo que sabes: Exportas tu gráfica de mancuerna de Café La Ceiba como plantilla .json y se la mandas a una compañera que lleva el reporte de otra división. ¿Qué recibe ella en ese archivo y qué le va a pedir Deneb al importarlo?

Buen lugar para parar. Después: parte 2 de 3 · 3 min

Inténtalo

Planea cómo convertirías la mancuerna completa de Café La Ceiba en una plantilla lista para que cualquier persona de tu equipo la use sin abrir el editor de código. Responde estas tres preguntas para tu diseño:

  1. ¿Cuántos marcadores se crean en datasets al exportar la mancuerna y a qué campo original corresponde cada uno?
  2. ¿Qué nombre le pondrías a cada marcador para que alguien que nunca vio Café La Ceiba sepa qué campo escoger cuando arme un reporte con "Región", "Presupuesto" y "Real"?
  3. ¿En cuántas capas (layer) de la especificación aparece cada marcador?

Una buena respuesta tiene tres marcadores: una columna para la categoría que se compara y dos medidas, la meta y el real, con nombres que digan cuál es cuál.

Si quieres revisar cómo nombraste tus marcadores antes de exportar tu propia plantilla en Power BI, escríbeselos a tu Maestro.

Lo que ya sabes hacer

Con esto cierras el recorrido completo para diseñar y mantener gráficas a la medida en Power BI:

  • Lees cualquier especificación de Vega-Lite ubicando sus tres partes: data, mark (o layer) y encoding.
  • Agregas Deneb a tu reporte, pasas columnas y medidas a "Values" y calculas cuántas filas recibe dataset según las combinaciones de tus campos.
  • Escoges el tipo adecuado para cada canal (nominal, ordinal, quantitative, temporal) y aplicas los colores del tema del reporte con pbiColorNominal.
  • Armas gráficas por capas que el panel de Power BI no incluye: barras con etiquetas al final, mancuernas de meta contra real y diagramas de Gantt con fechas de inicio y fin.
  • Conectas tus gráficas con el resto del reporte mediante tooltips y filtro cruzado usando __selected__.
  • Le pides especificaciones a tu IA con las reglas de Deneb, corriges los errores de nombres, tipos, sumas y colores antes de pegar, y guardas el resultado como plantilla.

Para cerrar, responde de nuevo la pregunta con la que empezó el curso.

Comprueba lo que sabes, Punto de llegada: ¿Qué hace Deneb dentro de Power BI?

Buen lugar para parar. Después: Lo que sigue · 3 min

Lo que sigue

Con lo que practicaste en estos cuatro módulos tienes todo lo necesario para crear, revisar y reusar tus propias gráficas con Deneb en tu trabajo diario.

Si quieres profundizar en el diseño visual para elegir siempre la representación más clara, el curso gratuito ¿Qué gráfica uso? te enseña a escoger la gráfica a partir de la pregunta que quieres responder y a detectar ejes o escalas que distorsionan la comparación.

Si te interesa automatizar todavía más el trabajo con inteligencia artificial, el curso opcional Construye tu copiloto de visualización de datos te muestra cómo guardar tus criterios de diseño, tu audiencia y tu lista de revisión en archivos que tu agente consulta cada vez que te arma una gráfica.

Si no sabes cuál te conviene, cuéntale a tu Maestro qué haces en tu trabajo.

Reflexiona: Piensa en un reporte que hiciste este mes. ¿Qué gráfica le pusiste porque era la que había en el panel, y cuál le hubieras puesto si pudieras dibujar cualquiera?

Reflexiona: Piensa en un reporte que hiciste este mes. ¿Qué gráfica le pusiste porque era la que había en el panel, y cuál le hubieras puesto si pudieras dibujar cualquiera?

Solo tú y tu Maestro leen esto. Se queda en tu cuenta y se borra con ella.

Escribe tu respuesta

Solo tú y tu Maestro leen esto. Se queda en tu cuenta y se borra con ella.

Aquí termina la lectura; tu Maestro sigue.