Modelli di documenti e e-mail¶

I modelli controllano come appaiono e suonano i contenuti generati automaticamente: fatture, e-mail di sistema (ad es. conferma d'ordine, accesso al corso, assegnazione di compiti obbligatori, promemoria del corso), certificati e promemoria dei compiti obbligatori. Invece di lasciare questi testi fissi nel codice, puoi progettarli tu stesso — con il tuo testo, il tuo logo e il tuo corporate design.

Ogni azienda cura i propri modelli. Se per un caso d'uso non esiste un modello proprio, subentra automaticamente un sensato modello standard di sistema — l'invio funziona quindi sempre, anche senza che tu configuri nulla.

Chi può modificare i modelli?

L'area dei modelli è visibile a partire dal ruolo Content Manager. La creazione, la modifica e l'assegnazione sono tipicamente un compito dei Company Admin.

A cosa servono i modelli¶

Workflow (z. B. Pflichtaufgabe zuweisen)
        ↓
Welche Vorlage ist diesem Zweck zugewiesen?
   ↓ eigene Vorlage           ↓ keine eigene
Deine Vorlage wird        System-Standardvorlage
verwendet                 wird verwendet

Un modello ha un tipo (la categoria generica) e viene assegnato a uno scopo (il caso d'uso concreto). Solo attraverso lo scopo il sistema sa quale modello caricare in un determinato flusso.

Tipo	A cosa serve
Fattura (`invoice`)	Layout e testo dei PDF delle fatture
E-mail (`email`)	E-mail di sistema: conferma d'ordine, accesso al corso, assegnazione di compiti obbligatori, e-mail di benvenuto, promemoria del corso e altre
Certificato (`certificate`)	Layout e testo dei certificati di completamento
Promemoria compiti obbligatori (`assignment-reminder`)	E-mail di promemoria per compiti obbligatori in scadenza

I certificati li progettano spesso i formatori stessi

Come costruire i modelli di certificato, impostare layout e segnaposto e assegnarli a un corso o a un percorso di apprendimento è descritto in dettaglio in Modelli di certificato per i formatori.

Visualizzare i modelli esistenti¶

Nell'app apri la sezione di menu Gestione → Modelli.
Vedi tutti i modelli della tua azienda come elenco di riquadri con filtro per tipo e piccola anteprima.
Un clic su un riquadro apre l'editor con anteprima e opzioni di modifica.

Per ogni riquadro puoi:

Modificare — apre l'editor
Duplicare — crea una copia come punto di partenza per una nuova variante
Eliminare

Screenshot in arrivo

Panoramica dei modelli con filtro per tipo e riquadri di anteprima

Prima copia, poi adatta

Invece di costruire ogni modello da zero, conviene duplicarne uno esistente — spesso esiste già un modello standard con logo e design che puoi usare come base.

Creare un nuovo modello¶

Clicca su Nuovo.
Compila i campi:
Nome — ad es. "E-mail di benvenuto 2026"
Tipo — Fattura, E-mail, Certificato o Promemoria compiti obbligatori
Slug (identificatore breve) — deve essere univoco all'interno della tua azienda e dello stesso tipo
facoltativamente una descrizione
Scrivi il contenuto nell'editor — vedi le sezioni successive.
Verifica l'anteprima (HTML e/o PDF).
Salva.

L'editor¶

L'editor è un editor WYSIWYG ("quello che vedi è quello che ottieni") — formatti direttamente, senza conoscenze di HTML:

Formattazione del testo: grassetto, corsivo, sottolineato
Titoli, elenchi, allineamento
Immagini, link, righe divisorie, tabelle
Inserimento di segnaposto: tramite un menu a tendina scegli segnaposto categorizzati (Azienda, Cliente, Ordine, Corso, Documento). Il segnaposto scelto compare come pillola colorata nel testo e viene assunto automaticamente in modo corretto al salvataggio.
Blocchi per fattura (solo nei modelli di fattura): blocchi predefiniti per intestazione della fattura, blocco cliente, tabella delle voci, blocco totali e piè di pagina.
Modalità HTML per utenti esperti che vogliono modificare direttamente il codice sorgente.

Screenshot in arrivo

Editor con menu a tendina dei segnaposto e pillole colorate nel testo

Inserire i segnaposto¶

I segnaposto sono spazi vuoti che al momento dell'invio vengono riempiti con dati reali — ad es. il nome della persona o il nome del corso. Il modo più semplice per inserirli è tramite il menu a tendina.

Attenzione alla scrittura

I modelli di tipo Promemoria compiti obbligatori usano segnaposto in camelCase (ad es. firstName, courseUrl). Tutti gli altri tipi usano snake_case con trattini bassi (ad es. first_name, course_url). Il modo più sicuro è inserire i segnaposto tramite il menu a tendina, così la scrittura è corretta.

Una selezione dei segnaposto più importanti per tipo:

Tipo	Segnaposto di esempio
Fattura	`company_name`, `company_logo`, `invoice_number`, `invoice_date`, `customer_name`, `total`, `currency`
E-mail	`first_name` (nome), `user_name`, `course_name`, `course_url` (link al corso), `company_name`, `company_logo`, `login_url`
Certificato	`user_name`, `course_name`, `completion_date`, `score_percent`, `qr_code`, `company_name`, `company_logo`
Promemoria compiti obbligatori	`firstName` (nome), `studentName`, `courseName`, `dueDate`, `daysRemaining`, `courseUrl` (link al corso), `companyName`

Segnaposto più recenti

Da giugno 2026 esistono il nome (first_name ovvero firstName, ricavato automaticamente dal nome completo) e un link diretto al corso (course_url ovvero courseUrl). Per i certificati sono inoltre disponibili qr_code (QR code per la verifica), company_name e company_logo (branding aziendale). La selezione completa per ogni modello te la mostra il menu a tendina dei segnaposto nell'editor.

I segnaposto di data vengono rappresentati automaticamente come TT.MM.JJJJ. Se scrivi un segnaposto in modo errato, viene evidenziato in giallo nell'anteprima — così riconosci subito gli errori di battitura.

Usare l'anteprima¶

Prima che un modello vada in produzione, controllalo sempre nell'anteprima. Ci sono due modalità:

Anteprima HTML (standard) — mostra il modello con dati di esempio (ad es. "Muster GmbH", "Max Mustermann"). I segnaposto mancanti o scritti in modo errato sono contrassegnati in giallo.
Anteprima PDF — genera un vero PDF (fatture in verticale, certificati in orizzontale) e lo apre in una nuova scheda.

A cosa dovresti fare attenzione:

Tutti i segnaposto vengono sostituiti correttamente? (Nessuna evidenziazione gialla rimasta.)
Il layout è corretto — nessun testo va oltre il bordo?
Il logo è ben posizionato e nitido?
Se qualcosa non va: adatta, nuova anteprima, finché non è corretto.

Versioni — recuperare stati precedenti¶

Ogni salvataggio crea automaticamente una nuova versione. Così puoi annullare le modifiche in qualsiasi momento:

Nell'editor apri la cronologia delle versioni (barra laterale/drawer).
Vedi numero di versione, marca temporale e — se presente — un commento sulla modifica.
Un clic su una versione precedente la ripristina in anteprima nell'editor.
Per applicarla definitivamente, salva in seguito — questo crea a sua volta una nuova versione.

Screenshot in arrivo

Cronologia delle versioni con marche temporali e azione di ripristino

Assegnare un modello a uno scopo¶

Perché un modello venga effettivamente usato, deve essere assegnato a uno scopo.

In Gestione → Modelli apri la scheda Assegnazioni.
Vedi per ogni scopo quale modello è attualmente attivo:
Standard di sistema (contrassegnato in grigio) — non esiste un modello proprio; il sistema usa il suo modello standard.
Modello proprio — è assegnato un modello curato dalla tua azienda.
Per ogni scopo sono disponibili tre azioni:
Crea nuovo — crea un modello vuoto per questo scopo
Assegna esistente — seleziona un modello esistente
Rimuovi assegnazione — torna allo standard di sistema

Qualcosa esce sempre

Anche senza un modello proprio l'invio funziona: il sistema usa prima il tuo modello proprio, altrimenti lo standard di sistema. Il layout e il testo sono allora generici — ma nessuno riceve un'e-mail vuota.

Assegnare rimanda, non copia

"Assegna esistente" crea un rimando al tuo modello, non una copia. Puoi quindi assegnare lo stesso modello a più scopi, e se lo modifichi la modifica ha effetto ovunque immediatamente. "Rimuovi assegnazione" scioglie solo il rimando — il modello stesso rimane nell'elenco.

Domande frequenti¶

Ho creato un modello, ma non viene usato. Verifica in Assegnazioni se il modello è assegnato allo scopo adeguato. Un modello creato da solo non basta — deve ancora essere assegnato.

Il mio segnaposto compare in giallo nell'anteprima. Allora è scritto in modo errato oppure mancano i dati. Fai attenzione alla scrittura corretta (Promemoria compiti obbligatori: camelCase, altrimenti snake_case) — il modo più sicuro è inserirlo tramite il menu a tendina.

Posso annullare una modifica? Sì, tramite la cronologia delle versioni ripristina una versione precedente e salva.

Come creo e progetto esattamente i certificati? È descritto in dettaglio in Modelli di certificato per i formatori.

Che relazione hanno i promemoria dei compiti obbligatori con i modelli? Le e-mail di promemoria per i compiti obbligatori in scadenza usano il modello di tipo Promemoria compiti obbligatori. Come assegnare i compiti obbligatori è descritto in Compiti obbligatori.