Question 1

Quali operatori aritmetici posso usare nelle formule di Quire?

Accepted Answer

Le formule di Quire supportano sei operatori numerici: più per l'addizione, meno per la sottrazione, asterisco per la moltiplicazione, barra per la divisione, percentuale per il resto e accento circonflesso per la potenza. Li applichi ai campi personalizzati basati su numeri, come un campo Costo o Stima, per costruire calcoli direttamente all'interno di un'attività. Ad esempio, `timeSpent + 100` aggiunge 100 al valore del tempo trascorso di un'attività, `Cost * 100` moltiplica un campo Costo per 100 e `Cost ^ 3` eleva Costo alla terza potenza. Prima di poter usare uno qualsiasi di questi operatori, devi creare un campo personalizzato numerico, poiché le formule possono fare riferimento solo a campi che esistono già nell'attività. Gli operatori numerici sono la base per formule più avanzate e possono essere combinati con operatori di confronto, operatori logici e funzioni integrate come SUM() o AVG() per costruire calcoli più complessi su un'attività e le sue subattività.

Question 2

Come scrivo una formula IF/condizionale in Quire?

Accepted Answer

Quire usa l'operatore `?:` per scrivere una formula condizionale a due esiti. L'espressione prima del `?` viene valutata come vera o falsa, il valore dopo `?` viene restituito quando è vera e il valore dopo `:` viene restituito quando è falsa. Ad esempio, `(Cost > 10) ? 'Too expensive' : 'Reconsider'` mostra «Too expensive» quando Costo è maggiore di 10 e «Reconsider» quando Costo è 10 o meno, oppure quando il campo Costo non ha alcun valore. Se ti serve solo un valore di riserva per un campo vuoto anziché una vera e propria ramificazione vero/falso, usa invece `??`. Ad esempio, `(Cost > 10) ?? 'Reconsider'` restituisce vero o falso in base al confronto, ma mostra «Reconsider» specificamente quando Costo è vuoto. Entrambi gli operatori richiedono che un campo personalizzato numerico come Costo esista già prima di farvi riferimento nella formula.

Question 3

Come filtro le subattività in base al valore di un campo in una formula di Quire?

Accepted Answer

Filtra le subattività in una formula usando l'operatore `where`, che restituisce solo le subattività che soddisfano una condizione che specifichi. Ad esempio, `subtasks where any.Cost > 10` restituisce ogni subattività il cui campo Costo è maggiore di 10. L'identificatore `any` indica a Quire quale campo di ciascuna subattività verificare rispetto alla condizione. Puoi combinare `where` con `order by` e `limit` per costruire risultati più mirati, come ordinare le corrispondenze e limitare quante ne vengono restituite. Ad esempio, `subtasks order by desc any.timeSpent - any.estimated limit 3` ordina le subattività in base a quanto il tempo trascorso supera il tempo stimato, in ordine decrescente, e restituisce solo le prime 3 subattività fuori budget. Come per le altre formule numeriche in Quire, i campi su cui filtri, come Costo, timeSpent o estimated, devono già esistere come campi personalizzati numerici nell'attività prima di potervi fare riferimento.

Question 4

Come ordino o riorganizzo una lista in una formula di Quire?

Accepted Answer

Usa l'operatore `order by` per ordinare una lista di subattività in base a un campo specifico. Ad esempio, `subtasks order by any.Cost` restituisce le subattività disposte in base ai valori del loro campo Costo, dal più basso al più alto per impostazione predefinita. Aggiungi `asc` o `desc` alla fine dell'espressione per controllare esplicitamente la direzione dell'ordinamento, come `subtasks order by any.Cost asc`. Se hai bisogno solo di ordinare una lista semplice di valori anziché una lista di attività, usa invece la funzione `SORT()`, ad esempio `SORT(subtasks.estimated)`, che restituisce tutti i valori dai campi Stima delle subattività in ordine. Puoi anche abbinare `SORT()` a `DISTINCT()` per rimuovere prima i valori duplicati, come in `DISTINCT(SORT(subtasks.estimated))`, che restituisce i valori di stima univoci e ordinati tra le subattività di un'attività. Puoi combinare `order by` con `where` e `limit` nella stessa formula per filtrare, ordinare e limitare i risultati insieme.

Question 5

Come applico un calcolo a ogni elemento di una lista in Quire?

Accepted Answer

Usa l'operatore `map` per eseguire lo stesso calcolo su ogni elemento di una lista, come le subattività di un'attività. Ad esempio, `subtasks map any.Cost * 2` moltiplica per 2 il valore del campo Costo di ciascuna subattività e restituisce la lista risultante di valori raddoppiati. L'identificatore `any` indica a Quire quale campo di ciascuna subattività deve essere l'obiettivo del calcolo, così puoi sostituirlo con qualsiasi altro campo personalizzato numerico che hai creato, come Stima o timeSpent. Poiché `map` opera su campi personalizzati numerici, devi creare il campo a cui fai riferimento, come Costo, prima di poterlo usare nella formula. L'operatore `map` è particolarmente utile quando vuoi trasformare i valori su un'intera lista in una sola volta anziché calcolare un unico totale, per cui servono invece funzioni come SUM() o AVG().

Question 6

Quali funzioni integrate sono disponibili nelle formule di Quire?

Accepted Answer

Quire include nove funzioni integrate per le formule: SUM(), MAX(), MIN(), AVG(), COUNT(), SORT(), DISTINCT(), ISEMPTY() e ISNOTEMPTY(). SUM() somma un insieme di valori, come `SUM(subtasks.estimated)` che totalizza il campo Stima tra le subattività di un'attività, mentre MAX() e MIN() restituiscono il valore più grande o più piccolo nello stesso insieme. AVG() calcola la media e COUNT() restituisce il numero totale di elementi, ad esempio `COUNT(subtasks)` per il numero di subattività di un'attività. SORT() dispone un insieme di valori in ordine e DISTINCT() rimuove i duplicati, quindi `DISTINCT(SORT(subtasks.estimated))` restituisce valori di stima ordinati e univoci. ISEMPTY() e ISNOTEMPTY() verificano se un campo, come `ISEMPTY(estimated)`, ha un valore o meno e restituiscono un risultato vero o falso. Insieme, queste funzioni ti permettono di calcolare totali, medie e valori univoci senza scrivere da zero una formula personalizzata per ogni caso.

Question 7

Come funziona la precedenza degli operatori nelle formule di Quire?

Accepted Answer

Quire valuta le formule in un ordine fisso anziché rigorosamente da sinistra a destra. Le parentesi, l'operatore punto, le parentesi quadre delle liste e le chiamate di funzione vengono valutate per prime, seguite dagli operatori unari come `not`, poi l'elevamento a potenza (`^`), poi moltiplicazione, divisione e resto (`*` `/` `%`), poi addizione e sottrazione (`+` `-`). Dopo vengono gli operatori di confronto (`<` `>` `<=` `>=` `in` `&`), gli operatori di equazione (`=` `!=`) e gli operatori logici (`not`, `and`, `or`), seguiti dagli operatori condizionali `??` e `?:`, con `where` valutato tra loro. Quando più operatori in una formula condividono lo stesso livello di precedenza, Quire li calcola da sinistra a destra. Se questo ordine predefinito non corrisponde al calcolo che desideri, racchiudi tra parentesi la parte pertinente della tua formula per forzarne la valutazione per prima, poiché le parentesi hanno sempre la massima priorità.

Operatori	Cosa fa	Esempio
+	Somma valori	`timeSpent + 100`
-	Sottrae valori	`Cost - 100`
*	Moltiplica valori	`Cost * 100`
/	Divide valori	`Cost / 100`
%	Calcola il resto	`Cost % 3`
^	Calcola la potenza	`Cost ^ 3`

Operatori	Significato	Esempio
<	Minore di	`3 < 1` -> False
>	Maggiore di	`4 > 3` -> True
<=	Minore o uguale a	`4 <= 2` -> False
>=	Maggiore o uguale a	`5 >= 1` -> True
=	Uguale a	`2 = 2` -> True
!=	Diverso da	`3 != 2` -> True

Operatore	Descrizione
`( )` `.` `[ ]` `( )`	Parentesi Operatore punto Lista (Array) Chiamata di funzione
`+` `-` `not`	Operatori unari
`^`	Elevamento a potenza
`*` `/` `%`	Moltiplicazione e divisione
`+` `-`	Addizione e sottrazione
`<` `>` `<=` `>=` `in` `&`	Operatori di confronto
`=` `!=`	Operatori di equazione
`not`	Operatore logico `not`
`and`	Operatore logico `and`
`or`	Operatore logico `or`
`??`	Operatore condizionale
`where`	Operatore di filtro
`?:`	Operatore condizionale

Funzione	Descrizione	Esempio	Risultati attesi
SUM()	Restituisce il totale dei valori.	`SUM(subtasks.estimated)`	Sommerà tutti i valori nei campi Stima delle subattività dell’attività.
MAX()	Restituisce il valore più grande in un insieme di valori.	`MAX(subtasks.estimated)`	Mostrerà il valore più grande che si può trovare nei campi Stima delle subattività dell’attività.
MIN()	Restituisce il valore più piccolo in un insieme di valori.	`MIN(subtasks.estimated)`	Mostrerà il valore più piccolo che si può trovare nei campi Stima delle subattività dell’attività.
AVG()	Restituisce il valore medio dei numeri.	`AVG(subtasks.estimated)`	Calcolerà la media dei campi Stima delle subattività dell’attività.
COUNT()	Restituisce il numero di elementi.	`COUNT(subtasks)`	Mostrerà il numero totale di subattività.
SORT()	Restituisce l’ordine ordinato degli argomenti.	`SORT(subtasks.estimated)`	Mostrerà tutti i valori dei campi Stima delle subattività dell’attività in ordine ordinato.
DISTINCT()	Rimuove i valori duplicati e restituisce solo i valori distinti.	`DISTINCT(subtasks.estimated)`	Mostrerà tutti i valori distinti dei campi Stima delle subattività dell’attività e rimuoverà i valori duplicati.
ISEMPTY()	Verifica se gli argomenti in input sono vuoti o meno e restituisce un valore vero/falso.	`ISEMPTY(estimated)`	Se il campo Stima dell’attività è vuoto, mostrerà una casella spuntata.
ISNOTEMPTY()	Verifica se gli argomenti in input sono vuoti o meno e restituisce un valore vero/falso.	`ISNOTEMPTY(estimated)`	Se il campo Stima dell’attività non è vuoto, mostrerà una casella spuntata.

Operatori numerici

Operatori di testo

Operatori di confronto

Operatori logici

not

Esempio:

in

Esempio:

&

Esempio:

and

Esempio:

or

Esempio:

Operatori di lista

[field, field]

Esempio:

field[index]

Esempio:

order by

Esempio:

map

Esempio:

Operatori condizionali

??

Esempio:

?:

Esempio:

Filtrare e limitare i risultati

where

Esempio:

limit

Esempio:

Precedenza degli operatori

Tutte le funzioni integrate

Domande frequenti

Quali operatori aritmetici posso usare nelle formule di Quire?

Quali funzioni integrate sono disponibili nelle formule di Quire?

Come funziona la precedenza degli operatori nelle formule di Quire?

Come scrivo una formula IF/condizionale in Quire?

Come filtro le subattività in base al valore di un campo in una formula di Quire?

Come ordino o riorganizzo una lista in una formula di Quire?

Come applico un calcolo a ogni elemento di una lista in Quire?

`not`

`in`

`&`

`and`

`or`

`[field, field]`

`field[index]`

`order by`

`map`

`??`

`?:`

`where`

`limit`