Betrieb & Verwaltung (Control)

Schnittstellen zu anderen Lernsystemen

公開中対象運営者事務

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

目的#

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.

使い方#

クリック手順VerwaltungFremde Inhalte

1„Fremde Inhalte“ in der Leiste der Verwaltung öffnen (Adresse /admin/interop).
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„Angebundene Lernsysteme“: Die Plattform als Werkzeug in einem fremden Lernsystem eintragen (LTI 1.3); je Anbindung stehen die eigenen Schlüsseladressen dabei.
4„Lernspeicher“: Lernereignisse per xAPI an den Lerndatenspeicher der Hochschule senden; die Liste zeigt die letzte Zustellung oder den letzten Fehler.
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„Webhooks“ (Adresse /admin/webhooks): „Neues Ziel anlegen“ mit Zweck, Adresse und Ereignissen — das Geheimnis zum Prüfen der Unterschrift wird genau einmal angezeigt.

設定とスイッチ#

テナントごとに切替可能既定：オンモジュール：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.

ヒント#

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.

確認中#

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