Formule tag

Le formule tag consentono di eseguire calcoli matematici, formattare date, costruire testo e aggregare valori all'interno di un tag. Utilizzano la stessa sintassi {{ }} di un tag normale, ma iniziano con = per indicare che si tratta di una formula.

Ad esempio, se la sorgente contiene un campo Line Item Price e si desidera visualizzare il prezzo con il 10% di tasse aggiunto, moltiplicare il campo per 1.1:

{{= Line Item Price * 1.1}}

Tag formula evaluated inside a Portant document template

Operatori aritmetici

È possibile utilizzare i seguenti operatori aritmetici nelle formule tag:

Symbol	Operation
`+`	Addition
`*`	Multiplication
`-`	Subtraction
`/`	Division

È possibile combinare più operatori e utilizzare le parentesi ( ) per costruire espressioni più complesse.

Formule integrate

Come Google Sheets ed Excel, Portant dispone di un insieme di formule integrate che è possibile richiamare all'interno di un tag. Ad esempio, ROUND limita un valore numerico a un numero definito di cifre decimali:

{{Line Item Price}} -> 24.1234
{{=ROUND(Line Item Price, 2)}} -> 24.12
{{=ROUND(Line Item Price)}} -> 24

Le seguenti formule integrate sono disponibili:

Formula	Description
`ROUND(Tag, [Places])`	Rounds the numeric value of `Tag` to `Places` decimal places. Omit the second argument to round to a whole number.
`DEFAULT(Tag, Default Value)`	Use a fallback value when the tag is blank.
`ADD(Tag 1, Tag 2, [...])`	Adds two or more numeric tags together. Same as using `+`.
`MULTIPLY(Tag 1, Tag 2, [...])`	Multiplies two or more numeric tags together. Same as using `*`.
`TRUNCATE(Tag, Length)`	Shortens the text value of `Tag` to the specified `Length`.
`LOWER(Tag)`	Converts the value of `Tag` to lowercase text.
`UPPER(Tag)`	Converts the value of `Tag` to UPPERCASE text.
`NAMEONLY(Tag)`	Restituisce solo il nome da un valore come `'Jane Smith' <jane@acme.com>`.
`EMAILONLY(Tag)`	Restituisce solo l'indirizzo email da un valore come `'Jane Smith' <jane@acme.com>`. Se il valore non contiene un indirizzo tra `< >`, viene restituito invariato.

[ ] indica che il parametro è facoltativo.

È possibile passare valori letterali al posto dei tag (e tag al posto dei valori) in qualsiasi punto di una formula.

Valori numerici

Formule aggregate

Alcune formule integrate sono progettate per funzionare con i flussi di lavoro di raggruppamento dati e aggregano tutti i valori raggruppati per un tag. La più comune è SUM, che somma tutti i valori di un determinato tag. È il metodo più semplice per calcolare un totale all'interno di un modello.

Within a Data Grouping Table:
+-----------------------------+
|1. {{Line Item Price}} -> 10 |
+-----------------------------+
|2. {{Line Item Price}} -> 20 |
+-----------------------------+
|3. {{Line Item Price}} -> 30 |
+-----------------------------+

{{=SUM(Line Item Price)}} -> 60

Le formule aggregate numeriche sono:

Formula	Description
`SUM(Tag)`	Adds together all values for `Tag`.
`PRODUCT(Tag)`	Multiplies together all values for `Tag`.
`AVG(Tag)`	Calculates the average of all values for `Tag`.
`MAX(Tag)`	Returns the largest value for `Tag`.
`MIN(Tag)`	Returns the smallest value for `Tag`.

È possibile utilizzare le formule aggregate in qualsiasi punto del documento, anche all'interno di espressioni più complesse. Ad esempio, per calcolare la percentuale che una singola voce rappresenta rispetto al totale:

{{= (Price / SUM(Price)) * 100 | 2}}%

Per le voci dell'esempio precedente, il risultato è:

+-------------------+------------------------------------------------+
|1. {{Price}} -> 10 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.16% |
+-------------------+------------------------------------------------+
|2. {{Price}} -> 20 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.33% |
+-------------------+------------------------------------------------+
|3. {{Price}} -> 30 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.50% |
+-------------------+------------------------------------------------+

Modificatore delle cifre decimali

Aggiungere | seguito da un numero alla fine di un'espressione per arrotondare il risultato a quel numero di cifre decimali, come fa ROUND. Ad esempio, per arrotondare un'espressione arbitraria a 3 cifre decimali:

{{1.1234 + 1.0 | 3}} -> 2.123

Formattazione di data e ora

È possibile formattare qualsiasi data o timestamp utilizzando la formula FORMATDATE. Questa formula offre il controllo completo su come le date vengono visualizzate nei documenti generati.

Utilizzo di base

Utilizzare la formula all'interno di un tag:

{{=FORMATDATE(Timestamp, "DD/MM/YYYY")}}

Il primo parametro è il campo data. Il secondo parametro è il formato di output.

Token di formattazione

Token	Output examples
D	1, 19
DD	01, 19
M	1, 12
MM	01, 12
MMM	Jan, Dec
MMMM	January, December
YY	25
YYYY	2025

Esempi di formato

Format	Output example
`"DD/MM/YYYY"`	07/02/2025
`"MMM D, YYYY"`	Feb 7, 2025
`"MMMM DD"`	February 07
`"YY-MM-DD"`	25-02-07

Operazioni aritmetiche su data e ora

È possibile aggiungere o sottrarre tempo da un campo data utilizzando questi helper:

{{= Date + DAYS(30)}} restituisce un valore 30 giorni dopo il valore di Date.

Le unità supportate (dove N è la quantità da aggiungere o sottrarre) sono:

MINUTES(N)
HOURS(N)
DAYS(N)
WEEKS(N)

Glossario delle formule

Sum (Somma)

Restituisce la somma di una serie di valori di campo, inclusi tutti i valori di campo all'interno di un tag di raggruppamento dati.

Sintassi

{{=SUM(tag1, tag2, ...)}}

tag1: Il primo tag da sommare.
tag2, ... (opzionale): Tag aggiuntivi da aggiungere a tag1.

I tag all'interno delle parentesi non necessitano di {{ e }} intorno a essi.

Average (Media)

AVG restituisce la media numerica di un gruppo di tag, inclusi tutti i valori di campo all'interno di un tag di raggruppamento dati.

Sintassi

{{=AVG(tag1, tag2, ...)}}

tag1: Il primo tag o tag di raggruppamento dati da includere nella media.
tag2, ... (opzionale): Tag aggiuntivi da includere.

Maximum (Massimo)

Restituisce il valore più grande da un gruppo di tag, inclusi tutti i valori di campo all'interno di un tag di raggruppamento dati.

Sintassi

{{=MAX(tag1, tag2, ...)}}

tag1: Il primo tag o tag di raggruppamento dati da considerare.
tag2, ... (opzionale): Tag aggiuntivi da considerare.

Minimum (Minimo)

Restituisce il valore più piccolo da un gruppo di tag, inclusi tutti i valori di campo all'interno di un tag di raggruppamento dati.

Sintassi

{{=MIN(tag1, tag2, ...)}}

tag1: Il primo tag o tag di raggruppamento dati da considerare.
tag2, ... (opzionale): Tag aggiuntivi da considerare.

Round (Arrotondamento)

Arrotonda il valore numerico di un campo a un certo numero di decimali.

Sintassi

{{=ROUND(tag, [places])}}

tag: Il valore da arrotondare.
places (opzionale, 0 per impostazione predefinita): Il numero di decimali a cui arrotondare.

Esempio di utilizzo

{{=ROUND(1.234, 2)}} -> 1.23

{{=ROUND(1.234)}} -> 1

Multiply (Moltiplicazione)

Restituisce il prodotto di due campi o valori numerici. Equivalente all'operatore *.

Sintassi

{{=MULTIPLY(tag1, tag2)}}

tag1: Un campo con un valore numerico o un numero letterale (ad es. 6).
tag2: Un campo con un valore numerico o un numero letterale (ad es. 7).

Add (Addizione)

Restituisce la somma di due campi o valori numerici. Equivalente all'operatore +.

Sintassi

{{=ADD(tag1, tag2)}}

tag1: Un campo con un valore numerico o un numero letterale (ad es. 19).
tag2: Un campo con un valore numerico o un numero letterale (ad es. 23).

Testo

Concatenate (Concatenazione)

Unisce stringhe di testo.

Esempio di utilizzo

{{=CONCATENATE('Hello', ' ', 'World')}} -> "Hello World"

{{=CONCATENATE(Line Item Name)}} -> "Item AItem BItem C" (senza spazi)

CONCATENATE(A2:B7)

Sintassi

CONCATENATE(tag_name_1, [tag_name_2, ...])

string1: Qualsiasi campo o campo di raggruppamento dati dalla sorgente, oppure una stringa letterale tra virgolette.
string2 ...: Qualsiasi numero di altri campi, campi di raggruppamento dati o stringhe letterali.

Text join (Unione di testo)

Combina il testo proveniente da più campi, o da un campo di raggruppamento dati con più valori, inserendo un delimitatore tra ciascun elemento.

Esempio di utilizzo

{{=TEXTJOIN(" | ", "Hello", "World")}} -> "Hello | World"

{{=TEXTJOIN(", ", Line Item Name)}} -> "Item A, Item B, Item C"

Sintassi

{{=TEXTJOIN(delimiter, tag_name_1, [tag_name_2, ...])}}

delimiter: Una stringa (che può essere vuota) o un altro campo. Se vuota, i valori vengono semplicemente concatenati.
tag_name_1: Qualsiasi campo o campo di raggruppamento dati dalla sorgente, oppure una stringa letterale tra virgolette.
tag_name_2, ...: Qualsiasi numero di altri campi, campi di raggruppamento dati o stringhe letterali.

È inoltre possibile utilizzare {{=TEXTJOINNONEMPTY(...)}} per escludere i valori vuoti dal risultato.

Truncate (Troncamento)

Riduce il valore di un campo o di una stringa letterale a una lunghezza specificata.

Sintassi

{{=TRUNCATE(tag, length)}}

tag: Il testo da troncare.
length: Il numero di caratteri da mantenere.

Se length è maggiore del numero di caratteri presenti nel valore, il valore viene restituito invariato.

Esempio

{{Message}} -> "Hello World"

{{=TRUNCATE(Message, 5)}} -> "Hello"

Filter and sum (Filtra e somma) (SUMIF)

Somma i valori che soddisfano una condizione.

Sintassi

{{=SUMIF(Condition Tag = "Something", Numeric Data Grouped Field)}}

Per ulteriori informazioni sulle condizioni all'interno dei tag, consultare tag if statements (istruzioni condizionali nei tag).

Solo nome e solo email

Divide nelle sue parti un valore con nome ed email, come {{Workflow Runner}} o un campo proprietario di HubSpot con formato "Name + Email".

Esempio

{{Deal Owner}} -> 'Jane Smith' <jane@acme.com>

{{=NAMEONLY(Deal Owner)}} -> Jane Smith

{{=EMAILONLY(Deal Owner)}} -> jane@acme.com

Per configurarlo con HubSpot, consultare Usare un proprietario HubSpot come nome e come email.