Formule
I campi Formula nei Copera Boards ti permettono di creare colonne calcolate che derivano i valori automaticamente da altri dati nelle righe. Basati sul Copera Formula Engine --- un linguaggio di formule dedicato con parser e evaluator propri --- puoi costruire di tutto, dalle operazioni aritmetiche semplici alla logica condizionale complessa e ai calcoli sulle date.
Panoramica del linguaggio delle formule
Le formule Copera usano una sintassi simile a quella dei fogli di calcolo. Ogni formula viene valutata per riga, con accesso a tutti i valori di colonna della stessa riga. Il motore di formule supporta:
- Operatori aritmetici:
+,-,*,/per le operazioni matematiche - Concatenazione di stringhe:
&per unire valori di testo - Operatori di confronto:
=,!=,>,<,>=,<= - Operatori logici:
AND,OR,NOTper combinare condizioni - Riferimenti a campi: Fai riferimento ad altre colonne racchiudendo il nome della colonna tra parentesi graffe, ad es.
{Column Name} - Funzioni annidate: Le funzioni possono essere usate come argomenti di altre funzioni
Sintassi di base
{Price} * {Quantity}
Questa formula moltiplica il valore della colonna "Price" per la colonna "Quantity" per ogni riga.
IF({Status} = "Done", "Complete", "Pending")
Questa formula restituisce "Complete" quando la colonna Status è uguale a "Done", e "Pending" altrimenti.
Riferimento alle funzioni
Il Copera Formula Engine fornisce oltre 100 funzioni organizzate nelle seguenti categorie. Di seguito un riferimento alle funzioni più usate.
Funzioni matematiche
| Funzione | Descrizione | Esempio |
|---|---|---|
ABS(number) | Valore assoluto | ABS({Balance}) |
CEIL(number) | Arrotonda per eccesso all'intero più vicino | CEIL({Score} / 10) |
FLOOR(number) | Arrotonda per difetto all'intero più vicino | FLOOR({Price}) |
ROUND(number, decimals) | Arrotonda al numero di decimali specificato | ROUND({Average}, 2) |
MIN(a, b, ...) | Valore più piccolo | MIN({Estimate}, {Budget}) |
MAX(a, b, ...) | Valore più grande | MAX({Score1}, {Score2}) |
SUM(a, b, ...) | Somma dei valori | SUM({Q1}, {Q2}, {Q3}, {Q4}) |
AVERAGE(a, b, ...) | Media aritmetica | AVERAGE({Test1}, {Test2}) |
MOD(number, divisor) | Resto della divisione | MOD({Row Number}, 2) |
POWER(base, exponent) | Elevamento a potenza | POWER({Side}, 2) |
SQRT(number) | Radice quadrata | SQRT({Area}) |
Funzioni di testo
| Funzione | Descrizione | Esempio |
|---|---|---|
CONCAT(a, b, ...) | Unisce valori di testo | CONCAT({First Name}, " ", {Last Name}) |
LEFT(text, count) | Estrae dall'inizio | LEFT({Code}, 3) |
RIGHT(text, count) | Estrae dalla fine | RIGHT({Phone}, 4) |
MID(text, start, count) | Estrae dal centro | MID({ID}, 2, 4) |
LEN(text) | Conteggio caratteri | LEN({Description}) |
LOWER(text) | Converte in minuscolo | LOWER({Email}) |
UPPER(text) | Converte in maiuscolo | UPPER({Code}) |
TRIM(text) | Rimuove spazi iniziali/finali | TRIM({Input}) |
REPLACE(text, old, new) | Sostituisce le occorrenze | REPLACE({URL}, "http", "https") |
SEARCH(find, text) | Trova la posizione di una sottostringa | SEARCH("@", {Email}) |
Funzioni sulle date
Il motore di formule si integra con un'ampia libreria date, dandoti accesso a potenti funzioni di manipolazione e confronto.
| Funzione | Descrizione | Esempio |
|---|---|---|
TODAY() | Data corrente | TODAY() |
NOW() | Data e ora correnti | NOW() |
YEAR(date) | Estrae l'anno | YEAR({Created}) |
MONTH(date) | Estrae il mese (1-12) | MONTH({Due Date}) |
DAY(date) | Estrae il giorno del mese | DAY({Birthday}) |
WEEKDAY(date) | Giorno della settimana (0-6) | WEEKDAY({Start Date}) |
WEEKNUM(date) | Numero di settimana dell'anno | WEEKNUM({Created}) |
QUARTER(date) | Trimestre (1-4) | QUARTER({Close Date}) |
DATEADD(date, count, unit) | Aggiunge tempo a una data | DATEADD({Start}, 14, "days") |
DATEDIFF(date1, date2, unit) | Differenza tra date | DATEDIFF({Start}, {End}, "days") |
IS_BEFORE(date1, date2) | Verifica se date1 è prima di date2 | IS_BEFORE({Due Date}, TODAY()) |
IS_AFTER(date1, date2) | Verifica se date1 è dopo date2 | IS_AFTER({Due Date}, TODAY()) |
IS_SAME_DAY(date1, date2) | Verifica se è lo stesso giorno | IS_SAME_DAY({Created}, TODAY()) |
IS_TODAY(date) | Verifica se la data è oggi | IS_TODAY({Due Date}) |
IS_WEEKEND(date) | Verifica se la data cade nel weekend | IS_WEEKEND({Delivery Date}) |
START_OF_MONTH(date) | Primo giorno del mese | START_OF_MONTH({Date}) |
END_OF_MONTH(date) | Ultimo giorno del mese | END_OF_MONTH({Date}) |
START_OF_WEEK(date) | Primo giorno della settimana | START_OF_WEEK({Date}) |
END_OF_WEEK(date) | Ultimo giorno della settimana | END_OF_WEEK({Date}) |
ADD_BUSINESS_DAYS(date, days) | Aggiunge solo giorni lavorativi | ADD_BUSINESS_DAYS({Start}, 5) |
DIFF_BUSINESS_DAYS(d1, d2) | Giorni lavorativi tra le date | DIFF_BUSINESS_DAYS({Start}, {End}) |
Funzioni logiche
| Funzione | Descrizione | Esempio |
|---|---|---|
IF(condition, then, else) | Valore condizionale | IF({Amount} > 1000, "High", "Low") |
SWITCH(expr, val1, result1, ...) | Confronta con più valori | SWITCH({Priority}, "P0", "Critical", "P1", "High", "Normal") |
AND(a, b, ...) | Vero se tutte le condizioni sono vere | AND({Complete}, {Approved}) |
OR(a, b, ...) | Vero se almeno una condizione è vera | OR({Urgent}, {Overdue}) |
NOT(value) | Inverte un booleano | NOT({Archived}) |
ISBLANK(value) | Verifica se è vuoto | ISBLANK({Notes}) |
Esempi comuni di formule
Concatenare i nomi
CONCAT({First Name}, " ", {Last Name})
Combina le colonne nome e cognome con uno spazio in mezzo.
Calcolare i giorni alla scadenza
DATEDIFF(TODAY(), {Due Date}, "days")
Restituisce il numero di giorni rimanenti fino alla data di scadenza. I valori negativi indicano elementi in ritardo.
Etichette di stato condizionali
IF(IS_BEFORE({Due Date}, TODAY()), "Overdue",
IF(DATEDIFF(TODAY(), {Due Date}, "days") <= 3, "Due Soon", "On Track"))
Restituisce "Overdue" per gli elementi scaduti, "Due Soon" per quelli in scadenza entro 3 giorni e "On Track" per tutto il resto.
Calcolo della percentuale
ROUND({Completed Tasks} / {Total Tasks} * 100, 1)
Calcola la percentuale di completamento arrotondato a una cifra decimale.
Giorni lavorativi rimanenti
DIFF_BUSINESS_DAYS(TODAY(), {Deadline})
Calcola il numero di giorni lavorativi (esclusi i weekend) tra oggi e una scadenza.
Gestione degli errori
Quando una formula contiene errori, Copera mostra un indicatore di errore nella cella al posto di un valore. Gli errori comuni includono:
- Errori di sintassi --- Parentesi non corrispondenti, operatori mancanti o nomi di funzione non riconosciuti.
- Incompatibilità di tipo --- Tentativo di eseguire aritmetica su valori di testo o operazioni sulle date su numeri.
- Riferimenti null --- Riferimento a una colonna che non ha valore nella riga corrente. Usa
ISBLANK()per gestire con eleganza i campi opzionali. - Divisione per zero --- Divisione per una colonna che contiene zero. Avvolgi con un
IFper controllare:IF({Total} = 0, 0, {Part} / {Total}).
L'editor delle formule mostra un'anteprima live del risultato mentre digiti, così è facile individuare e correggere gli errori prima di salvare.
Creazione di formule assistita dall'AI
Se non sei sicuro di come scrivere una formula, Copera offre un assistente formule basato su AI. Descrivi cosa vuoi calcolare in linguaggio naturale e l'assistente genererà una formula per te. Puoi rivedere, modificare e affinare il suggerimento prima di applicarlo alla colonna.
Prossimi passi
- Scopri i Campi calcolati per approfondire i campi Formula, Function e Tracker.
- Configura Automazioni che si attivano in base ai risultati delle formule.
- Usa Filtri e ordinamento per filtrare le righe in base ai valori delle colonne formula.