Was der Konnektor leistet
Einmal verbunden, arbeiten Dendreo und DGTLMS ohne doppelte Erfassung zusammen:
- Von Dendreo zu DGTLMS – jede in Dendreo angelegte Session wird zu einer DGTLMS-Session, die mit der gewählten Schulung verknüpft ist; jede teilnehmende Person erhält ein Konto; jede Einschreibung schreibt sie in ihre Session ein. Änderungen und Stornierungen werden übernommen.
- Von DGTLMS zu Dendreo – der Fortschritt jeder teilnehmenden Person (Bearbeitungsstand, Punktzahl, Lernzeit, Daten) wird laufend an Dendreo zurückgemeldet.
- Anmeldung mit einem Klick – aus dem Dendreo-Extranet öffnet die teilnehmende Person ihre Schulung in DGTLMS, ohne ein Passwort einzugeben.
Dendreo ruft DGTLMS auf: Es gibt keine Synchronisierung zu starten und keine Zuordnung, die in DGTLMS gepflegt werden muss.
- Ein DGTLMS-Konto mit dem Recht, Konnektoren zu konfigurieren.
- Auf Dendreo-Seite: Ihre Tenant ID, das JWT-Secret (Anmeldung mit einem Klick) und das Webhook-Secret. Dendreo stellt sie bereit oder erzeugt sie gemeinsam mit Ihnen bei der Aktivierung des LMS-Konnektors.
- Auf DGTLMS-Seite: der API-Schlüssel Ihrer Plattform. Er wird von Ihrem Hosting-Anbieter in der Serverkonfiguration festgelegt; fragen Sie DGT Concept danach.
- Die in Dendreo verwendeten Schulungen müssen veröffentlicht sein (Status aktiv): Eine Session zu einer Schulung im Entwurf oder in erneuter Freigabe wird abgelehnt.
Schritte in DGTLMS
Dashboard öffnen
Administration → Integrationen & Konnektoren, Karte Dendreo.Verbindungsdaten eintragen
Schaltfläche „Renseigner les informations de connexion à Dendreo“ (Verbindungsdaten zu Dendreo eintragen): Füllen Sie die drei Pflichtfelder aus (siehe Die auszufüllenden Felder unten).
Erweiterte Optionen
optional: nur in den unten beschriebenen Fällen ausfüllen.
Speichern und aktivieren
„Enregistrer et activer“ (speichern und aktivieren). Die Konfiguration wird auf dem Server gespeichert und der Konnektor ist aktiv. Secrets werden nie wieder angezeigt: Lassen Sie ein Secret-Feld leer, um seinen aktuellen Wert zu behalten.
Bei Bedarf pausieren
der Schalter auf der Karte unterbricht den Austausch, ohne die Konfiguration zu löschen.
Die auszufüllenden Felder
- Tenant ID (Pflichtfeld) – die Kennung Ihres Dendreo-Bereichs.
- JWT Secret (Pflichtfeld) – das gemeinsame Secret, das die Anmeldung mit einem Klick signiert.
- Webhook Secret (Pflichtfeld) – das Secret, das den Austausch in beide Richtungen signiert.
- Webhook URL – die Dendreo-Adresse, die den Fortschritt empfängt. Leer lassen für die Standardadresse von Dendreo.
- Return URL – die Rücksprungadresse zu Dendreo nach der Anmeldung mit einem Klick.
- Site ID – ausfüllen, wenn Ihre Plattform mehrere Standorte hat und Dendreo nur die Schulungen eines davon sehen soll.
- Allowed Hosts – nur ausfüllen, wenn Dendreo Ihnen eine andere Empfangsadresse als
hooks.dendreo.comnennt (zum Beispiel eine Testumgebung).
Was Sie an Dendreo übermitteln
Übermitteln Sie Dendreo (oder tragen Sie in der Konfiguration des LMS-Konnektors von Dendreo ein):
- Die Adresse der DGTLMS-API:
https://<ihre-plattform>/api/dendreo– zum Beispielhttps://schulung.meine-organisation.de/api/dendreo. - Die Adresse für die Anmeldung mit einem Klick:
https://<ihre-plattform>/api/dendreo/auth/jwt. - Den DGTLMS-API-Schlüssel und Ihre Tenant ID: Dendreo liest damit die Liste Ihrer Schulungen.
- Beide Secrets (JWT und Webhooks): Es sind auf beiden Seiten dieselben Werte. Ändert sich eines bei Dendreo, tragen Sie es sofort in DGTLMS nach, und umgekehrt.
Die Verbindung prüfen
Die API antwortet
öffnen Sie
https://<ihre-plattform>/api/dendreo/healthin einem Browser: Sie sollten"status": "ok"und"database": "connected"lesen.Dendreo sieht Ihren Katalog
in Dendreo muss die Liste der DGTLMS-Schulungen erscheinen. Ist sie leer, prüfen Sie den API-Schlüssel, die Tenant ID und, falls ausgefüllt, die Site ID.
Eine Test-Session
legen Sie in Dendreo eine Session zu einer veröffentlichten Schulung an, mit einer Testperson. In DGTLMS erscheint die Session, und die Dendreo-Karte zählt eine Person und eine Einschreibung mehr.
Die Anmeldung mit einem Klick
öffnen Sie aus dem Dendreo-Extranet die Schulung als Testperson: Sie sollte direkt in DGTLMS landen.
Der Fortschritt
bearbeiten Sie als diese Person eine Aktivität: Ihr Fortschritt sollte in Dendreo erscheinen.
Wie die Daten zugeordnet werden
- Schulungen – Dendreo zeigt Ihren DGTLMS-Katalog in zwei Gruppen: „[Parcours]“, Ihre Schulungen, und „[Session]“, Ihre bestehenden DGTLMS-Sessions. Wählen Sie eine Schulung, damit DGTLMS aus jeder Dendreo-Session eine Session anlegt, oder eine bestehende Session, um die Teilnehmenden direkt dort einzuschreiben.
- Teilnehmende – eine Person, deren E-Mail-Adresse (oder Login) zu einem DGTLMS-Lernendenkonto passt, wird mit diesem Konto verknüpft; andernfalls wird ein Lernendenkonto angelegt. Ein Trainer- oder Administratorkonto wird nie verknüpft: Die Person erhält ein eigenes Lernendenkonto.
- Sessions und Einschreibungen – über ihre Dendreo-Kennung wiedergefunden: Eine Änderung oder Stornierung in Dendreo aktualisiert dasselbe Element, ohne Duplikat.
- Fortschritt – bei jedem Fortschritt gesendet. Antwortet Dendreo nicht, versucht DGTLMS es automatisch erneut, in immer größeren Abständen, bis Dendreo den Empfang bestätigt.
- Nicht veröffentlichte Schulung – sie erscheint in der Liste von Dendreo, aber das Anlegen der Session wird abgelehnt: Veröffentlichen Sie die Schulung und senden Sie die Session dann aus Dendreo erneut oder legen Sie sie neu an.
- Secret nur auf einer Seite geändert – der Austausch wird abgelehnt (Authentifizierungsfehler), bis beide Werte übereinstimmen.
- Anmeldung mit einem Klick nur für Lernende – sie öffnet nie ein Trainer- oder Administratorkonto. Eine Trainerin oder ein Trainer, die in Dendreo als Teilnehmende eingeschrieben sind, erhalten ein eigenes Lernendenkonto, mit dem Login
dendreo_<Dendreo-Kennung>, wenn ihre E-Mail-Adresse bereits als Login dient.
- Der Konnektor verwaltet Einschreibungen und Fortschritt, nicht die Anwesenheit: Diese läuft über andere Werkzeuge (z. B. Edusign).
- Ein erneuter Versand übermittelt den aktuellen Stand des Fortschritts der Einschreibung: Er wird nicht zum vorherigen addiert.
- Die Dendreo-Karte im Dashboard zeigt die Zahl der von Dendreo empfangenen Personen und Einschreibungen: der einfachste Weg zu sehen, dass der Austausch funktioniert.