Aquí defines los números: medidas reutilizables, el lenguaje de fórmulas (estilo DAX, en portugués), grupos de cálculo, parámetros "y si", KPI y agrupaciones. Los ejemplos usan el workspace sintético Comércio Aurora Ltda.
Lenguaje de fórmulas (tipo DAX en portugués)#
-
Qué es — un lenguaje de fórmulas con nombres en portugués (
SOMA,SE,ACUM_ANO,CLASSIFICAR) y alias en inglés, con contexto de filtro e inteligencia de tiempo, comparable a DAX. -
Cuándo usarlo — crear medidas como "Ingresos YTD", "Variación vs año anterior", "Ranking de productos", "Participación en el total".
-
Cómo funciona — parser propio (tokenizer → AST, sin
eval) y tres evaluadores: agregado, fila por fila y compilación a SQL del datalake. Son 102 funciones en 7 categorías: matemática, estadística/agregación, lógica, texto, fecha, contexto de filtro (CALCULAR,TUDO,FILTRAR,REMOVER_FILTROS, iteradoresSOMAX/MEDIAX,CLASSIFICAR,PROCV,VALOR_SELECIONADO,PRIMEIROS_N…) e inteligencia de tiempo (ACUM_ANO,MESMO_PERIODO_ANO_ANTERIOR,DESLOCAR_PERIODO,SALDO_FINAL…). Sintaxis brasileña: argumentos separados por;, decimal con coma,VAR … RETORNAR, concatenación con&. División por cero → VACÍO; evaluación perezosa en el contexto de filtro;DATA − DATA(fecha menos fecha) da un error didáctico que pideDATADIF. -
Requisitos previos — columnas/medidas en el modelo para referenciar.
-
Cómo validar — crea
Receita = SOMA(valor)yReceita YTD = ACUM_ANO(MEDIDA('Receita'); calendario.data); pon ambas en un visual por mes y confirma que el acumulado sube dentro del año y vuelve a cero al cambiar de año. -
Límites y salvedades — es un lenguaje tipo DAX genuino (contexto de filtro real), no es DAX completo: no hay tablas virtuales en el motor y la relación vive en el SQL. No afirmamos paridad total con DAX.
-
Datos de ejemplo (sintéticos)
mes Receita Receita YTD 2026-01 1000 1000 2026-02 1500 2500 -
Evidencia — motor de fórmulas cubierto por una amplia suite determinística (contexto de filtro, ranking, inteligencia de tiempo, matriz, calendario fiscal, transición) y congelado por el conjunto de pruebas de referencia, con resultado idéntico en cada ejecución.
Editor de fórmulas (autocompletado + validación en vivo)#
- Qué es — un editor con autocompletado, validación en vivo y ayuda/ejemplo por función.
- Cuándo usarlo — al escribir cualquier medida o columna calculada.
- Cómo funciona — valida mientras escribes, con
FormulaErroren pt-BR; bloquea errores clásicos (p. ej., "coluna solta em medida agregada" — columna suelta en medida agregada). - Requisitos previos — nada además del modelo.
- Cómo validar — empieza a escribir
CLASS…y confirma la sugerenciaCLASSIFICAR; escribe una medida inválida y mira el error en portugués. - Límites y salvedades — la validación es sintáctica/semántica local; el costo real de la consulta solo aparece en la ejecución.
- Datos de ejemplo (sintéticos) —
Ticket médio = DIVIDIR(MEDIDA('Receita'); CONT(vendas.id)). - Evidencia — motor de validación de fórmulas (errores en pt-BR) cubierto por una suite determinística; el renderizado del editor no tiene prueba visual.
Cómo aparece el editor de fórmulas en pantalla
El editor se abre encima del panel, con espacio para la fórmula, la búsqueda y la vista previa. Es el mismo para Nueva medida (fórmula), Nueva columna calculada y Editar fórmula (consulta Campos, medidas y variables).
- El nombre técnico (solo letras, números y _), con el que otra fórmula llama a esta, y el alias en la tarjeta, que puede tener espacios, tildes y %.
- Cómo aparece el número: 0,00 · Número, mil/M · Número corto, % · Porcentaje, R$ · Moneda, R$ mil/M · Moneda corta.
- "Buscar función…" busca en las funciones por categoría. Cada función muestra
también el nombre equivalente de Power BI (por ejemplo,
ARREDyROUND) — el motor acepta los dos. - Las Medidas que ya existen quedan a mano para usarlas en la fórmula.
- La vista previa usa el mismo formato de la tarjeta: lo que ves es lo que va a aparecer.
- Guardar, Cancelar y, en una fórmula existente, Eliminar (con confirmación).
La barra de fórmulas
En edición, justo debajo de la barra de menús, hay una barra del ancho de la pantalla.
Haz clic en un campo de la lista Valores del panel del visual y muestra de
dónde viene: tabela.coluna, la fórmula de la medida o el aviso de que el dato
todavía no llegó. Sin campo elegido, dice "Haz clic en un campo de la lista de valores para ver de dónde viene."
- Arrastra el borde inferior para estirar la barra y leer fórmulas largas.
- Doble clic en el borde vuelve al tamaño por defecto.
- La × la limpia.
Biblioteca de medidas centrales#
- Qué es — medidas declaradas una sola vez en el modelo y reutilizadas por
referencia (otra medida cita
MEDIDA('Receita'); el widget citameasureId). - Cuándo usarlo — para acabar con el "ticket promedio" escrito en 10 widgets que divergen en silencio.
- Cómo funciona — CRUD con informe de impacto (quién usa la medida),
grafo de dependencias y detección de ciclos con el camino completo; carpetas,
descripción, sello
certified,hidden. Limpieza en el camino de escritura (cleanModelForSave). - Requisitos previos — modelo del dashboard (o modelo central del workspace).
- Cómo validar — crea la medida central "Receita"; úsala en tres visuales; edita la fórmula y confirma, en el informe de impacto, los tres visuales listados antes de guardar.
- Límites y salvedades — la biblioteca entre dashboards depende del modelo central por workspace (consulta Modelo semántico).
- Datos de ejemplo (sintéticos) — "Receita" (usada en 3 widgets) →
"Ticket médio" que cita
MEDIDA('Receita'). - Evidencia — biblioteca de medidas e informe de impacto (grafo de dependencias + detección de ciclos) cubiertos por una suite determinística.
Grupos de cálculo (calculation groups)#
- Qué es — un grupo (p. ej., "Tiempo" con los ítems Realizado / Año anterior / YTD) que se aplica a cualquier medida sin reescribir la fórmula.
- Cuándo usarlo — ofrecer "Realizado × Año anterior × YTD" para todas las medidas desde un selector único.
- Cómo funciona —
MEDIDAen el ítem se sustituye por la medida base. Cuando dos grupos se aplican a la misma medida (p. ej., "Tiempo" × "Moneda"), el orden sigue una precedencia determinística: mayor precedencia = función más externa. Los errores nunca son una elección silenciosa: un grupo/ítem inexistente, repetido o un empate de precedencia se rechazan (como en Power BI). - Requisitos previos — al menos una medida base y el grupo declarado.
- Cómo validar — crea los grupos "Tiempo" y "Moneda" con precedencias diferentes; aplica ambos a "Receita" y confirma el anidamiento en el orden esperado; fuerza precedencias iguales y mira el rechazo por empate.
- Límites y salvedades — solo es armado de texto (aquí no se evalúa nada); el conjunto de pruebas de referencia permanece idéntico.
- Datos de ejemplo (sintéticos) — "Tiempo"[YTD] × "Moneda"[USD] sobre "Receita".
- Evidencia — grupos de cálculo (precedencia determinística, rechazo de empates) cubiertos por una suite determinística y congelados por el conjunto de pruebas de referencia.
Parámetros (campo, medida y "y si"/what-if)#
- Qué es — parámetros centralizados de tres tipos: field (cambia qué campo usa el visual), measure (elige qué medida central mostrar) y what-if (un número con nombre, "y si el descuento fuera X%").
- Cuándo usarlo — un selector "ver por: ingresos · pedidos · ticket" que reemplaza tres visuales casi idénticos; o simular escenarios de descuento.
- Cómo funciona — se declaran una vez en el modelo con un id estable
p…; la selección del lector viaja en la URL/marcador (no queda en el modelo), así que renombrar el parámetro no rompe el estado guardado. - Requisitos previos — campos/medidas para ofrecer; para what-if, la medida que consume el número.
- Cómo validar — crea un field parameter "Ver por" con [ingresos, pedidos, ticket] y confirma que cambiar la opción cambia la serie del visual; comparte la URL y confirma que la elección se restaura.
- Límites y salvedades — un segmentador de parámetro no recorta filas (cambia campo/medida/valor); recortar filas es tarea de los otros segmentadores (consulta Filtros e interacciones).
- Datos de ejemplo (sintéticos) — what-if
desconto= 10% aplicado en "Receita líquida = MEDIDA('Receita') * (1 - desconto)". - Evidencia — parámetros (field/measure/what-if) y su aplicación al visual cubiertos por una suite determinística; la selección del lector viaja en el estado de la URL.
KPI en el modelo#
- Qué es — el KPI del modelo semántico: un valor objetivo incorporado en el indicador del panel, con dirección y formato.
- Cuándo usarlo — cuando el panel necesita mostrar "realizado frente al objetivo" en el propio visual.
- Cómo funciona — el objetivo vive en el KPI (modelo semántico) y el visual dibuja la comparación. No depende de una pantalla aparte.
- Límites y salvedades — el KPI no dispara alertas por sí mismo; las alertas son por visual — consulta Exportación y distribución.
- Nota histórica — existió una pantalla Metas (scorecard) en
/metas, con la meta registrada aparte (objetivo, plazo, responsable). Se quitó del producto el 26/09/2026; hoy el seguimiento del objetivo es el KPI del panel.
Agrupación y binning#
- Qué es — agrupar valores en rangos (por ancho o cantidad), listas o clusters.
- Cuándo usarlo — transformar un
ticketcontinuo en rangos ("0-50", "50-100", "100+") o agrupar ciudades en una lista "Capitales". - Cómo funciona — rangos por ancho/cantidad, agrupación por lista y cluster, aplicables a las dimensiones del visual.
- Requisitos previos — la columna a agrupar en el modelo.
- Cómo validar — crea rangos de
valorcon ancho 50 y confirma los grupos en un histograma. - Límites y salvedades — el binning opera sobre el dato del snapshot/consulta del visual.
- Datos de ejemplo (sintéticos) — valores {30, 60, 120} → rangos {"0-50":1, "50-100":1, "100+":1}.
- Evidencia — agrupación y binning (rangos, listas, clusters) cubiertos por una suite determinística.