Alcune variabili sono dotate di opzioni di formattazione che consentono di specificare il formato di output.

Date

L'opzione Formato data consente di specificare in che modo le date vengono emesse.

{variable | date:'format'}

Dove variable è una delle variabili sopra riportate e format specifica il formato della data. Ad esempio:

{rfq.createdAt | date:'MM DD, YYYY'}

Per ulteriori formati data, fare riferimento a Moment.js.

Boolean

L'opzione per il formato booleano consente di utilizzare un operatore booleano per generare testo personalizzato.

{variable | bool:'true value': 'false value': 'N/A value'}

Dove variable è una delle variabili, ad esempio:

{rfq.properties['is approved'] | bool:'Y': 'N'}
{rfq.properties['is approved'] | bool:'GOOD': 'BAD': 'NA'}

Creare una casella di controllo per un esempio di attributi personalizzati:

{rco.properties["checkbox3-1"] | bool: “☒”:”☐”}

Numero

L'opzione Format numero consente di specificare il formato degli output numerici

{variable | number:'decimal points': 'group separator': 'fraction separator'}

Dove variable è una delle variabili, decimal points specifica il numero di punti decimali dopo il separatore di frazione, group separator specifica il simbolo da utilizzare per il separatore di gruppo, fraction separator specifica il simbolo da utilizzare per il separatore di frazione. Ad esempio:

{rco.approved | number:'2': ',': '.'}

restituirebbe un numero come 10,050.89.

È possibile aggiungere il nome della valuta alle variabili del formato numerico utilizzando il formato writtenCurrency:'USD'. Ad esempio:

{contract.awarded | writtenCurrency:'USD'}

dove è possibile sostituire USD con la valuta effettiva del contratto aggiudicato.

Funzioni matematiche

Le funzioni matematiche e l'arrotondamento possono essere applicati alle variabili nei documenti. Sono supportati i comandi Aggiungi, Sottrai, Moltiplica e Dividi.

Esempi:

{rfq.approved | add: 1}

{rfq.approved | minus: 2} 

{rfq.approved | multiply: 1.13} 

{rfq.approved | divide: 1.1}

Esempio di matematica e arrotondamento:

{rfq.approved | divide: 1.5 | rounding: '0.1': 'half-up'}

È inoltre possibile creare variabili matematiche più avanzate, che possono risultare utili quando si lavora con template di documento per richieste di pagamento. Ad esempio:

Variabili	Descrizione
{previousQuantity | add: quantity | rounding: '0.01': 'half-up'}	Restituisce la quantità totale alla data della richiesta di pagamento
{previousAmount | add: amount | rounding: '0.01': 'half-up'}	Restituisce l'importo totale alla data della richiesta di pagamento
{payment.lineView.totalPreviousAmount | add: payment.lineView.totalAmount | rounding: '0.01': 'half-up'}	Restituisce l'importo totale complessivo della richiesta di pagamento

Testo

Le opzioni del formato di testo consentono di definire la distinzione tra maiuscole e minuscole dell'output verbale della variabile

{variable | case}

Dove variable è una delle variabili e case rappresenta uno dei seguenti elementi:

• uppercase
• lowercase
• capitalize
• titlecase

Ad esempio:

{owner.name | uppercase}

Restituisce il nome in maiuscolo dell'azienda proprietaria.

Rich Text

Per inserire la formattazione Rich Text (ad esempio, grassetto, corsivo) in un template di documento Word, è necessario aggiungere un simbolo "@" alla variabile personalizzata.

Ad esempio:

Se si dispone di una variabile note {rco.note} e si aggiunge un simbolo "@", l'aspetto sarà simile a questo: {@rco.note}. Questa modifica garantisce l'inclusione della formattazione Rich Text delle note dell'ordine di modifica.

Ritaglia

È possibile rimuovere le estensioni dei file dai documenti generati. Ad esempio, se si utilizza la variabile {{{-w contract.exhibits}{targetName}{/contract.exhibits}}}, può includere l'estensione del nome file .docx o .pdf nel documento generato.

Se tutti i file sono in formato .docx, è possibile rimuovere l'estensione utilizzando la funzione trimEnd:

{targetName | trimEnd:'.docx'}

Se si dispone di file .docx e .pdf e si desidera rimuovere entrambe le estensioni, è possibile concatenare la funzione trimEnd in questo modo:

{targetName | trimEnd:'.docx' | trimEnd:'.pdf'}

Composto

L'opzione di formato composto consente di combinare altri due formati

{variable | format1 | format2}

Dove variable è una delle variabili e format1 e format2 rappresentano due diverse opzioni di formato di quelle sopra elencate.

Ad esempio:

{rco.approved | written | uppercase}

Split

La funzione split consente di separare una stringa in parti diverse in base ad un carattere specifico, o ad un gruppo di caratteri, noto anche come delimitatore.

Ecco un esempio:

{ number | split:'-' | get:'1' }

Questo comando consente di dividere la stringa memorizzata nella variabile number in corrispondenza di ogni -, quindi di ottenere la seconda parte della stringa di divisione (poiché il conteggio inizia da 0).

Si supponga che la variabile number contenga la stringa "1.1-001-ABC 01-CD EF 00FF-1.9G". Ciascun comando get restituirà:

• get:'0': 1.1
• get:'1': 001
• get:'2': ABC 01
• get:'3': CD EF 00FF
• get:'4': 1.9G

In alternativa, è possibile utilizzare la funzione slice o il comando last per estrarre parti della stringa:

• Per ottenere la SCONo dalla stringa completa del numero SCO, utilizzare {sco.number | slice':-3'}.
• In alternativa, è possibile utilizzare {sco.number | split:'-' | last} per ottenere l'ultima parte della stringa di divisione.

Ordinamento

Quando si dispone di un elenco o di una raccolta di dati, è possibile ordinarli in ordine crescente (asc) o decrescente (desc) in base al numero.

Utilizzare il seguente formato:

{#variable | sortBy:'number':'order'}{/variable | sortBy:'number':'order'}

Ad esempio:

{#oco.pco | sortBy:'number':'asc'}{/oco.pco | sortBy:'number':'asc'}