Schnittstelle zur DRK-Dienstleistungsdatenbank

Nach Aktivierung dieser Schnittstelle werden alle im HiOrg-Server neu angelegten Kurstermine der Breitenausbildung mit der Dienstleistungs-Datenbank (DLDB) des DRK synchronisiert. Damit können Sie diese Kurstermine über ein vom DRK angebotenes Plugin automatisch in der Typo3-Website des DRK-Kreisverbandes anzeigen lassen.

1. Sie kennen den für Ihren Verband passenden „API-Key“ - diesen erhalten Sie auf Anfrage an wbm@drk-intern.de
2. in der DLDB müssen alle in Ihrem Verband angebotenen Kurstypen freigeschaltet sein. Dies erkennen Sie daran, dass im Menü „Webseitenpfade“ bei jedem angebotenen Kurstyp ein Häkchen gesetzt ist. Sollte dies nicht (oder nicht vollständig) der Fall sein, wenden Sie sich bitte an den dort im Seitenkopf angegebenen Ansprechpartner (siehe: „Sollen Häkchen geändert werden,…“)

1. wählen Sie im Bereich „System - Einstellungen - Breitenausbildung: BA allgemein“ unter „Verknüpfung mit externer Kursdatenbank“ den Eintrag aus: „Dienstleistungsdatenbank des DRK“
2. tragen Sie dort den vom DRK-GS erhaltenen API-Key ein, und klicken darunter auf [Änderungen speichern].
3. Wechseln Sie auf die Seite „System - Einstellungen - Breitenausbildung: Kurstypen/Lehrscheine“ und verknüpfen dort jeden Kurstyp, welcher in der Folge mit der DLDB synchronisiert werden soll. Dazu klicken Sie auf das [Stift]-Symbol des Kurstyps, und wählen im Abschnitt „Verknüpfung mit externer Kursdatenbank“ die korrespondierende Bezeichnung der DLDB. Klicken Sie auf [Geänderte Daten speichern] - und ändern Sie dann ggf. weitere Kurstypen analog.

Ab sofort werden alle neu in den HiOrg-Server eingetragenen Kurse mit der DLDB synchronisiert. Dies können Sie überprüfen, indem Sie sich auf der Weboberfläche der DLDB anmelden, und dort im Menü „Dienstleistungen“ auf den passenden Kurstyp klicken. Die einzelnen Kurstermine werden ganz unten auf der Seite aufgelistet.
Achtung: die Weboberfläche der DLDB zeigt neu synchonisierte Kurstermine manchmal erst dann an, wenn Sie sich dort komplett abmelden und neu anmelden.

Um die von HiOrg-Server zur DLDB synchronisierten Kurstermine korrekt anzeigen zu können, und damit auch der Link zur Online-Anmeldung korrekt erzeugt wird, muss das Plugin „DRK Kurstermine“ mindestens in Version 0.2.3 installiert sein.

Ist dies nicht der Fall, können Sie das Plugin hier downloaden und dann in Ihre Typo3-Installation importieren:

Im Bereich „Template - Konstanten“ müssen Sie die Organisations-ID Ihrer Gliederung hinterlegen. ACHTUNG: dies ist NICHT das „Organisations-Kürzel“ Ihres HiOrg-Servers, sondern eine meist 4-stellige ZAHLENFolge, welche Ihrer Gliederung vom DRK-GS vergeben wird:

In der Mustervorlage der KV-Website ist das Plugin „DRK Kurstermine“ bereits auf allen entsprechenden Seiten der Breitenausbildung eingebunden. Damit dieses auch korrekt funktioniert, müssen Sie nur noch auf jeder dieser Seiten den für das jeweilige Plugin gewählten Kurstyp überprüfen:

Ab sofort ist die gesamte Schnittstelle „HiOrg-Server ↔ DRK-DLDB ↔ Ihre-Website“ einsatzbereit.
Immer wenn Sie im HiOrg-Server einen neuen öffentlichen Kurs eintragen oder an einem bestehenden Kurs eine Änderung vornehmen, werden die aktuellen Daten dieses Kurses an die DLDB übermittelt. Dort können sie von Ihrer Website abgerufen werden, um sie in der Tabelle „kommende Kurstermine“ anzuzeigen.

Sollte die Schnittstelle nicht wie gewünscht funktionieren, können Sie die Fehlerursache näher eingrenzen, indem Sie sich auf der Weboberfläche der DLDB anmelden. Klicken Sie dort auf „Dienstleistungen“, dann rechts daneben auf den Kurstyp, und scrollen dann bis ganz nach unten.
Wenn Sie dort eine Liste mit aktuellen Kursterminen finden, funktioniert zumindest die Übertragung vom HiOrg-Server in die DLDB - Sie müssen den Fehler dann in der Konfiguration des Typo3-Plugins suchen.
Ist hingegen kein (vorher testweise im HiOrg-Server angelegter) Kurstermin vorhanden, so ist die Übertragung vom HiOrg-Server zur DLDB gestört. Überprüfen Sie dazu die oben unter „Konfiguration im HiOrg-Server“ genannten Schritte.