Testi
prefix e suffix
prefix e suffix sono attributi di formattazione applicabili a qualsiasi tag: aggiungono una stringa rispettivamente prima e dopo il valore reso.
[contact:EMAIL prefix="<<" suffix=">>"] → Stampa il valore dell'indirizzo email del contatto preceduto dai caratteri << e seguito dai caratteri >>
Left e right
| Attributo | Descrizione | Esempio | Risultato |
|---|---|---|---|
left | Prime N caratteri | [contact:EMAIL left=3] | a@b (considerando l'indirizzo a@b.it) |
right | Ultimi N caratteri | [contact:EMAIL left=4] | b.it (considerando l'indirizzo a@b.it) |
Si possono concatenare più attributi e funzionano anche su valori numerici:
[contact:EMAIL left=4 prefix="**" suffix="**"] → stampa la stringa **test**
| Tag | Valore campo | Risultato |
|---|---|---|
[contact:EMAIL prefix=">>>"] | a@b.it | >>>a@b.it |
[contact:EMAIL suffix="<<<"] | a@b.it | a@b.it<<< |
[contact:EMAIL prefix="[" suffix="]"] | a@b.it | [a@b.it] |
[contact:EMAIL prefix=">>>" suffix="<<<"] | vuoto | (stringa vuota) |
[contact:EMAIL left=4 prefix=">>" suffix="<<"] | paolo… | >>paol<< |
[contact:EMAIL prefix="€" suffix=",00"] | 1500 | €1500,00 |
Il comando print trasforma il testo, si possono concatenare più trasformazioni nello stesso print:
[contact:EMAIL print="trim,lowercase"] → stampa la stringa Test@magnews.com
Valore in print | Effetto |
|---|---|
trim | Rimuove spazi iniziali/finali |
uppercase | Maiuscolo |
lowercase | Minuscolo |
capitalize | Iniziale maiuscola |
base64 | Codifica Base64 |
md5 | Hash MD5 |
sha1 | Hash SHA-1 |
sha256 | Hash SHA-256 |
sha512 | Hash SHA-512 |
Se utilizzi base64, md5, sha1, sha256, sha512 viene preso in considerazione anche il parametro encoding oltre a quello print. Specificare il parametro di "encoding" ti permette di utilizzare diverse tipologie di codifica come: "utf-8" (di default se non specificato), "utf-16", "windows-1252" o codificare caratteri speciali con caratteri ASCII a 7 bit.
[contact:EMAIL print="sha256"] → stampa la stringa ee12e84b6c09f8992486c86da38d0bf146779a2c5d552d56c296a0295ff0a6ca
encode
Il comando encode stampa la stringa nella codifica indicata
| Attributo | Descrizione |
|---|---|
encode='encodehtml' | Sostituisce i caratteri speciali html con le entity xml equivalenti. |
encode='encodejs' | Sostituisce i caratteri speciali javascript. |
encode='urlencode' | Codifica il valore come parametro di una URL. |
renderplaceholders | Risolve eventuali smart tag presenti nel valore risultante |
Date e numeri
Formatta il parametro pattern seguendo queste istruzioni:
| Attributo | Esempio | Effetto |
|---|---|---|
pattern | pattern="dd/MM/yyyy" | Formato data (default dd/MM/yyyy) |
pattern | pattern="unix_timestamp" | Stampa il timestamp Unix |
timezone | timezone="Europe/Rome" | Fuso orario per la formattazione data |
locale | locale="it-IT" | Locale per data/numeri |
maxdigits | maxdigits="2" | Massimo numero di decimali |
mindigits | mindigits="2" | Minimo numero di decimali |
grouping | grouping="true" | Separatore delle migliaia |
nan | nan="-" | Testo da stampare se il numero non è valido |
- d: giorno del mese;
- dd: giorno del mese rappresentato sempre con due cifre;
- ddd: giorno del mese con 0 davanti;
- dddd: giorno del mese con 00 davanti;
- EEE: giorno della settimana abbreviato in lettere;
- EEEE: giorno della settimana per esteso in lettere;
- M: mese dell'anno;
- MM: mese dell'anno rappresentato sempre con due cifre;
- MMM: mese dell'anno abbreviato in lettere;
- MMMM: mese dell'anno per esteso in lettere;
- yyyy: anno;
- YYYY: anno della settimana corrente (nota: l'ultima settimana dell'anno potrebbe ritornare l'anno successivo);
- H: orario;
- HH: orario rappresentato con due cifre;
- m: minuti;
- mm: minuti rappresentati sempre con due cifre;
- s: secondi;
- ss: secondi rappresentati sempre con due cifre;
- h: orario (in formato am/pm);
- a: aggiunge il marker AM/PM;
- w: stampa il numero di settimana dell'anno;
- z: stampa il timezone di riferimento;
- zzzz: stampa il timezone di riferimento in versione estesa.
Esempio di utilizzo di un campo contatto di tipo data-ora:Data e ora [contact:CAMPODATAORA pattern='dd/MM/yyyy HH:mm']
Scelta multipla
Per stampare un valore multiplo puoi utilizzare i seguenti attributi:
| Segnaposto | Descrizione | Esempio |
|---|---|---|
| separator | Carattere usato come separatore. | separator=',' |
| prefix | Stampa una stringa prima di un valore. | prefix="" |
| suffix | Stampa una stringa dopo un valore. | suffix="" |
[contact:interessi separator="," prefix="I suoi interesssi sono:"]Liste
Quando lo smart tag rende una collezione, prefix, suffix e separator controllano come la lista viene serializzata. I valori di default ricalcano il toString di una lista Java:
| Attributo | Default | Funzione |
|---|---|---|
prefix | [ | Stringa iniziale della lista |
suffix | ] | Stringa finale della lista |
separator | , | Separatore tra gli elementi |
max | — | Numero massimo di elementi da visualizzare |
Esempio: per ottenere uno; due; tre da una lista:
[temp:mialista prefix="" suffix="" separator="; "]