Fórmulas y campos calculados
Construye respuestas calculadas de solo lectura a partir de campos numéricos y columnas de fuentes de datos.
Video próximamente
Fórmulas y campos calculados
id: academy-formulas · ~2–4 min
Audiencia: Administrador
Los campos Fórmula calculan una respuesta numérica a partir de otras entradas. Son solo lectura para el personal de campo—el valor se actualiza en vivo al cambiar las dependencias y se guarda como cualquier otra respuesta al enviar el formulario.
Agregar un campo fórmula
Arrastra Fórmula desde la caja de herramientas al lienzo. En el editor, escribe una expresión e inserta referencias con menciones @ desde el selector (Campos y columnas de fuente de datos).
Ejemplo de subtotal:
@cantidad * @precio_unitarioEjemplo de total con impuesto y descuento:
(@subtotal * (1 + (@porcentaje_impuesto / 100))) - (@subtotal * (@porcentaje_descuento / 100))Sintaxis de referencias
| Referencia | Significado |
|---|---|
@codigo_campo | Un campo numérico del formulario (Número, Rango, Calificación, otra Fórmula) |
@campo_lista.clave_columna | Una columna numérica de una fila seleccionada en Lista / Fuente de datos |
Solo aparecen en el selector fuentes compatibles con números: entradas numéricas, rangos, calificaciones, otras fórmulas y columnas de lista con tipo number, numeric, integer o decimal.
Ejemplo con lista:
@equipo.precio * @cantidadEl builder guarda referencias estables por ID internamente; editas con códigos @ amigables. Renombrar un código de campo actualiza las referencias visibles mientras los IDs mantienen las fórmulas.
Operadores y funciones
Operadores: + - * / % ^, con paréntesis para agrupar.
Funciones del toolbar incluyen:
| Función | Ejemplo |
|---|---|
sum() | sum(@a, @b, @c) |
avg() | avg(@puntaje_1, @puntaje_2) |
min() / max() | min(@precio_a, @precio_b) |
round() | round(@subtotal) |
abs() | abs(@variacion) |
Las constantes pi y e están soportadas cuando aplican.
Siempre pon un operador entre referencias—@cantidad * @precio_unitario, no @cantidad @precio_unitario.
Decimales y formato de visualización
- Decimales — redondeo opcional del resultado numérico guardado (por ejemplo
2→12.35desde12.3456). Déjalo sin definir para precisión completa. - Formato — solo visualización: Número, Moneda (USD vía formato regional) o Porcentaje (
0.15se muestra como15%).
El formato no cambia el número subyacente guardado salvo que definas redondeo en Decimales.
Evitar dependencias circulares
Una fórmula no puede depender de sí misma, directa o indirectamente.
Inválido:
total = @subtotal + @impuesto
subtotal = @total - @impuestoEl builder marca fórmulas circulares y detiene el cálculo hasta romper el ciclo.
Comportamiento en ejecución y envío
Al editar campos referenciados, la fórmula se reevalúa y escribe el número calculado en la respuesta. Al enviar, el valor se guarda bajo su código de campo como cualquier otra respuesta.
Si el cálculo falla (valor faltante, entrada no numérica, sintaxis inválida, referencia desconocida), la UI muestra error y el valor guardado queda vacío hasta que las entradas sean válidas.
Consejos
- Coloca campos origen arriba de la fórmula para que llenen dependencias primero.
- Habilita solo columnas de Fuente de datos que las fórmulas necesiten—menos columnas, selector
@más limpio. - Usa
round()o Decimales para líneas de dinero; Moneda para PDFs y reportes legibles. - Tras cambiar vínculos de listas, revisa fórmulas que referenciaban columnas eliminadas.