Skip to content

Variabili nel testo


Questo articolo della guida non si applica ai modelli di documento. Scopri qui come usare le variabili nei modelli di documento.

Le variabili memorizzano un valore, ad esempio un numero, una stringa o un altro tipo di dati. Le variabili vengono usate in:

  • Nome del compito (in un modello di compito o durante la creazione di un compito)
  • Descrizione del compito (in un modello di compito o durante la creazione di un compito)
  • Modelli email
  • Azioni Script, pulsanti, webhook in entrata e regole email per i compiti:
    • Invia richiesta HTTP
    • Invia SMS
    • Scrivi su WhatsApp
    • Scrivi su Instagram
  • Azioni in blocco, Script, pulsanti, webhook in entrata e regole email per i compiti:
    • Modifica nome
    • Modifica descrizione
    • Aggiungi commento
    • Imposta valore del campo (per i campi «Testo»)


Per aggiungere una variabile al testo, ad esempio alla descrizione del compito, fai clic sul link «diverse variabili» (1), crea la variabile e aggiungila al testo del campo desiderato nel modello di compito (2):

vBmUi1.jpg

Calcoli con le variabili

A volte non basta inserire nel testo il valore di una variabile: potrebbe essere necessario eseguire calcoli sui valori delle variabili o elaborare la stringa ottenuta. Per queste operazioni, usa la sintassi seguente:

%%%TESTO FORMULA%%%

Esempi

Prezzo scontato: %%%{{Task.Price}}*0.8%%%
Il lavoro sarà completato tra %%%DATEDIF(NOW(); {{Task.Completion Date}}; "d")%%% %%%MULTIPLE(DATEDIF(NOW(); {{Task.Completion Date}}; "d");"day"; "days")%%%

Importante

  • Il testo della formula deve essere scritto su un'unica riga e non può essere suddiviso. In altre parole, non è possibile andare a capo nella formula premendo Invio.
  • Le variabili nella formula non possono essere formattate, ad esempio in grassetto o in corsivo.
  • Se vuoi evidenziare in grassetto il risultato della formula, applica la formattazione all'intera formula, compreso il risultato.

IF

Per inserire un testo in base ai valori delle variabili (condizioni), usa la sintassi seguente:

%%$IF(Formula logica)$%%
TESTO
%%$ENDBLOCK$%%

Esempio

%%$IF({{Task.Order Amount}} > 100000)$%%
CLIENTE VIP
%%$ENDBLOCK$%%


Risultato:

CLIENTE VIP

ELSE

ELSE si usa solo insieme a IF. Se la condizione IF non è vera, viene visualizzato il testo della parte ELSE del blocco.

%%$IF(Formula logica)$%%
TESTO
%%$ELSE$%%
TESTO
%%$ENDBLOCK$%%

Esempio

%%$IF({{Task. Invoice №}}="")$%%
Il campo [N. fattura] non è compilato
%%$ELSE$%%
Il campo obbligatorio del compito è compilato! :)
%%$ENDBLOCK$%%


Risultato:

  • Se il campo non è compilato, viene visualizzato il messaggio «Il campo [N. fattura] non è compilato».
  • Se il campo è compilato, viene visualizzato il messaggio «Il campo obbligatorio del compito è compilato! :)».

ELSEIF

Consente di creare un'espressione più complessa con condizioni:

%%$IF(Formula logica)$%%
TESTO
%%$ELSEIF(Formula logica)$%%
TESTO
%%$ELSEIF(Formula logica)$%%
TESTO
%%$ELSE$%%
TESTO
%%$ENDBLOCK$%%


Nota

  • L'ultimo ELSE è una parte facoltativa del blocco.

Esempio

%%$IF({{Task.Invoice Number}}="")$%%
Il campo [Numero fattura] non è compilato
%%$ELSEIF({{Task.UPD Number}}="")$%%
Il campo [Numero UPD] non è compilato
%%$ELSEIF({{Task.Contract Number}}="")$%%
Il campo [Numero contratto] non è compilato
%%$ELSE$%%
Tutti i campi del compito sono compilati, sei fantastico! :)
%%$ENDBLOCK$%%


Risultato:

  • Se nessuno dei tre campi è compilato, viene visualizzato solo il primo messaggio «Il campo [Numero fattura] non è compilato» e gli altri vengono ignorati.
  • Se i campi «Numero fattura» e «Numero UPD» sono compilati, ma il campo «Numero contratto» non lo è, viene visualizzato il messaggio corrispondente: «Il campo [Numero contratto] non è compilato».

FOREACH

Quando una variabile rappresenta un elenco di valori, ad esempio {{Task.Subtasks}} o {{Task.Assignee}}, e vuoi visualizzare informazioni per ciascun valore, usa la sintassi seguente:

%%$FOREACH(Variabile;Separatore)$%%
TESTO
%%$ENDBLOCK$%%


Importante: in questa parte dell'espressione — %%$FOREACH(Variabile;Separatore)$%% — specifica sempre la variabile di primo livello, ad esempio {{Task.Subtasks}} o {{Task.Assignee}}, e nient'altro.

Esempio

%%$FOREACH({{Task.Assignee}};"<br>")$%%{{Task.Assignee}} - {{Task.Assignee.Position}}%%$ENDBLOCK$%%


Risultato:

linda Martinez - Designer
Jamse Davis - Developer
Mary Brown - CEO
%%$FOREACH({{Task.Subtasks}};"<br>")$%%{{Task.Subtasks.Number}} - {{Task.Subtasks.Name}}%%$ENDBLOCK$%%


Risultato:

2119 - Rough finish
2120 - Sub-final finishing
2121 - Final touches

Esempio con condizione

Sintassi:

%%$FOREACH(Variabile;Separatore;Condizione_SENZA_If)$%%
TESTO
%%$ENDBLOCK$%%

%%$FOREACH({{Task.Subtasks}};"";{{Task.Subtasks."Contract Amount ($)"}}>1000))$%%
{{Task.Subtasks.Counterparty}}, contract amount {{Task.Subtasks."Contract Amount ($)"}}
%%$ENDBLOCK$%%


Risultato

Nell'elenco delle controparti verranno visualizzate solo quelle con un importo del contratto superiore a 1000:

LLC Sunrise, 1500

LLC Sunset, 1700

LLC Dawn, 2500

Blocco ELSE all'interno di un blocco FOREACH

Sintassi:

%%$FOREACH(Variabile;Separatore)$%%
TESTO
 %%$IF(Formula logica)$%%
TESTO
 %%$ENDBLOCK$%%
TESTO
%%$ENDBLOCK$%%

%%$FOREACH({{Task.Subtasks}})$%%%%$IF({{Task.Subtasks.Status}}="TKP added to calculation")$%%
{{Task.Subtasks.Counterparty}}, {{Task.Subtasks.Counterparty.TIN}}, contract amount {{Task.Subtasks."Contract Amount"}} {{Task.Subtasks.Currency.Symbol}}
%%$ENDBLOCK$%%%%$ENDBLOCK$%%


Risultato:

LLC Sunrise, 5689845987654, 1500 $
LLC Sunset, 5689845125699, 1700 $
LLC Dawn, 5689845589674, 2500 $
LLC Light, 5689845235689, 500 $

TABLE

Quando una variabile rappresenta un elenco di valori e vuoi visualizzare le informazioni per ciascun valore sotto forma di tabella, usa la sintassi seguente:

%%$TABLE(Variabile)$%%
TESTO
%%$ENDBLOCK$%%

Esempio

L'esempio mostra come estrarre solo i blocchi necessari dal tag dati aggiunto al compito e inviare queste informazioni al cliente sotto forma di tabella. La tabella viene aggiunta con l'editor Planfix:

Ordine n.{{Task.Number}}

%%$TABLE({{Data tag.Service}})$%%

{{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}

%%$ENDBLOCK$%%

Importo totale dell'ordine: %%%TEXT(SUM({{Data tag.Service.Amount}});",.2f")+MULTIPLE(SUM({{Data tag.Service.Amount}}); " ruble"; " rubles")%%%


Risultato:

Ordine n. 2118

Graphic design 1 600.00
Programming 3 000.00
Development of TA 300.00

Importo totale dell'ordine: 4 900.00 dollari

Esempio con intestazione e totale

Per aggiungere un'intestazione o una riga dei totali alla tabella, usa i seguenti parametri nella sintassi:

%%$TABLE(Variabile;0;0)$%%
Tabella creata con l'editor Planfix
%%$ENDBLOCK$%%

Esempio: %%$TABLE({{Data Tag.Service}};1;1)$%%

# Nome Prezzo
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Totale %%%SUM({{Data tag.Service.Amount}})%%%

%%$ENDBLOCK$%%


Risultato:

# Nome Prezzo
1 Development of TA 1 000.00
2 Programming 3 705.00
3 Graphic design 1 035.00
4 Testing 690.00
Totale 6430

I numeri evidenziati in rosso indicano quante righe usare per l'intestazione e per i totali.

Ad esempio, i numeri (1;1) nell'esempio precedente indicano che una riga all'inizio sarà usata come intestazione della tabella e una riga alla fine come riga dei totali.

Per usare due righe nell'intestazione della tabella, specifica i valori così — (2;1).

Esempio: %%$TABLE({{Data tag .Service}};2;1)$%%

Elenco dei servizi
# Nome Prezzo
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Totale %%%SUM({{Data tag.Service.Amount}})%%%

%%$ENDBLOCK$%%


Risultato:

Elenco dei servizi
# Nome Prezzo
1 Development of TA 1 000.00
2 Programming 3 705.00
3 Graphic design 1 035.00
4 Testing 690.00
Totale 6430

Esempio con condizione

%%$TABLE(Variabile;0;0;Condizione_SENZA_If)$%%
Tabella creata con l'editor Planfix
%%$ENDBLOCK$%%


%%$TABLE({{Task.Subtasks}};1;0;{{Task.Subtasks.Status}}="TKP added to calculation")$%%

Controparte Codice fiscale Importo del contratto
{{Task.Subtasks.Counterparty}} {{Task.Subtasks.Counterparty.TIN}} {{Task.Subtasks."Contract Amount"}}{{Task.Subtasks.Currency.Symbol}}

%%$ENDBLOCK$%%


Risultato:

Controparte Codice fiscale Importo del contratto
LLC Sunrise 5689845987654 1500$
LLC Sunset 5689845125699 1700$
LLC Dawn 5689845589674 2500$
LLC Light 5689845235689 500$


Per aggiungere un'intestazione alla tabella, fai clic con il pulsante destro del mouse e seleziona Riga - Inserisci riga sopra:

Pvy4PR.jpg

FOREACH e TABLE con blocchi informativi

Quando analizzi un'email o rispondi a una richiesta HTTP, ricevi diverse righe di dati e vuoi aggiungerle sotto forma di testo strutturato o di tabella:

%%$FOREACH({{Infoblock.!row}};Separatore)$%%
{{Infoblock.!row.Infoblock name}}
%%$ENDBLOCK$%%

%%$TABLE({{Infoblock.!row}})$%%
{{Infoblock.!row.Infoblock name}}
%%$ENDBLOCK$%%


Esempio

Estraiamo i dati nei blocchi informativi «Prodotto» e «Prezzo» e aggiungiamoli alla tabella:

%%$TABLE({{Infoblock.!row}})$%%

{{Infoblock.!string.Product}} {{Infoblock.!string.Price}}

%%$ENDBLOCK$%%


Risultato:

Pencil 1,00
Pen 2,00
Notebook 10,00


Vai a