DGTLMS & LMSDISPATCHER Guide

Amministrazione

Le variabili dei modelli Word e RTF

L'elenco completo dei segnaposto da inserire in un modello Word (.docx) o RTF — attestato, scheda dell'account, statistiche — con un esempio pronto da ricopiare per ogni modello.

Amministratore~10 minutiIntermedio

Il principio

Un modello scaricabile è un documento che impagini tu stesso in Word (o in qualsiasi programma di videoscrittura che salva in RTF). Vi digiti dei segnaposto nel punto in cui deve comparire un dato; al momento dell'esportazione, la piattaforma li sostituisce con i valori reali e produce un file per studente (raggruppati in un .zip quando ce ne sono diversi).

Esistono due sintassi, a seconda del formato del file caricato:

Formato del modelloSintassi di un segnapostoEsempio
Word (.docx)dollaro e parentesi graffe${prenom} ${nom}
RTF (.rtf)racchiuso tra chiocciole@prenom@ @nom@

Le due sintassi non si mescolano: in un .docx, @nom@ resta così com'è, e viceversa.

> I modelli PDF personalizzati utilizzano una terza famiglia di variabili (@m_user_name@…), descritta in I modelli di report. Questa scheda riguarda solo i modelli scaricabili Word e RTF.

Quale modello accetta cosa

ModelloWord .docxRTF .rtfUn documento per…
Certificato (attestato di frequenza) e le sue copiesìsìstudente
Scheda dell'account (scheda amministrativa)nosìstudente
Statistiche di connessionenosìesportazione
Statistiche del tempo di formazionenosìesportazione
Statistiche delle e-mailnosìesportazione

In Analyser (analizza) → Modelli, questi modelli sono raggruppati sotto Scaricabili. Un certificato il cui file è un .docx riporta il badge WORD.

  • Un account che può modificare i modelli di report (amministratore).
  • Word, LibreOffice o qualsiasi programma di videoscrittura in grado di salvare in .docx o in .rtf.
  • Per i campi personalizzati: il loro numero (da 1 a 20 per gli account), visibile in Amministrazione → Campi personalizzati.

Passaggi

  1. Aprire i modelli

    Analyser → Modelli, sezione Scaricabili.

  2. Duplicare il certificato

    clicca su Copia accanto al certificato fornito: lavori su una copia, l'originale resta intatto.

  3. Scaricare l'esempio Word

    apri la copia con Modificare, poi clicca su Scarica un modello Word di esempio: è un .docx che contiene già tutti i segnaposto.

  4. Impaginare in Word

    logo, colori, testo, firma. Mantieni i segnaposto ${…} dove devono comparire i dati.

  5. Caricare il file

    torna su Modificare, scegli il tuo .docx (o .rtf) in File del modello (RTF o Word .docx), poi Convalidare.

  6. Provare su uno studente

    avvia l'esportazione del certificato su un solo studente e apri il file ottenuto prima di diffonderlo più ampiamente.

Certificato Word: i segnaposto

Studente

SegnapostoSostituito daEsempio di risultato
${nom}Cognome dello studenteRossi
${prenom}NomeChiara
${email}Indirizzo e-mailchiara.rossi@esempio.it
${service}ServizioRisorse umane
${cpmb1} … ${cpmb20}Campo personalizzato n. 1–20 dell'accountMatricola 40127
${photo}Foto del profilo, come immagine (vuoto se non c'è foto)(immagine)
${date}Data del giorno dell'esportazione10/11/2026

Sintesi — calcolata sull'insieme delle sessioni, dei corsi o delle attività coperti dal certificato.

SegnapostoSostituito daEsempio di risultato
${temps}Tempo totale impiegato12h 35min
${passages}Numero totale di accessi18
${avancement}Stato complessivo: «Non cominciato», «In corso», «Finito, non convalidato» o «Convalidato»Convalidato
${premiere_connexion}Prima connessione — solo certificato di corso02/09/2026
${derniere_connexion}Ultima connessione — solo certificato di corso28/10/2026

Righe della tabella di dettaglio — da inserire in una riga di tabella Word. La riga che contiene ${ligne} viene ricopiata tutte le volte necessarie: una volta per sessione, poi per ciascuno dei suoi corsi, poi per ciascuna delle loro attività.

SegnapostoSostituito daEsempio di risultato
${ligne}Titolo, rientrato verso destra secondo il livelloExcel — le basi
${type}Sessione, Formazione o AttivitàFormazione
${score}Punteggio migliore (trattino se assente)85 %
${temps_ligne}Tempo impiegato su questo elemento2h 05
${debut}Data di inizio — solo righe di sessione01/09/2026
${fin}Data di fine — solo righe di sessione31/12/2026

Esempio: un attestato Word

Il testo così come lo digiti in Word; le parentesi quadre rappresentano una tabella di quattro colonne, la cui seconda riga è quella ripetuta.

Corpo dell'attestato (Word)
ATTESTATO DI FREQUENZA

Il/La sottoscritto/a, responsabile della formazione, attesta che
${prenom} ${nom} (${email}), servizio ${service},
ha seguito il programma riportato di seguito.

Tempo totale: ${temps}    Accessi: ${passages}    Stato: ${avancement}

[ Titolo    | Tipo    | Punteggio | Tempo          ]
[ ${ligne}  | ${type} | ${score}  | ${temps_ligne} ]

Rilasciato il ${date}.

Risultato per una studentessa iscritta a una sessione di due corsi:

Documento prodotto
ATTESTATO DI FREQUENZA

Il/La sottoscritto/a, responsabile della formazione, attesta che
Chiara Rossi (chiara.rossi@esempio.it), servizio Risorse umane,
ha seguito il programma riportato di seguito.

Tempo totale: 12h 35min    Accessi: 18    Stato: Convalidato

[ Titolo                       | Tipo        | Punteggio | Tempo ]
[ Office 2026                  | Sessione    | 82 %      | 12h 35 ]
[     Excel — le basi          | Formazione  | 85 %      | 7h 10 ]
[         Quiz finale          | Attività    | 90 %      | 0h 25 ]
[     Word — livello avanzato  | Formazione  | 78 %      | 5h 25 ]

Rilasciato il 10/11/2026.

Certificato RTF: le variabili

Variabili globali — utilizzabili in qualsiasi punto del documento.

VariabileSostituita da
@nom@, @prenom@, @email@, @service@Identità dello studente
@cpmb1@ … @cpmb20@Campo personalizzato n. 1–20 dell'account
@photo@Foto del profilo (35 × 45 mm), oppure niente
@temps@Tempo totale impiegato, ad esempio «12h 35min»
@pres@Numero totale di accessi
@avancement@Stato complessivo
@first_connexion_date@, @last_connexion_date@Prima e ultima connessione — solo certificato di corso

Zona ripetuta — il dettaglio si inserisce tra @debut_champs@ e @fin_champs@. Al suo interno, ogni livello ha il proprio blocco, che la piattaforma ricopia per ogni elemento:

BloccoRipetuto per ogni…Variabili del blocco
@debut_champ_session@ … @fin_champ_session@sessione@Session@ (nome), @S%@ (punteggio), @Sh@ (tempo), @Sdebut@, @Sfin@ (date), @cpse1@ … @cpse10@ (campi personalizzati della sessione)
@debut_champ_parcours@ … @fin_champ_parcours@corso della sessione@Parcours@ (titolo), @P%@, @Ph@, @cppa1@ … @cppa10@ (campi personalizzati del corso)
@debut_champ_UA@ … @fin_champ_UA@attività del corso@UA@ (titolo), @u%@, @uh@

L'ordine di uscita segue la struttura ad albero: una sessione, i suoi corsi, le attività di ciascun corso, poi la sessione successiva.

Esempio: un attestato RTF

Modello RTF (testo digitato in Word, salvato in .rtf)
ATTESTATO — @prenom@ @nom@ (@service@)
Tempo totale: @temps@ — @pres@ accessi — @avancement@

@debut_champs@
@debut_champ_session@Sessione @Session@ dal @Sdebut@ al @Sfin@: @S%@ in @Sh@
@fin_champ_session@
@debut_champ_parcours@    Corso @Parcours@: @P%@ in @Ph@
@fin_champ_parcours@
@debut_champ_UA@        Attività @UA@: @u%@ in @uh@
@fin_champ_UA@
@fin_champs@

Documento rilasciato per gli usi consentiti dalla legge.
Documento prodotto
ATTESTATO — Chiara Rossi (Risorse umane)
Tempo totale: 12h 35min — 18 accessi — Convalidato

Sessione Office 2026 dal 01/09/2026 al 31/12/2026: 82 % in 12h 35
    Corso Excel — le basi: 85 % in 7h 10
        Attività Quiz finale: 90 % in 0h 25
    Corso Word — livello avanzato: 78 % in 5h 25

Documento rilasciato per gli usi consentiti dalla legge.

Scheda dell'account (RTF)

Una scheda per studente, che riprende la sua identità e il suo piano di formazione.

VariabileSostituita da
@nom@, @prenom@, @email@, @service@, @cpmb1@ … @cpmb20@, @photo@Come per il certificato
@xx/xx/xx@Data di inizio validità dell'account
@yy/yy/yy@Data di fine validità dell'account
@VARIABLES_ADMIN@Tutti i campi personalizzati visibili dell'account, uno per riga: «Etichetta: valore»
@PLAN_FORMATION@Il piano di formazione: ogni sessione, i suoi corsi e le loro attività (con la data pianificata quando ce n'è una)
Esempio di scheda dell'account
SCHEDA DEL PARTECIPANTE
@prenom@ @nom@ — @email@
Account aperto dal @xx/xx/xx@ al @yy/yy/yy@

Informazioni aggiuntive:
@VARIABLES_ADMIN@

Piano di formazione:
@PLAN_FORMATION@

Statistiche di connessione e del tempo di formazione (RTF)

Un solo documento per esportazione, che copre gli utenti del filtro.

Tabella per periodo — le colonne sono numerate da 1 a 6: oggi, ieri, ultimi 7 giorni, questo mese, quest'anno, totale.

VariabileSostituita da
@titre_doc@, @titre_periode@Titolo del documento, intestazione «Periodo»
@periode_1@ … @periode_6@Etichetta di ogni periodo (Oggi… Totale)
@titre_nombre_1@, @titre_nombre_2@Intestazioni «Numero di collegamenti» e «Tempo trascorso»
@nombre_1_N@Numero di connessioni (o di accessi) per il periodo N
@nombre_2_N@Tempo impiegato per il periodo N, nel formato 12:05:33
@titre_nombre_3@ … @titre_nombre_6@Connessioni — intestazioni studenti poi formatori
@nombre_3_N@, @nombre_4_N@Connessioni — numero e tempo degli studenti
@nombre_5_N@, @nombre_6_N@Connessioni — numero e tempo dei formatori

Cronologia dettagliata — la riga inserita tra @debut_champs_detail@ e @fin_champs_detail@ viene ripetuta per ogni connessione (o ogni accesso), sul periodo scelto al momento dell'esportazione.

VariabileSostituita da
@titre_detail@, @titre_nom@, @titre_date@, @titre_duree@Intestazioni della tabella
@titre_ua@Intestazione «Risorsa» — solo tempo di formazione
@nom@Cognome e nome
@ua@Attività seguita — solo tempo di formazione
@date@Data e ora, ad esempio 28/10/2026 14:32
@duree@Durata, nel formato 0:42:10
Esempio: statistiche di connessione
@titre_doc@

| @titre_periode@ | @titre_nombre_1@ | @titre_nombre_2@ |
| @periode_1@     | @nombre_1_1@     | @nombre_2_1@     |
| @periode_3@     | @nombre_1_3@     | @nombre_2_3@     |
| @periode_6@     | @nombre_1_6@     | @nombre_2_6@     |

@titre_detail@
| @titre_nom@ | @titre_date@ | @titre_duree@ |
@debut_champs_detail@| @nom@ | @date@ | @duree@ |
@fin_champs_detail@

Non sei obbligato a utilizzare tutti i periodi: una variabile assente dal modello viene semplicemente ignorata.

Statistiche delle e-mail (RTF)

Stessa tabella per periodo di quella sopra, senza cronologia dettagliata: @titre_doc@, @titre_periode@, @periode_1@ … @periode_6@, @titre_nombre_1@ (messaggi in totale), @titre_nombre_2@ (messaggi di appuntamento), @nombre_1_N@ e @nombre_2_N@.

  • Digita ogni segnaposto in un colpo solo, senza correggerlo lettera per lettera né cambiare carattere a metà. Word a volte spezza una parola ritoccata in più pezzi invisibili, e il segnaposto non viene più riconosciuto. Nel dubbio, cancellalo e ridigitalo per intero — oppure copialo da questa scheda.
  • Rispetta maiuscole e minuscole: @Session@ e @session@ non sono la stessa variabile; ${Nom} non viene riconosciuto.
  • RTF: nulla viene conservato tra @debut_champs@ e il primo blocco. Inserisci le intestazioni di colonna prima di @debut_champs@, altrimenti scompaiono dal documento.
  • Word: ${ligne} deve trovarsi in una riga di tabella. Inserito fuori da una tabella, fa fallire l'esportazione del certificato. Se non vuoi il dettaglio, togli semplicemente ${ligne} e i segnaposto della sua riga.
  • Un segnaposto scritto male resta visualizzato così com'è nel documento: è l'indizio migliore di un errore di battitura.
  • Le date escono nel formato gg/mm/aaaa; un trattino sostituisce un punteggio o una data assenti.
  • Il tempo di una riga si mostra in ore e minuti («2h 05»), il tempo totale con l'unità («12h 35min»).
  • Un & o un < in un nome non rompe il documento Word: i valori vengono protetti automaticamente.
  • La dichiarazione fiscale 2483 compare nell'elenco dei modelli RTF, ma la sua generazione non è garantita dalla piattaforma: preferisci un'esportazione CSV per prepararla.
  • Un certificato Word o RTF si invia anche tramite un'automazione (azione «Inviare un rapporto»); la scheda dell'account e le statistiche si generano solo su richiesta.

Vedi anche