Todos los Operadores y Funciones de Fórmulas de Quire Permalink
Esta guía ofrece una referencia completa de todos los operadores y funciones disponibles en las fórmulas de Quire, con explicaciones claras y ejemplos prácticos para ayudarte a construir cálculos potentes, condiciones y lógica de tareas.
Operadores Numéricos
Los operadores numéricos permiten calcular valores almacenados en campos de tipo numérico.
| Operadores | Qué hace | Ejemplo |
|---|---|---|
| + | Suma valores | timeSpent + 100 |
| - | Resta valores | Cost - 100 |
| * | Multiplica valores | Cost * 100 |
| / | Divide valores | Cost / 100 |
| % | Calcula el resto | Cost % 3 |
| ^ | Calcula la potencia | Cost ^ 3 |
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
Operadores de Texto
Los operadores de texto permiten combinar o concatenar cadenas de texto en una sola salida.
| Operadores | Qué hace | Ejemplo |
|---|---|---|
| + | Concatena texto | 'This is' + 'a task' |
Operadores de Comparación
Los operadores de comparación devuelven true o false según la relación entre dos valores.
| Operadores | Significado | Ejemplo |
|---|---|---|
| < | Menor que | 3 < 1 -> False |
| > | Mayor que | 4 > 3 -> True |
| <= | Menor o igual que | 4 <= 2 -> False |
| >= | Mayor o igual que | 5 >= 1 -> True |
| = | Igual a | 2 = 2 -> True |
| != | Distinto de | 3 != 2 -> True |
Operadores Lógicos
not
Invierte un resultado verdadero/falso.
Ejemplo:
Not (Cost > 50)
Si Cost es mayor que 50, el resultado es false. De lo contrario, devuelve true.
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
in
Usa in para comprobar si los valores de la primera lista están completamente contenidos en la segunda.
Ejemplo:
assignees in subtasks.assignees
Devuelve true si todos los asignados de la tarea también están asignados a sus subtareas.
&
Encuentra y devuelve los valores comunes entre dos listas.
Ejemplo:
assignees & subtasks.assignees
Devuelve los asignados compartidos por la tarea y sus subtareas.
and
Evalúa todas las condiciones y devuelve true solo si se cumplen todas.
Ejemplo:
(Cost > 50) and (due > <today>)
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
or
Comprueba cada condición y devuelve true si alguna tiene valor.
Ejemplo:
Cost or Budget
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
Operadores de Lista
[field, field]
Usa corchetes para combinar múltiples valores en una lista.
Ejemplo:
[me, #23.assignees, subtasks.assignees]
Devuelve una lista con mi usuario, los asignados a la tarea con ID#23 y todos los asignados de las subtareas.
Obtén más información sobre las fórmulas de array de Quire que te permiten listar o realizar cálculos sobre una colección de datos.
field[index]
Accede a los elementos de una lista por índice (empezando por 0).
Ejemplo:
subtasks[3]
Devuelve la 4.ª subtarea.
order by
Ordena las tareas según un campo especificado.
Ejemplo:
subtasks order by any.Cost
Devuelve una lista de las subtareas ordenadas según los valores de su campo Cost.
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
Consejo: También puedes especificar el orden de clasificación añadiendo asc o desc al final de la expresión. Por ejemplo: subtasks order by any.Cost asc.
map
Aplica un cálculo a cada elemento de una lista.
Ejemplo:
subtasks map any.Cost * 2
Devuelve una lista con los valores del campo Cost de las subtareas multiplicados por 2.
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
Consejo: Puedes usar el identificador any con el operador map para indicar el campo que deseas calcular.
Operadores Condicionales
??
Comprueba si la tarea cumple la expresión que precede al ?? y devuelve un valor verdadero/falso. Si la tarea no coincide con la expresión, devuelve el valor de la expresión que sigue al ??.
Ejemplo:
(Cost > 10) ?? 'Reconsiderar'
Si el valor del campo Cost es mayor que 10, devuelve true. Si es menor que 10, devuelve false. Cuando no se ha introducido ningún valor en Cost, mostrará “Reconsiderar”.
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
?:
Comprueba si la tarea cumple la expresión que precede al ? y devuelve la expresión que le sigue. Si la tarea no cumple la expresión anterior al ?, devuelve la expresión que sigue a :.
Ejemplo:
(Cost > 10) ? 'Muy caro': 'Reconsiderar'
Si el valor del campo Cost es mayor que 10, mostrará “Muy caro”. Si es menor que 10 o no se ha introducido ningún valor, mostrará “Reconsiderar”.
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
Filtrado y Limitación de Resultados
where
Filtra las tareas que cumplen criterios específicos.
Ejemplo:
subtasks where any.Cost > 10
Se listarán las subtareas cuyo valor de Cost sea mayor que 10.
Nota: Debes crear un campo personalizado numérico (p. ej. Cost) antes de usarlo en fórmulas.
Consejo: Puedes usar el identificador any con el operador where para especificar el campo por el que deseas filtrar.
limit
Limita el número de tareas devueltas tras el ordenamiento.
Ejemplo:
subtasks order by desc any.timeSpent - any.estimated limit 3
Listará las 3 subtareas con mayor tiempo invertido respecto al tiempo estimado.
Precedencia de Operadores
En algunos casos, el orden de los cálculos puede afectar al valor devuelto por la fórmula, por eso es importante entender el orden de las operaciones en Quire. Si combinas distintos operadores en una fórmula, Quire realizará las operaciones en el orden indicado en la tabla siguiente. Si la fórmula contiene operadores con el mismo nivel de precedencia, Quire calculará de izquierda a derecha.
| Operador | Descripción |
|---|---|
( ).[ ]( ) |
Paréntesis Operador punto Lista (Array) Llamada a función |
+ - not |
Operadores unarios |
^ |
Exponenciación |
* / % |
Multiplicación y división |
+ - |
Suma y resta |
< > <= >= in & |
Operadores de comparación |
= != |
Operadores de igualdad |
not |
Operador lógico not |
and |
Operador lógico and |
or |
Operador lógico or |
?? |
Operador condicional |
where |
Operador de filtro |
?: |
Operador condicional |
Todas las Funciones Integradas
| Función | Descripción | Ejemplo | Resultado esperado |
|---|---|---|---|
| SUM() | Devuelve la suma de los valores. | SUM(subtasks.estimated) |
Suma todos los valores de los campos de Estimación de las subtareas de la tarea. |
| MAX() | Devuelve el valor más grande de un conjunto de valores. | MAX(subtasks.estimated) |
Muestra el valor más grande encontrado en los campos de Estimación de las subtareas de la tarea. |
| MIN() | Devuelve el valor más pequeño de un conjunto de valores. | MIN(subtasks.estimated) |
Muestra el valor más pequeño encontrado en los campos de Estimación de las subtareas de la tarea. |
| AVG() | Devuelve el valor promedio de los números. | AVG(subtasks.estimated) |
Calcula el promedio de los campos de Estimación de las subtareas de la tarea. |
| COUNT() | Devuelve el número de elementos. | COUNT(subtasks) |
Muestra el número total de subtareas. |
| SORT() | Devuelve los argumentos en orden. | SORT(subtasks.estimated) |
Muestra todos los valores de los campos de Estimación de las subtareas de la tarea en orden. |
| DISTINCT() | Elimina valores duplicados y devuelve solo los valores únicos. | DISTINCT(subtasks.estimated) |
Muestra todos los valores únicos de los campos de Estimación de las subtareas de la tarea y elimina los duplicados. |
| ISEMPTY() | Comprueba si los argumentos están vacíos y devuelve un valor verdadero/falso. | ISEMPTY(estimated) |
Si el campo de Estimación de la tarea está vacío, mostrará una casilla marcada. |
| ISNOTEMPTY() | Comprueba si los argumentos están vacíos y devuelve un valor verdadero/falso. | ISNOTEMPTY(estimated) |
Si el campo de Estimación de la tarea no está vacío, mostrará una casilla marcada. |
Preguntas Frecuentes
¿Qué operadores aritméticos puedo usar en las fórmulas de Quire?
Quire admite +, -, *, /, % (resto) y ^ (potencia). Debes crear un campo personalizado numérico antes de referenciarlo en una fórmula.
¿Qué funciones integradas están disponibles en las fórmulas de Quire?
Quire incluye SUM(), MAX(), MIN(), AVG(), COUNT(), SORT(), DISTINCT(), ISEMPTY() e ISNOTEMPTY(). Consulta la referencia completa en Todas las Funciones Integradas.
¿Cómo funciona la precedencia de operadores en las fórmulas de Quire?
Quire evalúa los operadores en este orden: primero paréntesis y operadores punto/lista, luego exponenciación, multiplicación/división, suma/resta, comparación, lógicos y, por último, condicionales. Usa paréntesis para modificar el orden predeterminado.
¿Cómo escribo una fórmula IF/condicional en Quire?
Usa ?: para un condicional de dos resultados — (Cost > 10) ? 'Muy caro' : 'Reconsiderar'. Usa ?? como alternativa solo cuando el campo esté vacío.
¿Cómo filtro subtareas por el valor de un campo en una fórmula de Quire?
Usa el operador where — subtasks where any.Cost > 10 devuelve las subtareas en las que Cost supera 10. Combínalo con limit para limitar el número de resultados.
¿Cómo ordeno o reordeno una lista en una fórmula de Quire?
Usa order by — subtasks order by any.Cost ordena por el campo Cost. Añade asc o desc para controlar la dirección.
¿Cómo aplico un cálculo a cada elemento de una lista en Quire?
Usa el operador map — subtasks map any.Cost * 2 multiplica el valor Cost de cada subtarea por 2.