Cosa fa il connettore
Una volta collegati, Dendreo e DGTLMS lavorano insieme senza doppio inserimento:
- Da Dendreo a DGTLMS — ogni sessione creata in Dendreo diventa una sessione DGTLMS collegata al corso scelto; ogni partecipante riceve un account; ogni iscrizione lo iscrive alla sua sessione. Modifiche e annullamenti seguono.
- Da DGTLMS a Dendreo — i progressi di ogni partecipante (avanzamento, punteggio, tempo trascorso, date) tornano a Dendreo man mano.
- Accesso con un clic — dall'extranet Dendreo, il partecipante apre il suo corso in DGTLMS senza digitare una password.
È Dendreo a chiamare DGTLMS: non c'è alcuna sincronizzazione da avviare né mappatura da gestire in DGTLMS.
- Un account DGTLMS con il diritto di configurare i connettori.
- Lato Dendreo: il tuo Tenant ID, il segreto JWT (accesso con un clic) e il segreto dei webhook. Li fornisce Dendreo, oppure si generano con Dendreo all'attivazione del connettore LMS.
- Lato DGTLMS: la chiave API della tua piattaforma. È definita dal tuo hosting nella configurazione del server; richiedila a DGT Concept.
- I corsi usati in Dendreo devono essere pubblicati (stato attivo): una sessione creata su un corso in bozza o da riconvalidare viene rifiutata.
Passaggi in DGTLMS
Aprire la dashboard
Amministrazione → Integrazioni e connettori, scheda Dendreo.Inserire i dati di connessione
pulsante « Renseigner les informations de connexion à Dendreo » (inserisci i dati di connessione a Dendreo): compila i tre campi obbligatori (vedi I campi da compilare più sotto).
Opzioni avanzate
facoltative: da compilare solo nei casi descritti più sotto.
Salvare e attivare
« Enregistrer et activer » (salva e attiva). La configurazione viene salvata sul server e il connettore diventa attivo. I segreti non vengono più mostrati: lascia vuoto un campo segreto per mantenerne il valore attuale.
Mettere in pausa se necessario
l'interruttore della scheda sospende gli scambi senza cancellare la configurazione.
I campi da compilare
- Tenant ID (obbligatorio) — l'identificativo del tuo spazio Dendreo.
- JWT Secret (obbligatorio) — il segreto condiviso che firma l'accesso con un clic.
- Webhook Secret (obbligatorio) — il segreto che firma gli scambi nei due sensi.
- Webhook URL — l'indirizzo Dendreo che riceve i progressi. Lascialo vuoto per l'indirizzo standard di Dendreo.
- Return URL — l'indirizzo di ritorno a Dendreo dopo l'accesso con un clic.
- Site ID — da compilare se la piattaforma ha più siti e Dendreo deve vedere solo i corsi di uno di essi.
- Allowed Hosts — da compilare solo se Dendreo ti comunica un indirizzo di ricezione diverso da
hooks.dendreo.com(ad esempio un ambiente di test).
Cosa comunicare a Dendreo
Comunica a Dendreo (o inserisci nella configurazione del connettore LMS di Dendreo):
- L'indirizzo dell'API DGTLMS:
https://<tua-piattaforma>/api/dendreo— ad esempiohttps://formazione.mio-ente.it/api/dendreo. - L'indirizzo di accesso con un clic:
https://<tua-piattaforma>/api/dendreo/auth/jwt. - La chiave API DGTLMS e il tuo Tenant ID: Dendreo li usa per leggere l'elenco dei tuoi corsi.
- I due segreti (JWT e webhook): sono gli stessi valori da entrambe le parti. Se uno cambia in Dendreo, riportalo subito in DGTLMS, e viceversa.
Verificare il collegamento
L'API risponde
apri
https://<tua-piattaforma>/api/dendreo/healthin un browser: devi leggere"status": "ok"e"database": "connected".Dendreo vede il tuo catalogo
in Dendreo deve comparire l'elenco dei corsi DGTLMS. Se è vuoto, verifica la chiave API, il Tenant ID e, se l'hai compilato, il Site ID.
Una sessione di prova
crea in Dendreo una sessione su un corso pubblicato, con un partecipante di prova. In DGTLMS la sessione compare e la scheda Dendreo conta un utente e un'iscrizione in più.
L'accesso con un clic
dall'extranet Dendreo, apri il corso con il partecipante di prova: deve arrivare direttamente in DGTLMS.
I progressi
svolgi un'attività con questo partecipante: il suo avanzamento deve comparire in Dendreo.
Come vengono abbinati i dati
- Corsi — Dendreo mostra il tuo catalogo DGTLMS in due famiglie: « [Parcours] », i tuoi corsi, e « [Session] », le tue sessioni DGTLMS esistenti. Scegli un corso perché DGTLMS crei una sessione a partire da ogni sessione Dendreo, oppure una sessione esistente per iscrivervi direttamente i partecipanti.
- Partecipanti — un partecipante la cui e-mail (o login) corrisponde a un account studente DGTLMS viene collegato a quell'account; altrimenti viene creato un account studente. Un account formatore o amministratore non viene mai collegato: la persona riceve un account studente distinto.
- Sessioni e iscrizioni — ritrovate tramite il loro identificativo Dendreo: una modifica o un annullamento in Dendreo aggiorna lo stesso elemento, senza duplicati.
- Progressi — inviati a ogni avanzamento. Se Dendreo non risponde, DGTLMS riprova automaticamente, a intervalli sempre più distanziati, finché Dendreo non conferma la ricezione.
- Corso non pubblicato — compare nell'elenco di Dendreo, ma la creazione della sessione viene rifiutata: pubblica il corso, poi reinvia o ricrea la sessione da Dendreo.
- Segreto modificato da una sola parte — gli scambi vengono rifiutati (errore di autenticazione) finché i due valori non coincidono.
- Accesso con un clic riservato agli studenti — non apre mai un account formatore o amministratore. Un formatore iscritto come partecipante in Dendreo riceve un account studente distinto, con il login
dendreo_<identificativo Dendreo>se la sua e-mail è già usata come login.
- Il connettore gestisce iscrizioni e progressi, non le presenze: le presenze sono gestite da altri strumenti (es. Edusign).
- Un reinvio trasmette lo stato attuale dei progressi dell'iscrizione: non si somma al precedente.
- La scheda Dendreo della dashboard mostra il numero di utenti e di iscrizioni ricevuti da Dendreo: è il modo più semplice per vedere che gli scambi passano.