docs

SchulConnex Import

Relution unterstützt die Synchronisation von Identitäten und Bildungskontextdaten über SchulConnex. Die Funktion ist unter Einstellungen > Benutzerverwaltung > SchulConnex zu finden und synchronisiert Benutzer, Gruppenrollen und Klassen/Kurse automatisch mit der zugrunde liegenden Schulverwaltungssoftware.

Einrichtung der SchulConnex-Schnittstelle

Allgemein

  1. Name des Anbieters: Eindeutiger Name für die Konfiguration.
  2. Aktiviert: Schaltet die Synchronisation ein.
  3. Host: URL des SchulConnex-Servers.

Autorisierungsparameter

  • Autorisierungs-URL: URL für die OAuth-Authentifizierung.
  • Kunden-ID: Client-ID für die Authentifizierung.
  • Client-Secret: Zugehöriges Secret.

Hinweis: Über die Schaltfläche SchulConnex-Verbindung prüfen können Sie die Verbindung testen.

Organisationszuordnung

  • Auf einer normalen Organisation wählen Sie direkt die SchulConnex-Organisationen aus, die in diese Organisation eingegliedert werden sollen (1:1-Zuordnung).
  • Auf der globalen Organisation können Sie stattdessen mehrere Relution-Organisationen gleichzeitig verwalten: Für jede Relution-Organisation wird per Zuordnungs-Assistent eine eigene Auswahl von SchulConnex-Organisationen festgelegt.

Nutzen Sie Sync-Vorschau anzeigen, um vorab zu prüfen, welche Klassen/Kurse mit wie vielen Lehrern und Schülern importiert würden.

Synchronisationseinstellungen

  • Klassen synchronisieren: Aktiviert den Import von Klassen/Kursen (Standard: aktiviert).
  • Aktion bei fehlenden Benutzern: Legt fest, was passiert, wenn ein zuvor synchronisierter Benutzer in SchulConnex nicht mehr vorhanden ist (keine Aktion, deaktivieren oder löschen).
  • Aktion bei fehlenden Klassen: Legt fest, was mit Klassen geschieht, die in SchulConnex entfernt wurden (keine Aktion oder löschen).
  • Automatische Synchronisation: Zeitplan über Cron-Syntax (Sekunden, Minuten, Stunden, Tage des Monats, Monate, Wochentage). Standardmäßig läuft die Synchronisation zweimal täglich um 5 und 20 Uhr.

Zusätzlich zur automatischen Synchronisation kann in der Detailansicht der Konfiguration jederzeit manuell über Jetzt synchronisieren ein Sync-Lauf angestoßen werden.

Rollenzuordnung

SchulConnex-Gruppenrollen werden beim Import automatisch auf Relution-Gruppen abgebildet:

  • Lehrer:innen: Rollen LEHR, KLLEIT, FOERD, VLEHR, GLEIT
  • Schüler:innen: Rollen LERN, GMIT

Synchronisation prüfen

Nach einem Sync-Lauf lassen sich die Ergebnisse in der Detailansicht der Konfiguration einsehen.

Wichtig: Eine Klasse/ein Kurs wird nur angelegt, wenn mindestens ein:e Schüler:in und ein:e Lehrer:in enthalten sind.

Hinweis: Ist bei einer Person keine E-Mail-Adresse hinterlegt, wird als Login stattdessen die SchulConnex-Personen-ID verwendet. Existiert bereits ein Benutzer mit derselben E-Mail-Adresse oder demselben Benutzernamen, wird der Import für diese Person übersprungen und als Fehler ausgewiesen.

Hinweis: Schlägt die Authentifizierung fehl (z. B. abgelaufenes Secret), wird der gesamte Sync-Lauf der Konfiguration abgebrochen, da die Zugangsdaten für alle zugeordneten Organisationen gemeinsam gelten.