Question 1

Quais operadores aritméticos posso usar nas fórmulas do Quire?

Accepted Answer

As fórmulas do Quire suportam seis operadores numéricos: mais para adição, menos para subtração, asterisco para multiplicação, barra para divisão, porcentagem para o resto e circunflexo para potência. Você os aplica a campos personalizados baseados em números, como um campo de Custo ou Estimativa, para criar cálculos diretamente dentro de uma tarefa. Por exemplo, `timeSpent + 100` adiciona 100 ao valor do tempo gasto em uma tarefa, `Cost * 100` multiplica um campo de Custo por 100, e `Cost ^ 3` eleva o Custo à terceira potência. Antes de usar qualquer um desses operadores, é necessário criar um campo personalizado numérico, pois as fórmulas só podem referenciar campos que já existam na tarefa. Os operadores numéricos são a base para fórmulas mais avançadas e podem ser combinados com operadores de comparação, operadores lógicos e funções integradas como SUM() ou AVG() para criar cálculos mais complexos em uma tarefa e em suas subtarefas.

Question 2

Como escrevo uma fórmula IF/condicional no Quire?

Accepted Answer

O Quire usa o operador `?:` para escrever uma fórmula condicional com dois resultados. A expressão antes do `?` é avaliada como verdadeira ou falsa; o valor após o `?` é retornado quando for verdadeiro, e o valor após `:` é retornado quando for falso. Por exemplo, `(Cost > 10) ? 'Too expensive' : 'Reconsider'` exibe "Too expensive" quando o Custo é maior que 10, e "Reconsider" quando o Custo é 10 ou menos, ou quando o campo de Custo não tem nenhum valor. Se você precisar apenas de um valor de fallback para um campo vazio, em vez de um ramo verdadeiro/falso completo, use `??`. Por exemplo, `(Cost > 10) ?? 'Reconsider'` retorna verdadeiro ou falso com base na comparação, mas exibe "Reconsider" especificamente quando o Custo está vazio. Ambos os operadores exigem que um campo personalizado numérico como o Custo já exista antes de ser referenciado na fórmula.

Question 3

Como filtro subtarefas por um valor de campo em uma fórmula do Quire?

Accepted Answer

Filtre subtarefas em uma fórmula usando o operador `where`, que retorna apenas as subtarefas que atendem a uma condição especificada. Por exemplo, `subtasks where any.Cost > 10` retorna todas as subtarefas cujo campo de Custo é maior que 10. O identificador `any` informa ao Quire qual campo de cada subtarefa deve ser verificado em relação à condição. Você pode combinar `where` com `order by` e `limit` para obter resultados mais precisos, como ordenar os resultados e limitar a quantidade retornada. Por exemplo, `subtasks order by desc any.timeSpent - any.estimated limit 3` ordena as subtarefas pela diferença entre o tempo gasto e o tempo estimado, em ordem decrescente, e retorna apenas as 3 subtarefas mais acima do orçamento. Assim como em outras fórmulas numéricas no Quire, os campos usados no filtro, como Custo, timeSpent ou estimated, precisam existir previamente como campos personalizados numéricos na tarefa antes de poderem ser referenciados.

Question 4

Como ordeno ou reorganizo uma lista em uma fórmula do Quire?

Accepted Answer

Use o operador `order by` para ordenar uma lista de subtarefas por um campo específico. Por exemplo, `subtasks order by any.Cost` retorna as subtarefas organizadas pelos valores do campo de Custo, do menor para o maior por padrão. Adicione `asc` ou `desc` ao final da expressão para controlar explicitamente a direção da ordenação, como em `subtasks order by any.Cost asc`. Se você precisar apenas ordenar uma lista simples de valores em vez de uma lista de tarefas, use a função `SORT()`, por exemplo `SORT(subtasks.estimated)`, que retorna todos os valores dos campos de Estimativa das subtarefas em ordem crescente. Você também pode combinar `SORT()` com `DISTINCT()` para remover valores duplicados primeiro, como em `DISTINCT(SORT(subtasks.estimated))`, que retorna os valores de estimativa únicos e ordenados das subtarefas de uma tarefa. Você pode combinar `order by` com `where` e `limit` na mesma fórmula para filtrar, ordenar e limitar os resultados ao mesmo tempo.

Question 5

Como aplico um cálculo a cada item de uma lista no Quire?

Accepted Answer

Use o operador `map` para aplicar o mesmo cálculo a cada item de uma lista, como as subtarefas de uma tarefa. Por exemplo, `subtasks map any.Cost * 2` multiplica o valor do campo de Custo de cada subtarefa por 2 e retorna a lista de valores duplicados resultante. O identificador `any` informa ao Quire qual campo de cada subtarefa o cálculo deve usar, então você pode substituí-lo por qualquer outro campo personalizado numérico que tenha criado, como Estimativa ou timeSpent. Como o `map` funciona com campos personalizados numéricos, é necessário criar o campo que você está referenciando, como o Custo, antes de usá-lo na fórmula. O operador `map` é especialmente útil quando você quer transformar valores em uma lista inteira de uma só vez, em vez de calcular um total único — para isso existem funções como SUM() ou AVG().

Question 6

Quais funções integradas estão disponíveis nas fórmulas do Quire?

Accepted Answer

O Quire inclui nove funções integradas para fórmulas: SUM(), MAX(), MIN(), AVG(), COUNT(), SORT(), DISTINCT(), ISEMPTY() e ISNOTEMPTY(). SUM() soma um conjunto de valores, como `SUM(subtasks.estimated)`, que totaliza o campo de Estimativa nas subtarefas de uma tarefa, enquanto MAX() e MIN() retornam o maior ou o menor valor nesse mesmo conjunto. AVG() calcula a média e COUNT() retorna o número total de itens — por exemplo, `COUNT(subtasks)` indica o número de subtarefas de uma tarefa. SORT() organiza um conjunto de valores em ordem e DISTINCT() remove valores duplicados, então `DISTINCT(SORT(subtasks.estimated))` retorna os valores de estimativa únicos e ordenados. ISEMPTY() e ISNOTEMPTY() verificam se um campo, como `ISEMPTY(estimated)`, tem ou não um valor, retornando um resultado verdadeiro ou falso. Juntas, essas funções permitem calcular totais, médias e valores únicos sem precisar escrever uma fórmula personalizada do zero para cada caso.

Question 7

Como funciona a precedência de operadores nas fórmulas do Quire?

Accepted Answer

O Quire avalia as fórmulas em uma ordem fixa, e não estritamente da esquerda para a direita. Parênteses, o operador ponto, colchetes e chamadas de função são avaliados primeiro, seguidos de operadores unários como `not`, depois a exponenciação (`^`), depois multiplicação, divisão e resto (`*` `/` `%`), e depois adição e subtração (`+` `-`). Em seguida vêm os operadores de comparação (`<` `>` `<=` `>=` `in` `&`), os operadores de igualdade (`=` `!=`) e os operadores lógicos (`not`, `and`, `or`), seguidos dos operadores condicionais `??` e `?:`, com o `where` avaliado entre eles. Quando vários operadores em uma fórmula compartilham o mesmo nível de prioridade, o Quire os calcula da esquerda para a direita. Se essa ordem padrão não corresponder ao cálculo desejado, envolva a parte relevante da fórmula em parênteses para forçar sua avaliação primeiro, pois os parênteses sempre têm a maior prioridade.

Operadores	O que faz	Exemplo
+	Soma valores	`timeSpent + 100`
-	Subtrai valores	`Cost - 100`
*	Multiplica valores	`Cost * 100`
/	Divide valores	`Cost / 100`
%	Calcula o resto	`Cost % 3`
^	Calcula a potência	`Cost ^ 3`

Operadores	Significado	Exemplo
<	Menor que	`3 < 1` -> False
>	Maior que	`4 > 3` -> True
<=	Menor ou igual a	`4 <= 2` -> False
>=	Maior ou igual a	`5 >= 1` -> True
=	Igual a	`2 = 2` -> True
!=	Diferente de	`3 != 2` -> True

Operador	Descrição
`( )` `.` `[ ]` `( )`	Parênteses Operador ponto Lista (Array) Chamada de função
`+` `-` `not`	Operadores unários
`^`	Exponenciação
`*` `/` `%`	Multiplicação e divisão
`+` `-`	Adição e subtração
`<` `>` `<=` `>=` `in` `&`	Operadores de comparação
`=` `!=`	Operadores de igualdade
`not`	Operador lógico `not`
`and`	Operador lógico `and`
`or`	Operador lógico `or`
`??`	Operador condicional
`where`	Operador de filtro
`?:`	Operador condicional

Função	Descrição	Exemplo	Resultados esperados
SUM()	Retorna o total dos valores.	`SUM(subtasks.estimated)`	Soma todos os valores nos campos Estimativa das subtarefas da tarefa.
MAX()	Retorna o maior valor em um conjunto de valores.	`MAX(subtasks.estimated)`	Exibe o maior valor encontrado nos campos Estimativa das subtarefas da tarefa.
MIN()	Retorna o menor valor em um conjunto de valores.	`MIN(subtasks.estimated)`	Exibe o menor valor encontrado nos campos Estimativa das subtarefas da tarefa.
AVG()	Retorna o valor médio dos números.	`AVG(subtasks.estimated)`	Calcula a média dos campos Estimativa das subtarefas da tarefa.
COUNT()	Retorna o número de itens.	`COUNT(subtasks)`	Exibe o número total de subtarefas.
SORT()	Retorna os argumentos em ordem.	`SORT(subtasks.estimated)`	Exibe todos os valores dos campos Estimativa das subtarefas da tarefa em ordem.
DISTINCT()	Remove valores duplicados e retorna apenas valores distintos.	`DISTINCT(subtasks.estimated)`	Exibe todos os valores distintos dos campos Estimativa das subtarefas da tarefa, removendo os duplicados.
ISEMPTY()	Verifica se os argumentos de entrada estão vazios ou não e retorna um valor true/false.	`ISEMPTY(estimated)`	Se o campo Estimativa da tarefa estiver vazio, exibe uma caixa de seleção marcada.
ISNOTEMPTY()	Verifica se os argumentos de entrada estão vazios ou não e retorna um valor true/false.	`ISNOTEMPTY(estimated)`	Se o campo Estimativa da tarefa não estiver vazio, exibe uma caixa de seleção marcada.

Operadores Numéricos

Operadores de Texto

Operadores de Comparação

Operadores Lógicos

not

Exemplo:

in

Exemplo:

&

Exemplo:

and

Exemplo:

or

Exemplo:

Operadores de Lista

[field, field]

Exemplo:

field[index]

Exemplo:

order by

Exemplo:

map

Exemplo:

Operadores Condicionais

??

Exemplo:

?:

Exemplo:

Filtragem e Limitação de Resultados

where

Exemplo:

limit

Exemplo:

Precedência de Operadores

Todas as Funções Integradas

Perguntas Frequentes

Quais operadores aritméticos posso usar nas fórmulas do Quire?

Quais funções integradas estão disponíveis nas fórmulas do Quire?

Como funciona a precedência de operadores nas fórmulas do Quire?

Como escrevo uma fórmula IF/condicional no Quire?

Como filtro subtarefas por um valor de campo em uma fórmula do Quire?

Como ordeno ou reorganizo uma lista em uma fórmula do Quire?

Como aplico um cálculo a cada item de uma lista no Quire?

`not`

`in`

`&`

`and`

`or`

`[field, field]`

`field[index]`

`order by`

`map`

`??`

`?:`

`where`

`limit`