Sintaxis de fórmulas

Para qué sirve el editor de fórmulas

El editor de fórmulas te permite construir un cálculo personalizado a partir de tokens tecleados — operadores, números y referencias a filas, drivers, sub-posiciones y KPIs. Mismo editor, misma sintaxis, en cada método Fórmula en cualquier punto de la app: filas de Planificación, drivers de Planificación, KPIs y dashboards personalizados.

En resumen

Teclea un número u operador para soltar un token. Teclea un nombre para autocompletar una referencia. Cada referencia lleva un desplazamiento temporal opcional (este mes / mes anterior / hace 1 año / Personalizado) y, con el add-on Departamentos, un scope de origen para referencias cross-departamento.

Tokens

Una fórmula es una secuencia plana de tokens. La rejilla renderiza cada token como chip; Backspace sobre un input vacío quita el último chip.

Números

Teclea cualquier número (100, 0.05, -1.2) y pulsa Enter para soltarlo como token numérico.

Operadores

Los cinco operadores binarios y los paréntesis:

+   -   *   /   ^   (   )

Teclea uno con el campo vacío y el editor lo inserta de inmediato. Teclea una secuencia tipo (precio * volumen) / 12 y pulsa Enter en cada token.

Funciones

Hay tres funciones disponibles. Teclea el nombre y el editor suelta un esqueleto de función para que lo rellenes:

  • abs( ) — valor absoluto de una sola expresión, por ejemplo abs(Revenues - Plan).
  • min( , ) — el menor de dos expresiones, por ejemplo min(Cash, 0).
  • max( , ) — el mayor de dos expresiones, por ejemplo max(EBT, 0).

abs toma un argumento; min y max toman exactamente dos y comparan valores en el mismo período (no operan sobre una ventana).

Referencias

Empieza a teclear el nombre de una posición, sub-posición, cuenta, driver o KPI. El dropdown de autocompletar se afina en cada keystroke; pulsa Enter para insertar el mejor match, o haz clic en cualquier resultado para insertarlo directamente. Dentro de la fórmula, la referencia se renderiza como un chip con la etiqueta de la fila.

Las referencias se eligen desde un selector de navegación agrupado por origen: PyG, BS, CF, KPIs, además de drivers y sub-posiciones auxiliares. Con el add-on Departamentos, aparece una pestaña de origen adicional (ver Referencias cross-departamento más abajo).

Time offsets

Cada referencia lleva un desplazamiento temporal — el período del que la referencia lee, relativo a la celda actual.

Pulsa la píldora de offset en cualquier chip de referencia para elegir:

  • este mes — month(0) (por defecto)
  • mes anterior — month(-1)
  • hace 1 año — month(-12)
  • Personalizado — abre un modal donde defines el número de meses y la dirección (siguiente / anterior), así por ejemplo month(-3) o month(+6) quedan al alcance

Los desplazamientos temporales se resuelven en evaluación: Revenues@month(-12) lee el valor de Ingresos doce meses antes de la celda que se está calculando.

Ventanas de agregación

Además de un desplazamiento temporal, cada referencia puede llevar una agregación de ventana móvil — en lugar de leer un solo período, la referencia lee una ventana deslizante y la reduce a un único valor. Pulsa el control de agregación en un chip de referencia para elegir:

  • Suma — totaliza la referencia sobre la ventana (se renderiza como por ejemplo Σ 12M).
  • Media — la media de la referencia sobre la ventana (se renderiza como por ejemplo avg 3M).

La longitud de la ventana es L3M (últimos 3 meses), L6M, L12M o Personalizado (defines tu propio número de meses). Una Suma sobre L12M da un total de los últimos doce meses; una Media sobre L3M suaviza una serie mensual con ruido. La agregación se combina con el desplazamiento temporal — la ventana se mide hacia atrás desde el período del offset.

Referencias cross-departamento

En contextos que abarcan varios departamentos (add-on Departamentos), el picker expone una pestaña de origen adicional encima de la lista de referencias:

  • Departamentos — elige el slice de un departamento concreto como origen. Las referencias cross-dept se renderizan con un prefijo de short-code en el chip para que veas qué departamento se está leyendo.
  • Todos los departamentos — una opción agregada que suma la referencia entre todos los departamentos.

El chip muestra solo el short-code del origen; la pestaña de origen del picker es donde lo cambias.

Controles del editor

Dentro del editor:

  • Enter — inserta el token tecleado (número / operador / mejor match de autocompletar), o confirma la fórmula cuando el input está vacío
  • Escape — descarta la edición actual
  • Backspace con input vacío — quita el último chip

Validación

statycs valida fórmulas de forma continua. Los errores aparecen como un badge rojo ! junto a la fórmula, con un tooltip describiendo la causa:

  • Referencia circular — la fórmula referencia a su propia fila, directamente. Los ciclos transitivos (A → B → A entre posiciones) no se detectan hoy.
  • Referencia rota — la fila, sub-posición o driver al que apunta la fórmula ya no existe. Abre la fórmula y elimina o reemplaza el chip.
  • División por cero — el denominador evalúa a cero en uno o más períodos. Envuelve el denominador en una guarda o elige otra referencia.
  • Offset fuera del dataset — un desplazamiento temporal (por ejemplo month(-12)) apunta a un período antes del inicio de los datos disponibles. Aparece como aviso; reduce el offset o acepta los períodos faltantes.

Los errores no bloquean el guardado. Las celdas afectadas evalúan a cero hasta que el error se arregla, así que una fórmula parcialmente rota no te detiene — simplemente no aporta valor.

Relacionado