Moodle

Grundlagen

Um die Moodle-Schnittstelle zu LANcloud einzurichten, muss der externe Webservice für LANcloud freigeschaltet werden. Dazu gibt es eine detaillierte Anleitung. Erst wenn in den Grundeinstellungen der aktive Server ohne Warnungen angezeigt wird, können die Funktionen der Schnittstelle benutzt werden.

Kurszeitraum festlegen

Über die zwei Felder Verschiebung Kursbeginn (in Tage) und Verschiebung Kursende (in Tage) kann festgelegt werden, wie lange der Kurs für die Teilnehmenden auf Moodle verfügbar ist. Diese Verschiebung wird auf den Zeitraum der Veranstaltung angewandt. Wenn zum Beispiel eine Verschiebung von -14 Tage für den Kursbeginn angegeben ist und der Veranstaltungsbeginn der 26.03.2026 ist, dann ist der Kursbeginn auf Moodle der 12.03.2026 (zwei Wochen vorher). Falls die Eigenschaften leer gelassen werden, dann kann auf die Moodle-Kurse immer zugegriffen werden.

Fehlercodes beim Aufruf von Moodle-Funktionen

Beim Aufrufen von Moodle-Funktionen können Warnungen auftreten:

• shortnametaken: Es gibt bereits einen Moodle-Kurs mit dem gleichen Namen. Die Aktualisierung oder das Anlegen des Moodle-Kurses hat nicht funktioniert.

Einrichtung des Moodle-Servers

Unsere Moodle-Schnittstelle unterstützt die Version 4.5.* des Moodle-Servers. Für alle anderen Versionen können wir keinen fehlerfreie Funktion garantieren. Bei Bedarf einer anderen Version kann gerne unser Support kontaktiert werden. Für die Integration eines Moodle-Servers müssen folgende Schritte fehlerfrei durchgeführt werden. Eine erfolgreiche Integration wird auf der Seite der Grundeinstellungen mit einem grünen Infosymbol und den Namen des Servers signalisiert. Bei fehlenden vergebenen Funktionsrechten für den externen Webservice, werden diese als gelbe Warnung dargestellt. Bei Fragen zur Integration kann sich bei unserem Support gemeldet werden.

Wenn manche Schritte nicht gefunden werden, dann kann unter Website-Administration > Server > Webservices > Übersicht > Externem System die Kontrolle erlauben eine moodleinterne Anleitung gefunden werden. Dabei ist zu beachten, dass diese Anleitung sich von unserer Anleitung unterscheidet und die Schritte unbedingt nach unserer Anleitung durchgeführt werden müssen. Die moodleinterne Anleitung kann nur zur Hilfe bei der Suche der Menüpunkte genutzt werden.

1. Einrichtung des Plugins "auth_userkey" (User key authentication): Unter Website-Administration > Plugins > Plugin installieren das Plugin aus der Datenbank installieren, herunterladen und hochladen.

   Dieses Plugin wird zur Authentifizierungsintegration zwischen LANcloud und Moodle benutzt. So können eingeloggte User in LANcloud direkt auf den Moodle-Server zugreifen.

   Einstellungen im Standardverhalten belassen. Das Feld Mapping Field muss E-Mail betragen und bei Feld sperren (E-Mail-Adresse) muss das Feld gesperrt werden.

   

   

2. Plugin User key authentication aktivieren: Unter Website-Administration > Plugins > Plugin-Übersicht > Zusätzliche Plugins > Übersicht das Plugin aktivieren.

   

3. Webservices aktivieren: Unter Website-Administration > Allgemein > Zusatzoptionen die Webservices aktivieren und die Änderungen speichern.

   

4. REST-Protokoll aktivieren: Unter Website-Administration > Server > Webservices > Protokolle verwalten bei Protokoll REST auf das Auge klicken und die Änderungen speichern.

   

5. Nutzer für Webservice erstellen: Unter Website-Administration > Nutzer/innen Nutzerkonten > Nutzer/in anlegen einen neuen Nutzer anlegen. Für Authentifizierung Webservices wählen und für die anderen Pflichtfelder gültige Daten wählen und diese sicher speichern.

   

6. Nutzer zum Administrator machen: Unter Website-Administration > Nutzer/innen > Rechte > Administrator/innen den angelegten Nutzer aus Schritt 5 rechts in der Liste auswählen und durch Klick auf Hinzufügen zum Administrator machen.

7. Externen Service erstellen: Unter Website-Administration > Server > Webservices > Externe Services einen externen Service für LANcloud erstellen. Den externen Service direkt aktivieren, aber für alle Personen zulassen (Haken bei Nur berechtigte Personen nicht setzen).

   

8. Funktionen zum externen Service hinzufügen: Auf Funktionen des neuen externen Service klicken und dort alle folgenden Funktionen ergänzen und speichern:

   • core_webservice_get_site_info
   • core_course_create_categories
   • core_course_get_categories
   • core_course_create_courses
   • core_course_delete_courses
   • core_course_get_courses_by_field
   • core_course_search_courses
   • core_course_update_courses
   • enrol_manual_enrol_users
   • core_enrol_get_users_courses
   • core_user_create_users
   • core_user_delete_users
   • core_user_get_users_by_field
   • auth_userkey_request_login_url
   • core_user_update_users

   

9. Token für API-Benutzer mit Service erstellen: Unter Website-Administration > Server > Webservices > Tokens verwalten ein Token für LANcloud erstellen und sicher abspeichern. Den vorher angelegten API-Nutzer auswählen, den vorher angelegten externen Service auswählen und den Haken für Gültig bis abwählen. Danach die Änderungen speichern und das erzeugte Token sicher speichern.

   

10. URL des Servers und Token in LANcloud eintragen: Zu LANcloud wechseln und auf die Ìntegration von Moodle in den Grundeinstellungen wechseln. Unter Server-URL die Basis-URL des Moodle-Servers eintragen. Unter Token das erzeugte Token von Schritt 9 eintragen und abspeichern:

    • Wenn die Einrichtung erfolgreich ist, wird eine grüne Info angezeigt mit dem Seitennamen des Servers
    • Wenn dem Webservice Funktionen fehlen, dann werden diese als gelbe Warnung angezeigt
    • Wenn die Verbindung zum Webservice fehlgeschlagen ist, dann wird diese weiterhin als inaktiv angezeigt und es erscheint eine Fehlermeldung im unteren Bereich. In diesem Fall sollte der Fehlercode und die Einrichtung überprüft werden.

Fehler bei Verbindung zum Moodle-Server

• Es konnte keine Verbindung zum Moodle-Server hergestellt werden.: Die Server-URL ist inkorrekt, der Webservice des Moodle-Servers ist deaktiviert (siehe Schritt 1) oder das REST-Protkoll ist nicht aktiviert.
• Ungültiges Token - Token wurde nicht gefunden: Das generierte Token aus Schritt 9 ist für den Service ungültig und muss geprüft werden
• Access Control Exception (You are not allowed to use the rest protocol (missing capability: webservice/rest:use)): Der Nutzer des zugehörigen Tokens hat keine Rechte das REST-Prokotokoll zu benutzen, ist kein Administrator oder das REST-Prokotoll ist nicht aktiviert. Siehe Schritt 4, 5 und 6.
• Access Control Exception (Access to the function core_webservice_get_site_info() is not allowed.): Es kann diverse Probleme mit der Einrichtung geben. Das Token muss gültig für den korrekten Server und Nutzer ausgeschrieben sein. Der Webservice muss die korrekten Funktionen besitzen. Der Nutzer muss Administrator sein und es darf keine zeitbasierten Limitierungen geben.
• Access Control Exception (Invalid token - token expired - check validuntil time for the token): Das Token ist abgelaufen.
• Warnungen mit fehlenden Funktionen: siehe Schritt 8.

Funktionen der Schnittstelle

Die Schnittstelle hat bisher folgende Funktionen, die aktiv sind, sobald eine gültige Moodle-Integration hinterlegt ist:

Kurse

• In den Grundeinstellungen kann festgelegt werden, wie lange der Kurs auf Moodle verfügbar sein soll relativ zum Beginn und Ende der Veranstaltung (siehe Kurszeitraum festlegen).
• Bei Anlage einer Veranstaltung wird automatisch ein Moodle-Kurs angelegt. Dieser Kurs berücksichtigt den Matchcode und den Kursbeginn und Kursende festgelegt aus dem Veranstaltungszeitraum und der Verschiebung aus den Grundeinstellungen.
• Beim Verschieben der Veranstaltung wird der Kursbeginn und das Kursende relativ zur Verschiebung aktualisiert.
• Bei Änderungen wird der Matchcode der Veranstaltung abgeglichen.
• Beim Löschen einer Veranstaltung wird der zugehörige Moodle-Kurs versteckt.
• Zu bestehenden Veranstaltungen kann der Moodle-Kurs auf dem Moodle-Reiter eingesehen und angepasst werden. Weiterhin kann hier ein neuer Moodle-Kurs zu bestehenden Seminaren ohne Moodle-Kurs angelegt werden.

Benutzerkonten

• Bei Anlage von neuen Adressen mit einem verknüpften Teilnahmekonto wird automatisch ein Moodle-Konto zur E-Mail angelegt.
• Bei Änderung des Vor- oder Nachnamens oder der E-Mail des Teilnahmekontos werden diese Informationen auch auf Moodle angepasst.
• Bei Löschung der Adresse wird das zugehörige Moodle-Konto gesperrt.
• Auf der Detailansicht einer Adresse kann eingesehen werden, ob die Adresse ein verknüpftes Moodle-Konto besitzt.
• Falls die Adresse ein Teilnahmekonto und noch kein Moodle-Konto besitzt, kann über den Schalter Moodle verknüpfen ein bestehendes Konto (falls dieses schon mit gleicher E-Mail existiert) oder ein neues Konto verknüpft werden.
• Bei Anlage einer Teilnahme (mit Adresse mit Moodle-Konto) zu einer Veranstaltung mit Moodle-Kurs, wird das Moodle-Konto automatisch im Moodle-Kurs eingeschrieben.
• Bei Löschung, Stornierung, Kündigung einer Teilnahme wird die Einschreibung des Moodle-Kontos automatisch gesperrt (falls das Konto keine weitere Teilnahme an der Veranstaltung besitzt).
• Im Teilnahmeportal kann ein Teilnahmekonto mit Moodle-Verknüpfung über den allgemeinen Schalter im Kontomenü zu seinem Moodle-Dashboard springen.
• Im Teilnahmeportal kann ein Teilnahmekonto auf Veranstaltungen mit Moodle-Kurs direkt zum Moodle-Kurs des Moodle-Servers springen.

---

Stichworte: Moodle