Skip to content
German UDS Universe

The handbook content is available in German for now; the interface is translated.

Betrieb & Verwaltung (Control)

Schnittstellen zu anderen Lernsystemen

liveForOperatorAdministration

Fremde Lernsysteme starten Kurse dieser Plattform, fremde Inhalte laufen hier; dazu Schlüssel für die eigene Programmierschnittstelle und Webhooks, die Fremdsysteme benachrichtigen.

Why#

Kunden bringen ihren Bestand mit und behalten ihr bisheriges Lernsystem. Je offener die Plattform, desto leichter der Wechsel — und desto weniger muss jemand tausend Fragen abtippen.

How it works#

Click pathVerwaltungFremde Inhalte

  1. 1„Fremde Inhalte“ in der Leiste der Verwaltung öffnen (Adresse /admin/interop).
  2. 2Kurspakete hochladen (SCORM 1.2 und 2004 oder Common Cartridge samt Fragenpools im QTI-Format). Unter „Eingelieferte Pakete“ steht jedes mit Format, Zahl der Dateien, Größe und Anmerkungen.
  3. 3„Angebundene Lernsysteme“: Die Plattform als Werkzeug in einem fremden Lernsystem eintragen (LTI 1.3); je Anbindung stehen die eigenen Schlüsseladressen dabei.
  4. 4„Lernspeicher“: Lernereignisse per xAPI an den Lerndatenspeicher der Hochschule senden; die Liste zeigt die letzte Zustellung oder den letzten Fehler.
  5. 5„API-Schlüssel“ (Adresse /admin/api-schluessel): „Neuen Schlüssel ausstellen“, Zweck eintragen, Rechte ankreuzen, „Ausstellen“ — der Schlüssel wird genau einmal angezeigt.
  6. 6„Webhooks“ (Adresse /admin/webhooks): „Neues Ziel anlegen“ mit Zweck, Adresse und Ereignissen — das Geheimnis zum Prüfen der Unterschrift wird genau einmal angezeigt.

Settings and switches#

  • Switchable per tenantDefault: onModule: Schnittstellen

Was ein API-Schlüssel darf#

Jeder Schlüssel sieht ausschließlich die Daten seiner Einrichtung. Die Liste „Ausgestellte Schlüssel“ zeigt den Anfang, die Rechte, das Anlagedatum und die letzte Benutzung; „Sperren“ macht einen Schlüssel sofort unbrauchbar (danach steht „gesperrt“ mit Datum).

  • Kurse lesen
  • Personen lesen und schreiben
  • Kursbelegungen lesen und schreiben
  • Lernfortschritt lesen
  • Nachweise lesen

Welche Ereignisse ein Webhook meldet#

  • Einschreibung angelegt — eine Person wurde in einen Kurs eingeschrieben, über die Schnittstelle oder in der Plattform.
  • Kurs abgeschlossen.
  • Nachweis ausgestellt — mit dem öffentlichen Prüfcode, nie mit dem signierten Nachweis selbst.
  • Person geändert — ein Name wurde über die Schnittstelle geändert.

Ein Wächter im Code stellt sicher, dass jedes angebotene Ereignis auch wirklich irgendwo ausgelöst wird — kein Versprechen, gegen das ein Kunde baut und das nie eintrifft.

Wer darf was#

  • Fremde Inhalte (Pakete, Lernsysteme, Lernspeicher): Verwaltung und Betreiber.
  • API-Schlüssel und Webhooks: die Verwaltung eines Kunden für ihre eigene Einrichtung (Personalleitung oder Hochschulverwaltung mit Organisation) und der Betreiber. Ein Kunde muss seine Anbindung selbst einrichten und im Zwischenfall selbst abschalten können.

Tips#

  • Was nicht übertragbar ist, wird nicht verbogen, sondern gemeldet: Zuordnungsfragen, Lückentexte mit Toleranzen und Aufgaben mit Teilpunkten übernimmt der Fragenimport nicht.
  • Übernommene Fragenpools lassen sich heute üben — als Prüfung mit Aufsicht und Bewertung sind sie noch nicht verdrahtet (siehe Ausblick).
  • Die vollständige Anleitung für Entwickler steht ohne Anmeldung unter /entwickler — ein Dienstleister kann die Anbindung bauen, bevor er einen Schlüssel bekommt.
  • Wird ein Webhook-Ziel nicht erreicht, wird bis zu 26 Stunden lang mit wachsenden Abständen nachgeliefert; jede Zustellung ist unterschrieben.

Under review#

Der europäische Austausch von Leistungsnachweisen hat Endpunkte, aber noch keine produktive Gegenstelle.

Related features#

Background knowledge