Skip to content

Funzioni nei modelli di documento

Le funzioni possono essere utilizzate durante la formattazione automatica dei documenti tramite i modelli. Le funzioni semplificano il modo in cui i dati vengono visualizzati nei tuoi documenti. Per esempio, puoi usare formule per visualizzare automaticamente i numeri in parole o calcolare i costi d'ordine.

Formule

Per aggiungere una formula a un documento, usa la sintassi seguente: %%%FORMULA%%%.

UNA FORMULA è un'espressione per calcolare il valore di un campo, proprio come in un campo calcolato.

Esempio:

%%%TEXT({{DataTag.Service.Quantity}}*{{DataTag.Service.Cost}};".2f")%%%

Nell'esempio sopra, i dati del tag dati "Service" vengono inseriti nella formula usando le variabili corrispondenti. I due valori vengono moltiplicati e il risultato è il costo totale di uno specifico servizio o prodotto. La funzione TEXT() formatta il valore come stringa di testo leggibile.

Importante

Ad esempio:

  • Le formule devono essere scritte in un'unica stringa e non possono essere suddivise premendo Invio. Se devi inserire un'interruzione di riga, usa la sequenza "\n".
  • Senza interruzione di riga
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Con interruzione di riga
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Le variabili nella formula non possono essere formattate, ad esempio in grassetto o corsivo.
  • Se desideri che il risultato della formula appaia in grassetto, applica la formattazione all'intera formula, compresi i simboli percentuali.

Funzioni

Tutte le funzioni disponibili nelle formule dei modelli di documento:


La funzione SUM

SUM() è una funzione che somma tutti i valori ottenuti calcolando una formula. Si applica a ciascun elemento di una variabile moltiplicatrice.

Ad esempio, supponiamo di avere un tag dati "Service" e di voler calcolare il costo totale di tutti i servizi in un documento. Useresti la funzione seguente: 

SUM({{DataTag.Service.Cost}})

Per ottenere il costo totale dei servizi forniti, è necessario moltiplicare il costo del servizio per il numero di volte in cui è stato ordinato. Ecco la formula da usare nel documento: 

SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))

Nota che la funzione SUM() può contenere qualsiasi formula composta da funzioni.

La funzione PLURALFORM

Usata per aggiungere un suffisso a una parola o per cambiare la parola stessa se è un sostantivo irregolare, in base al numero indicato prima nel modello di documento.

Formato: 

PLURALFORM (number; "text1"; "text2";)

In base al valore calcolato del numero, la funzione seleziona uno dei due parametri. I parametri devono essere specificati in ordine rigoroso secondo l'algoritmo.

Ad esempio, devi declinare la parola "dollar".

Prima scrivi la parola con il numero 1:

  • 1 dollar

Questo significa che il primo parametro della funzione dovrebbe essere la parola "dollar" al posto di "text1".

Poi scrivi la parola con il numero 2:

  • 2 dollars

Questo significa che il secondo parametro della funzione dovrebbe essere la parola "dollars" al posto di "text2".

Infine, puoi specificare la seguente funzione PLURALFORM() nel documento:

PLURALFORM(SUM({{Datatag.Service.Cost}}*{{Datatag.Service.Quantity}}); "dollar"; "dollars")

La funzione NUMBERASWORDS

Questa è una funzione che restituisce un numero per esteso. Viene scritto solo la parte intera del numero.

Formato: 

NUMBERASWORDS(number; Output; "language")

Dove:

  • number — è un numero o una formula
  • Output — definisce come verrà visualizzato il numerale (da 0 a 6)
  • language — stringa che specifica la lingua di output. Se lasciata vuota (""), viene utilizzata la lingua dell'utente che genera il documento.

Lingue e i rispettivi metodi di Output:

  • Inglese ("en")
    • 0-3 — predefinito (numero cardinale)
    • 4-6 — predefinito con iniziale maiuscola
  • Tedesco ("de")
    • 0 — predefinito (neutro rispetto al genere)
    • 1 — scritto in femminile
    • 2 — scritto in maschile
    • 3 — scritto in neutro
    • 4 — maiuscolo in femminile
    • 5 — maiuscolo in maschile
    • 6 — maiuscolo in neutro
  • Francese ("fr")
    • 0 — predefinito (numero cardinale)
    • 1 — scritto in femminile
    • 2 — scritto in maschile
    • 4 — maiuscolo in femminile
    • 5 — maiuscolo in maschile


Ad esempio, per visualizzare un numero per esteso in un documento, usa la funzione seguente: 

NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")

La funzione FRACTIONALPART

Questa funzione mostra la parte frazionaria di un numero. Puoi specificare il numero di cifre dopo la virgola che desideri visualizzare.

Formato: 

FRACTIONALPART(number; NumberOfDigitsAfterDecimal)

Ad esempio, per visualizzare il numero di centesimi del costo di un servizio in un documento, usa la funzione seguente: 

FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)

Questa funzione mostra le due cifre dopo la virgola:

  • 176.03 — la funzione restituisce 3.
  • 15.15 — la funzione restituisce 15.
  • 16.156 — la funzione arrotonda le prime due cifre decimali a 16.

Vai a

Estratto da "http://planfix.com/it/help/index.php?title=Funzioni_nei_modelli_di_documento&oldid=2368"