Guida alle Formule di Quire Permalink
Le Formule in Quire ti permettono di prendere i dati esistenti di un’attività o di un progetto e calcolare automaticamente nuovi valori. Puoi fare riferimento a campi predefiniti o campi personalizzati, applicare operatori o funzioni e visualizzare risultati numerici o testuali all’interno di un campo personalizzato.
Scrivere una Formula
Nel piano di Abbonamento Free, puoi aggiungere una Formula al campo personalizzato per ogni progetto. Aggiorna il tuo piano di Abbonamento per aggiungere più Formule. Ulteriori informazioni sono disponibili nella nostra pagina dei prezzi.
Per scrivere una Formula, devi prima creare un campo personalizzato Formula. Una volta creato, puoi inserire una formula che fa riferimento ai valori esistenti e restituisce un risultato calcolato.
Ad esempio, se vuoi dividere l’ora spesa per la tua attività per 2:
timeSpent/2
Quire calcolerà automaticamente il valore per ogni attività e mostrerà il risultato nel campo personalizzato.
Scopri come creare un campo personalizzato per aggiungere le tue Formule.
Eseguire Calcoli con le Formule
Operatori Aritmetici
Puoi eseguire calcoli aritmetici comuni utilizzando i seguenti operatori:
- Addizione:
+ - Sottrazione:
- - Moltiplicazione:
* - Divisione:
/
Ad esempio, per calcolare la durata dell’attività sottraendo la Data Inizio dalla Data Scadenza:
due - start
Suggerimento: Usa le parentesi ( ) per controllare l’ordine di calcolo. Ad esempio, digitando qualcosa come (due - start) *2, la sottrazione tra Data Scadenza e Data Inizio avrà la precedenza sulla moltiplicazione per 2.
Funzioni
Le funzioni offrono un modo più rapido per eseguire calcoli avanzati.
Ad esempio, per calcolare il totale dell’ora spesa e del Tempo stimato:
SUM(timeSpent, estimated)
Puoi anche usare gli operatori di confronto per ottenere risultati logici.
priority >= high
Questo verifica se la Priorità di un’attività è maggiore o uguale a High.
Scopri tutti i diversi operatori e funzioni che puoi usare nelle Formule di Quire.
Best Practice per la Scrittura di Formule
Operatore Punto
L’operatore punto . consente di recuperare valori specifici da oggetti correlati.
Ad esempio, per elencare i nomi di tutte le Subattività:
subtasks.name
Un altro esempio: per ottenere la Priorità di un’attività Padre:
parent.priority
Suggerimento: Abbiamo elencato tutti i diversi campi che puoi specificare.
Nomi di Campo con Spazi
Quando assegni un nome ai tuoi Campi personalizzati, devi evitare i seguenti caratteri: virgolette ("), barra rovesciata (\) e parentesi graffa chiusa (}).
Quando fai riferimento ai Campi personalizzati nelle Formule:
- I nomi dei campi senza spazi possono essere usati direttamente
- I nomi dei campi con spazi o caratteri speciali (inclusi
@,#,&, ecc.) devono essere racchiusi tra parentesi graffe{ }
Ad esempio, se hai aggiunto un nuovo campo chiamato Cost:
Cost *2
{Cost} *2
Se il nome del campo include spazi, devi racchiuderlo tra parentesi graffe { }:
{Schedule Variance} *2
Nota: Le maiuscole non sono rilevanti, quindi digitare cost o Cost è equivalente.
Testo nei Risultati
Per includere testo nei risultati di una Formula, racchiudi sempre le stringhe di testo tra virgolette.
Ad esempio, se hai aggiunto due Campi personalizzati, uno per l’ID dell’elemento e un altro per il nome dell’elemento:
id + ":" + name
Questo mostra l’ID e il nome separati da due punti.
Identificatori per MEMBRI, Attività ed Etichette
Puoi fare riferimento a entità specifiche usando gli identificatori:
- Membro:
@member_username - Attività:
#task_id - Etichetta:
#tag_name - Progetto:
#{project_id}
Ad esempio, per richiamare la Data Scadenza dell’attività con ID 23:
#23.due
Nota: Non sono consentiti spazi tra # e l’ID.
Ecco un altro esempio: per sapere quanto tempo ha speso l’intero progetto, puoi digitare qualcosa del genere nella descrizione della Panoramica dell’organizzazione:
SUM(#{project_id}.tasks.timeSpent)
Nota:
- L’identificatore di progetto
#{project_id}può essere usato solo nell’area descrizione della Panoramica dell’organizzazione. Non può essere usato nella descrizione di un’attività o di un progetto. - L’ID del progetto deve essere racchiuso tra parentesi graffe (ad esempio:
#{project_id}) affinché l’identificatore di progetto funzioni correttamente. - Se l’ID username dell’utente contiene
.,-o_, è necessario racchiuderlo tra parentesi graffe affinché l’identificatore funzioni correttamente. - Se il nome di un’Etichetta contiene spazi o caratteri speciali, inclusi punti (
.), cancelletti (#) o numeri, è necessario racchiudere il nome dell’Etichetta tra virgolette affinché l’identificatore funzioni correttamente. Ad esempio, se il nome dell’Etichetta è depending on, il nome dell’Etichetta deve essere racchiuso tra virgolette in questo modo:#"depending on".
Valori Letterali nelle Formule di Quire
I valori letterali sono valori fissi che non cambiano durante il calcolo. Quire supporta più formati letterali:
- Numero:
123,-1.23 - Testo:
"text",'text' - Lista:
[1,2,3] - Booleano:
true,false - Durata:
12:01,123:12:23,2h 30m,2d 5s,30m - Data e ora:
<2022/12/25>,<12/23>,<23>,<2022/01/23 13:10:00>,<2023/12/25 16:00>,<15:15>,<now> - Giorni:
<today>,<today-1>,<tomorrow+3 13:10:05>,<+5>
Nota:
- Le stringhe di testo possono essere concatenate: ‘first’ “second”. È equivalente a
'first second'. - I giorni dipendono dalla lingua (ad es.
<Morgen>in tedesco). - Per i giorni,
<+5>equivale a<today+5>. - Per la durata, le ore possono essere solo da 0 a 23 e la sintassi è
hh:mm:ssomm:ss.
Formattazione dei Risultati delle Formule
Scheda Formato
Puoi formattare la visualizzazione dei risultati delle Formule utilizzando la scheda Formato durante la creazione o la modifica di un campo Formula.
- Apri il campo personalizzato Formula.
- Clicca sulla scheda Formato.
- Scegli il formato di visualizzazione.
Colori Condizionali
La formattazione condizionale aiuta a evidenziare visivamente i valori importanti.
- Clicca su Aggiungi una nuova condizione.
- Definisci la condizione e scegli un colore.
- Clicca su Salva.
Nota: Le condizioni vengono applicate dall’alto verso il basso. Trascina l’icona a sei punti per riordinarle.
Domande Frequenti
Come si usano le Formule in Quire?
Crea un campo personalizzato Formula, quindi inserisci una formula che fa riferimento ai campi dell’attività e restituisce un risultato calcolato. Il piano Free consente un solo campo Formula per progetto.
Quali calcoli posso eseguire nelle Formule di Quire?
Quire supporta +, -, *, e /. Usa le parentesi per controllare l’ordine di calcolo — ad esempio, (due - start) * 2. Per calcoli avanzati, usa funzioni integrate come SUM(timeSpent, estimated).
Quali valori letterali posso usare nelle Formule di Quire?
I valori letterali supportati includono numeri (123, -1.23), testo ("text"), booleani (true/false), liste ([1,2,3]), durate (2h 30m) e date (<2022/12/25>, <today>, <today+5>).
Come si fa riferimento a un campo personalizzato con spazi in una Formula di Quire?
Racchiudi il nome del campo tra parentesi graffe — ad esempio, {Schedule Variance} * 2. I nomi dei campi senza spazi possono essere usati direttamente. I nomi dei campi non sono sensibili alle maiuscole.
Come si include del testo nel risultato di una Formula di Quire?
Racchiudi le stringhe di testo tra virgolette — ad esempio, id + ":" + name mostra un ID e un nome separati da due punti.
Come si fa riferimento a una specifica attività, Membro o Etichetta in una Formula di Quire?
Usa #task_id (es. #23.due), @member_username e #tag_name. Per i nomi di Etichette con spazi o caratteri speciali, usa #"depending on".
Come si formatta o si aggiunge la colorazione condizionale ai risultati di una Formula in Quire?
Apri il campo Formula e clicca sulla scheda Formato per scegliere un formato di visualizzazione. Per i colori condizionali, clicca su Aggiungi una nuova condizione, definisci la regola e salva.