Guía de Fórmulas de Quire Permalink
Las Fórmulas en Quire te permiten tomar los datos existentes de tareas o proyectos y calcular nuevos valores de forma automática. Puedes hacer referencia a campos integrados o Campos personalizados, aplicar operadores o funciones, y mostrar resultados numéricos o de texto dentro de un campo personalizado.
Escribir una Fórmula
En el plan de Subcripción Free, puedes añadir una fórmula al campo personalizado por cada proyecto. Actualiza tu plan de Subcripción para añadir más fórmulas. Más información en nuestra página de precios.
Para escribir una fórmula, primero debes crear un campo personalizado de tipo Fórmula. Una vez creado, puedes introducir una fórmula que haga referencia a los valores existentes y devuelva un resultado calculado.
Por ejemplo, si quieres dividir el tiempo dedicado a tu tarea entre 2:
timeSpent/2
Quire calculará automáticamente el valor para cada tarea y mostrará el resultado en el campo personalizado.
Aprende cómo crear un campo personalizado para añadir tus fórmulas.
Realizar Cálculos con Fórmulas
Operadores Aritméticos
Puedes realizar cálculos aritméticos comunes usando los siguientes operadores:
- Suma:
+ - Resta:
- - Multiplicación:
* - División:
/
Por ejemplo, para calcular la duración de la tarea restando la Fecha de Inicio de la Fecha de Vencimiento:
due - start
Consejo: Usa paréntesis ( ) para controlar el orden de los cálculos. Por ejemplo, si escribes algo como (due - start) *2, la resta de la Fecha de Vencimiento y la Fecha de Inicio tendrá prioridad sobre la multiplicación por 2.
Funciones
Las funciones ofrecen una forma más rápida de realizar cálculos avanzados.
Por ejemplo, para calcular el total de Hora dedicada y Tiempo estimado:
SUM(timeSpent, estimated)
También puedes usar operadores de comparación para obtener resultados lógicos.
priority >= high
Esto comprueba si la Prioridad de una tarea es mayor o igual a High.
Consulta todos los operadores y funciones disponibles que puedes usar en las Fórmulas de Quire.
Buenas Prácticas para Escribir Fórmulas
Operador Punto
El operador punto . permite recuperar valores específicos de objetos relacionados.
Por ejemplo, para listar todos los nombres de las subtareas:
subtasks.name
Otro ejemplo: para obtener la Prioridad de una tarea padre:
parent.priority
Consejo: Hemos listado todos los campos disponibles que puedes especificar.
Nombres de Campo con Espacios
Al nombrar tus Campos personalizados, debes evitar los siguientes caracteres: comillas ("), barra invertida (\) y llaves de cierre (}).
Al hacer referencia a Campos personalizados en fórmulas:
- Los nombres de campo sin espacios se pueden usar directamente
- Los nombres de campo con espacios o caracteres especiales (incluidos
@,#,&, etc.) deben encerrarse entre llaves{ }
Por ejemplo, si añadiste un campo llamado Cost:
Cost *2
{Cost} *2
Si el nombre de tu campo incluye espacios, debes encerrarlo entre llaves { }:
{Schedule Variance} *2
Nota: No se distingue entre mayúsculas y minúsculas, por lo que escribir cost o Cost es equivalente.
Texto en los Resultados
Para incluir texto en los resultados de una Fórmula, encierra siempre las cadenas de texto entre comillas.
Por ejemplo, si añadiste dos Campos personalizados, uno para el ID del elemento y otro para el nombre:
id + ":" + name
Esto muestra el ID y el nombre separados por dos puntos.
Identificadores para MIEMBROS, Tareas y Etiquetas
Puedes hacer referencia a entidades específicas mediante identificadores:
- Miembro:
@member_username - Tarea:
#task_id - Etiqueta:
#tag_name - proyecto:
#{project_id}
Por ejemplo, para consultar la Fecha de Vencimiento de la tarea con ID 23:
#23.due
Nota: No se permiten espacios entre # y el ID.
Otro ejemplo: si quieres saber cuánto tiempo ha dedicado todo el proyecto, puedes escribir algo como esto en la descripción de la Visión General de la organización:
SUM(#{project_id}.tasks.timeSpent)
Nota:
- El identificador de proyecto
#{project_id}solo puede usarse en el área de descripción de la Visión General de la organización. No se puede usar en la descripción de una tarea ni de un proyecto. - El ID del proyecto debe encerrarse entre llaves (por ejemplo:
#{project_id}) para que el identificador funcione correctamente. - Si el nombre de usuario contiene
.,-o_, deberás encerrarlo entre llaves para que el identificador funcione correctamente. - Si el nombre de una etiqueta contiene espacios o caracteres especiales, incluidos puntos (
.), almohadillas (#) o números, deberás encerrar el nombre de la etiqueta entre comillas para que el identificador funcione correctamente. Por ejemplo, si el nombre de la etiqueta es depending on, debe encerrarse entre comillas así:#"depending on".
Valores Literales en las Fórmulas de Quire
Los valores literales son valores fijos que no cambian durante el cálculo. Quire admite múltiples formatos de literales:
- Número:
123,-1.23 - Texto:
"text",'text' - Lista:
[1,2,3] - Booleano:
true,false - Duración:
12:01,123:12:23,2h 30m,2d 5s,30m - Fecha y hora:
<2022/12/25>,<12/23>,<23>,<2022/01/23 13:10:00>,<2023/12/25 16:00>,<15:15>,<now> - Días:
<today>,<today-1>,<tomorrow+3 13:10:05>,<+5>
Nota:
- Las cadenas de texto se pueden concatenar: ‘first’ “second”. Es equivalente a
'first second'. - Los días dependen del idioma (p. ej.
<Morgen>en alemán). - Para los días,
<+5>equivale a<today+5>. - Para las duraciones, las horas solo pueden estar en el rango 0-23 y la sintaxis es
hh:mm:ssomm:ss.
Dar Formato a los Resultados de las Fórmulas
Pestaña Formato
Puedes configurar cómo se muestran los resultados de las fórmulas mediante la pestaña Formato al crear o editar un campo de Fórmula.
- Abre el campo personalizado de Fórmula.
- Haz clic en la pestaña Formato.
- Elige el formato de visualización.
Colores Condicionales
El formato condicional ayuda a resaltar visualmente los valores importantes.
- Haz clic en Agregar una nueva condición.
- Define la condición y elige un color.
- Haz clic en Guardar.
Nota: Las condiciones se aplican de arriba hacia abajo. Arrastra el icono de seis puntos para reordenarlas.
Preguntas Frecuentes
¿Cómo uso las Fórmulas en Quire?
Crea un campo personalizado de tipo Fórmula, luego escribe una fórmula que haga referencia a los campos de la tarea y devuelva un resultado calculado. El plan Free permite una fórmula por campo por proyecto.
¿Qué cálculos puedo realizar en las Fórmulas de Quire?
Quire admite +, -, *, y /. Usa paréntesis para controlar el orden de los cálculos — por ejemplo, (due - start) * 2. Para cálculos avanzados, usa funciones integradas como SUM(timeSpent, estimated).
¿Qué valores literales puedo usar en las Fórmulas de Quire?
Los literales admitidos incluyen números (123, -1.23), texto ("text"), booleanos (true/false), listas ([1,2,3]), duraciones (2h 30m) y fechas (<2022/12/25>, <today>, <today+5>).
¿Cómo hago referencia a un campo personalizado con espacios en una Fórmula de Quire?
Encierra el nombre del campo entre llaves — por ejemplo, {Schedule Variance} * 2. Los nombres de campo sin espacios se pueden usar directamente. Los nombres de campo no distinguen entre mayúsculas y minúsculas.
¿Cómo incluyo texto en el resultado de una Fórmula de Quire?
Encierra las cadenas de texto entre comillas — por ejemplo, id + ":" + name muestra un ID y un nombre separados por dos puntos.
¿Cómo hago referencia a una Tarea, Miembro o Etiqueta específicos en una Fórmula de Quire?
Usa #task_id (p. ej. #23.due), @member_username y #tag_name. Para nombres de etiqueta con espacios o caracteres especiales, usa #"depending on".
¿Cómo doy formato o colores condicionales a los resultados de una Fórmula en Quire?
Abre el campo de Fórmula y haz clic en la pestaña Formato para elegir el formato de visualización. Para colores condicionales, haz clic en Agregar una nueva condición, define la regla y guarda.