OneRoster Schnittstelle

Einleitung

Ab Relution 26.2 ist die OneRoster Schnittstelle für Benutzer im Portal implementiert. Diese ermöglicht die Synchronisation von Benutzern und Klassen, beispielsweise aus Untis oder WebUntis, mit Relution. Die Funktion ist unter Einstellungen > Benutzerverwaltung > OneRoster zu finden.

Wichtig: Aktuell unterstützen Untis/WebUntis nur eine Organisation/Mandanten in Relution. Daher ist es sinnvoll, die OneRoster Schnittstelle direkt auf dem Zielmandanten einzubinden. Alternativ kann die Schnittstelle auch auf der globalen Organisation eingebunden werden, wobei Schulen über IDs gemappt werden können. Dies erfordert jedoch Unterstützung durch die Benutzerverwaltungsapplikation.

Einrichtung der OneRoster Schnittstelle

Allgemeine Einstellungen

  1. Name des Anbieters: Geben Sie einen eindeutigen Namen für den Anbieter ein.
  2. Aktivieren: Schalten Sie die Schnittstelle ein, indem Sie den Schalter aktivieren.
  3. Host: Geben Sie die URL des OneRoster-Servers ein.

Autorisierungsparameter

  • Token-URL: URL für die Token-Authentifizierung.
  • Client-ID: Die Client-ID für die Authentifizierung.
  • Passwort: Das zugehörige Passwort.

Hinweis: Über die Schaltfläche Verbindung überprüfen können Sie die Verbindung zum OneRoster-Server testen.

Synchronisationseinstellungen

Organisationen auswählen

  • Wählen Sie die OneRoster-Organisationen aus, die synchronisiert werden sollen.
  • Nutzen Sie die Synchronisierungsvorschau, um die zu synchronisierenden Daten vorab zu prüfen.

Klassen synchronisieren

  • Aktivieren Sie die Option Klassen synchronisieren, um Klassen aus OneRoster zu importieren.
  • Aktion bei fehlenden Benutzern: Legen Sie fest, wie mit Benutzern umgegangen werden soll, die in Relution fehlen.
  • Aktion bei fehlenden Klassen: Definieren Sie, wie mit Klassen verfahren werden soll, die in Relution fehlen.

Automatische Synchronisation

  • Richten Sie eine automatische Synchronisation über Cron-Syntax ein:
    • Minuten: Geben Sie die Minute an, zu der die Synchronisation ausgeführt werden soll.
    • Stunden: Definieren Sie die Stunde der Synchronisation.
    • Tage des Monats, Monate, Wochentage: Passen Sie die Synchronisationsintervalle an.

Synchronisation prüfen

Nachdem die Verbindung erfolgreich gespeichert wurde, kann diese in der Übersicht geöffnet werden. Hier können Sie den Sync-Status prüfen.

Sollten Fehler beim Synchronisationsprozess auftreten, können Sie hier die Ursache ermitteln.

Hinweis: Die meisten Synchronisationsfehler entstehen durch fehlende Benutzer in einer Klasse. Relution benötigt mindestens einen Schüler und einen Lehrer, um eine Klasse zu erstellen.
Zudem können doppelt vorhandene Benutzer ohne eindeutige E-Mail-Adresse beim Synchronisationsprozess verworfen werden.