Segnaposti
I segnaposti sono elementi testuali che fungono da punti di inserimento automatico dei dati nei modelli di documento (file .DOCX). In pratica, rappresentano delle variabili che il sistema sostituirà con i valori reali al momento della generazione del documento.
Tipologie di segnaposto
Sono disponibili due tipi principali:
1. Stringhe alfanumeriche
Si utilizzano per rappresentare un singolo valore testuale o numerico (es. nome, codice fiscale, data). La sintassi è:
${NOME_SEGNAPOSTO}
- Il simbolo
$indica che si tratta di un segnaposto. - Le parentesi graffe
{}racchiudono il nome del segnaposto, che deve essere scritto senza spazi.
2. Liste
Utili quando è necessario inserire elenchi dinamici di dati (es. voci con importi, righe tabellari). In questo caso il segnaposto è composto da un tag di apertura e uno di chiusura, con i contenuti al loro interno.
Esempio di struttura:
${LISTA_VALORI}
${label} : ${value}
${/LISTA_VALORI}
All'interno dei tag saranno presenti i campi label (etichetta) e value (valore) che verranno sostituiti riga per riga.
Risultato atteso nel documento:
- Voce 1: 100
- Voce 2: 200
- Voce 3: 150
Nota: il tag di chiusura inizia con una barra (/) prima del nome.
Utilizzo
Questi segnaposti vanno inseriti all’interno dei modelli Word (.docx) e verranno automaticamente sostituiti con i dati reali dell’attività (o delle sue entità collegate) quando si genera il documento finale.
Questo sistema consente di standardizzare la documentazione, ridurre errori e velocizzare i processi.