Zielgruppe: WebUntis-Administrator*innen
Als Administrator*in nehmen Sie in den Reitern „Konfiguration“ und „Verbindung“ die Grundkonfiguration des Untis Connectors für itslearning vor. Legen Sie zuerst fest, wie Benutzer*innen zugeordnet werden und in welcher itslearning-Hierarchie die Gruppen angelegt werden. Stellen Sie anschließend die API-Verbindungen her.
Benutzerverknüpfung und Root-Hierarchie konfigurieren
- Öffnen Sie in WebUntis die Administration des Untis Connectors für itslearning und wechseln Sie zum Reiter „Konfiguration“.
- Wählen Sie unter „Benutzerverknüpfung durch“, ob vorhandene Benutzer*innen über den Benutzernamen oder die E-Mail-Adresse zugeordnet werden sollen.
- Tragen Sie unter „itslearning“ die URL Ihrer itslearning-Instanz ein.
- Tragen Sie unter „Root-Hierarchie“ den Synchronisierungsschlüssel der gewünschten obersten Hierarchie ein und speichern Sie die Konfiguration.
| Wichtig: Das gewählte Merkmal muss in WebUntis und itslearning übereinstimmen. Verwenden Sie möglichst eindeutige, gepflegte Benutzernamen oder E-Mail-Adressen. |
Unterhalb der gewählten Root-Hierarchie erstellt der Connector den Ordner „WebUntis Gruppen“. Die durch den Connector erzeugten Gruppen werden in diesem Ordner abgelegt.
Abbildung 1: Benutzerverknüpfung, itslearning-URL und Root-Hierarchie konfigurieren
Verbindung zu itslearning herstellen
- Wechseln Sie zum Reiter „Verbindung“. Klappen Sie bei Bedarf „Mehr Informationen“ auf, hier finden Sie die Einrichtungsanleitung und die erforderlichen itslearning-Einstellungen.
- Tragen Sie für die Organization API die URL, den Benutzernamen und den Key ein. Sie erhalten diese Zugangsdaten von Ihrem itslearning-Support.
- Aktivieren Sie in Ihrem itslearning die IMS Enterprise API. Öffnen Sie dazu die Administration und navigieren Sie zu „Protokolle und Services“ > „Unternehmens-Webdienste verwalten“.
- Erstellen Sie eine Integration für den Connector und übernehmen Sie anschließend URL, Benutzername und Passwort in die Felder der IMS Enterprise API.
| Einstellung | Wert laut Einrichtungsansicht |
| Titel | WebUntis Connector (frei wählbar) |
| Hierarchie | Hierarchie Ihrer Schule auswählen |
| Zu verwendendes System | IMS Enterprise Services |
| ReadAllPersons aktivieren | Aktiv |
| Benutzername | Importieren |
| Passwort | Automatisch erstellt |
| Aktiv |
- Betätigen sie "Jetzt Verbinden" um die Verbindung zwischen dem Systemen aufzubauen
| Sicherheit: Geben Sie API-Keys, Passwörter und andere Zugangsdaten nicht an unautorisierte Dritte weiter. |
Abbildung 2: Zugangsdaten für Organization API und IMS Enterprise API eintragen
Abbildung 3: Ausgeklappte Schritt-für-Schritt-Anleitung für die Verbindung