.. _add-user-accounts-label: ======================================= Benutzeraufnahme mit der Schulkonsole ======================================= .. sectionauthor:: `@Tobias `_, `@cweikl `_ In einer Schule müssen meist mehrere hundert bis einige tausend Schüler als Benutzer angelegt werden. Die Schulkonsole (WebUI) erlaubt das Einlesen aller Schülerdaten aus einer Text-Datei, die z.B. aus dem Schulverwaltungsprogramm der Schule bezogen wurde. Anschließend werden - Konten aller Schüler dieser Liste, die im System noch nicht vorhanden sind, angelegt, - solche mit einer neuen Klasse versetzt und - Konten nicht mehr aufgeführter Schüler schrittweise aus dem System entfernt. In diesen Abschnitten werden beispielhaft ``ein Lehrer händisch`` angelegt und per Datei-Import einige Schüler aufgenommen. Melde Dich dafür an der Schulkonsole als ``global-admin`` an. Zeichenkodierung wählen ======================= Die Zeichencodierung für die zu importierenden CSV-Benutzerdateien kann in der WebUI festgelegt werden. Der Standard ist eine Auto-Erkennung der Codierung festgelegt. Ist die Kodierung der Eingabedatei bekannt, so kann diese auch direkt vorgegeben werden. Klicke dazu auf das Menü ``Einstellungen --> Schuleinstellungen``. .. figure:: media/add-user/add-user-01.png :align: center :alt: Menue Settings Schuleinstellungen wählen Klicke rechts auf die Reiterkarte ``Listenimport``, unterhalb von ``Zeichenkodierung`` ist im Beispiel ``UTF-8`` erkannt worden. .. figure:: media/add-user/add-user-02.png :align: center :alt: Menue Coding :width: 80% Listenimport und Zeichenkodierung Klicke auf das Drop-down Menü für die Listenkodierung und wähle die gewünschte Kodierung aus. Schließe die Eingabe mit "Speichern" ab. Für den Listenimport gibt es drei verschiedene CSV-Dateien: 1. ``students.csv``: Liste für den Schülerimport 2. ``teachers.csv``: Liste für den Lehrerimport 3. ``extrastudents.csv``: Liste für den Import von Benutzern für z.B. Fortbildungen, Kurse etc. Diese CSV-Dateien folgen nachstehendem Aufbau: .. code:: Klasse;Nachname;Vornamen;Geburtsdatum;ID Trennzeichen ist das Semikolon (;). Klasse ist nur für Schüler anzugeben. Die ID kann nachgestellt sein und stammt i.d.R. aus den Schulverwaltungsprogrammen. Auf diese Weise wird sichergestellt, dass für identische Benutzer immer nur ein Zugang angelegt wird. Lehrer importieren ================== Wähle das Menü ``Benutzerverwaltung --> Listenverwaltung``. .. figure:: media/add-user/add-user-03.png :align: center :alt: Menue list management Menüeintrag Listenverwaltung Wähle rechts oben die Reiterkarte ``Lehrer``. Einzelnen Lehrer hinzufügen --------------------------- Klicke auf den Button ``+ Lehrer hinzufügen``. Es wird eine leere Zeile hinzugefügt, die nun mit den angezeigten Daten zu füllen ist. .. figure:: media/add-user/add-user-04.png :align: center :alt: Menue: Add teacher :width: 80% Lehrer hinzufügen .. hint:: Wie dargestellt führt der ``Benutzername bo.hans zu einem Importfehler`` ! Im Benutzernamen darf kein Punkt enthalten sein. ``vornamenachname`` oder nur ``nachname`` wären hingegen zulässige Benutzernamen. .. attention:: Der angegebene Benutzername darf keine Leerzeichen, Punkte und Großbuchstaben enthalten. Anderfalls kommt es bei ``Speichern & Prüfen`` zu einer Fehlermeldung Mit ``+ Lehrer hinzufügen`` können auf diese Art und Weise weitere Lehrer einzeln aufgenommen werden. Klicke nach dem Eintragen aller der Daten unten auf den Button ``Speichern & Prüfen``. Es erscheint ein Fenster, in dem Du siehst, wie mit den angegebenen Benutzerdaten verfahren wird. .. figure:: media/add-user/add-user-05.png :align: center :alt: Menue: Add teacher - check data :width: 80% Prüfergebnis für den Import der Nutzerdaten In o.g. Fenster ist zu sehen, dass ein neuer Lehrer hinzugefügt wird. Mit dem Button ``Übernehmen`` werden die dargestellten Aktionen ausgeführt (hinzufügen, aktualisieren, löschen). Der Importdialog zeigt den Fortschritt an und meldet zurück, wenn die Aufnahme abgeschlossen wurde. .. figure:: media/add-user/add-user-06.png :align: center :alt: Menue: Add teacher - import finished :width: 80% Import fertiggestellt Bestätige dies mit dem Button ``Schliessen``. Die neune oder geänderten Benutzer findest Du nun im Menü ``Benutzerverwaltung --> Lehrer``. Hier können deren Kontoinformationen abgerufen und z.B. Erstpasswörter (zurück-)gesetzt werden. .. figure:: media/add-user/add-user-07.png :align: center :alt: Menue: Added teacher :width: 80% Benutzerverwaltung: Lehrer Schüler importieren =================== Schüler können analog zu Lehrern einzeln hinzugefügt werden. Alternativ können **alle** Schüler (alte wie neue) importiert werden. Wähle im Menü ``Benutzerverwaltung --> /Listenverwaltung --> Schüler`` (es erscheint automatisch die Schülerliste). Mit der Schaltfläche unterhalb der dargestellten Schüler ``CSV`` kannst Du verschiedene Möglichkeiten ansteuern, eine CSV-Datei zu erstellen, diese zu bearbeiten oder eine neue bereitzustellen. .. figure:: media/add-user/add-user-08.png :align: center :alt: Menue: list management - csv Eigene CSV hochladen Eine zu importierende Datei sollte folgende Daten aufweisen: .. code:: Klassenbezeichnung;Nachname;Vorname;Geburtsdatum;ID (optional aus einem Schulverwaltungsprogramm) Nachstehende Daten könnten lokal erstellt, als CSV-Datei mit der UTF-8 Codierung abgespeichert und danach mit o.g. Option ``Eigene CSV hochladen`` importiert werden. .. code:: 10A;Testuser;Heinz;1.1.2006;1234 13a;Musterfrau;Tanja;2.1.2003;1235 5b;Hausmann;Hans;3.1.2016;1236 .. attention:: Die Datei muss alle alten und neuen Schüler enthalten, sonst werden alle fehlenden Schüler zur Entfernung (Versetzung aus der Schule) vorgemerkt. Siehe auch :ref:`add-user-errorcorrection-label` unten. Die Dateinamen sind ebenso eindeutig vorgegeben. Für Schüler ist die Datei students.csv zu nennen. Mit der Option ``Eigene CSV hochladen`` kann eine so formatierte Datei nun hochgeladen werden. Die Schüler der zu importierenden Datei sind dann in der Listenverwaltung unter den Schülern zu sehen. .. figure:: media/add-user/add-user-09.png :align: center :alt: Menue: pupils to be imported via csv :width: 80% Schüler hinzufügen Mit ``Speichern`` werden eventuelle Konsistenzfehler überprüft. Die Schaltfläche ``SPEICHERN & PRÜFEN`` zeigt nun an, wieviele Schüler bei ``ÜBERNEHMEN`` ins System übernommen, versetzt (aktualisiert) oder gelöscht werden. .. figure:: media/add-user/add-user-10.png :align: center :alt: Menue: pupils to be imported - checked :width: 80% Überprüfung der zu importierenden Benutzer Mit Klick auf den Button ``Übernehmen`` werden die dargestellten Aktionen ausgeführt. Der abgeschlossene Import ist im Fenster zu sehen: .. figure:: media/add-user/add-user-11.png :align: center :alt: Menue: pupils to be imported - checked :width: 80% Benutzer importiert Ab der erfolgreichen Übernahme können die Schüler unter dem Menüpunkt ``Benutzerverwaltung --> Schüler`` gefunden und deren Konten bearbeitet werden. .. _add-user-errorcorrection-label: Fehlerkorrektur =============== Hat man fehlerhafte Daten in das System eingepflegt und hat sie noch nicht importiert, lassen sich Schüler und Lehrerlisten aus einer Sicherung zurückholen. Der Knopf für die Sicherung ist rechts unten in der Listenverwaltung. Hast Du z.B. bei der zuvor importierten CSV-Datei die IDs vergessen, kannst Du diese in der CSV-Datei ergänzen, diese erneut importieren. Es werden Dir dann die Änderungen angezeigt. In diesem Fall wird die ``uid`` auf die neu eingetragenen ID geändert. .. figure:: media/add-user/add-user-12.png :align: center :alt: Menue: import users - changes :width: 80% Benutzer aktualisiert Unter Listenverwaltung hast Du bei den jeweiligen Benutzern (Schüler, Lehrer, Extraschüler) unten rechts das Drop-down-Menü für die CSV-Dateien. .. figure:: media/add-user/add-user-08.png :align: center :alt: Menue: CSV Eigene CSV hochladen Klickst Du auf ``CSV --> Im Editor öffnen`` wird die ``students.csv`` auf dem Server geöffnet und Du kannst Änderungen vornehmen. .. figure:: media/add-user/add-user-13.png :align: center :alt: Menue: CSV :width: 80% CSV-Datei mit der WebUI im Browser editieren Eine ausführlichere Dokumentation zur Benutzerverwaltung findet sich im entsprechenden Abschnitt dieser Dokumentation.