Zum Inhalt

Import aus LUSD

Die LUSD ist eine offizielle Schulverwaltungssoftware des Landes Hessen. Daten können mit Hilfe des LUSD-Exports von LUSD importiert werden.

Wie funktioniert der Import?

Der Workflow besteht grob aus zwei Schritten:

  1. Zunächst muss manuell aus LUSD heraus eine Excel-Exportdatei generiert werden.

  2. Enbrea Cli liest die LUSD-Exportdatei ein und generiert ECF-Dateien.

  3. Enbrea Cli importiert die generierten ECF-Dateien nach Enbrea. Sollten sich im Vergleich mit dem letzten Import keine Änderungen ergeben haben, wird kein Import durchgeführt.

Initialisierung

  1. Falls noch nicht geschehen, bitte einen Zeitraum in Enbrea anlegen und auf Ihrem lokalen Computer Enbrea Cli installieren.

  2. Im Windows-Explorer ein neues Verzeichnis c:\enbrea anlegen (das Verzeichnis kann natürlich auch anders heißen).

  3. Im Suchfeld der Windows-Taskleiste Eingabeaufforderung eintippen und die Windows-Eingabeaufforderung öffnen.

  4. Mit Befehl cd in das soeben angelegte Verzeichnis wechseln:

    cd c:\enbrea

  5. Nun folgenden Befehl eintippen:

    enbrea init -c enbrea.json

    Es wird jetzt eine JSON-formatierte Konfigurationsdatei enbrea.json angelegt, die als Vorlage für die weitere Konfiguration dient.

Konfiguration

Die gesamte Konfiguration des Imports befindet sich in der soeben angelegten Textdatei enbrea.json. Diese Datei in einem Texteditor öffnen und die gewünschten Eigenschaften überschreiben.

Die folgenden Eigenschaften müssen angepasst werden. Sie konfigurieren den individuellen Zugang zu Enbrea:

Allgemeine Konfiguration

Url

URL zu Ihrer Enbrea-Instanz

AccessToken

Enbrea-Zugriffstoken

SchoolTerm

Kürzel des Enbrea-Zeitraums, in den importiert werden soll.

Die folgenden Eigenschaften müssen ebenfalls angepasst werden. Sie konfigurieren den Zugang zur LUSD-Datei:

LUSD

Lusd.DataFile

Dateiname der XLSX-Datei

Lusd.XlsMapping

Abbildung der Tabellenspalten (siehe Beispiel)

Alle anderen Eigenschaften sind schon vorkonfiguriert, können aber natürlich jederzeit überschrieben werden.

Bitte beachten

Der Backslash (= umgedrehter Schrägstrich) in Dateipfaden muss in einer JSON-Datei stets gedoppelt werden, also \\ statt \.

Beispiel für XLSX

Das Ergebnis für den Import aus einer XLSX-Datei könnte wie folgt aussehen:

{
  "Url": "https://enbrea.cloud/meine-schule",
  "AccessToken": "9067eff1-6817-4e59-855c-9ace4e51f139",
  "SchoolTerm": "2025/2026",

  ... 

  "Lusd": {
    "DataFile": ".\\lusd\\beispiel.xlsx",
    "XlsxSheetName": null,
    "XlsxFirstRowNumber": 2,
    "XlsxLastRowNumber": null,
    "XlsxMappings": [
      {
        "FromHeader": "A",
        "ToHeader": "Vorname"
      },
      {
        "FromHeader": "B",
        "ToHeader": "Nachname"
      },
      {
        "FromHeader": "C",
        "ToHeader": "Geschlecht"
      },
      {
        "FromHeader": "D",
        "ToHeader": "Geburtsdatum"
      },
      {
        "FromHeader": "E",
        "ToHeader": "Klasse"
      },
      {
        "FromHeader": "F",
        "ToHeader": "Fach"
      },
      {
        "FromHeader": "G",
        "ToHeader": "Lehrer"
      }
    ],
    "TargetFolder": ".\\lusd\\export"
  }
}

Importierbare Felder

Die folgenden Felder versteht Enbrea und ordnet sie beim Import richtig zu:

Vorname

Textfeld für Vorname.

Nachname

Textfeld für Nachname.

Geschlecht

Angabe zum Geschlecht. Gültige Formate sind w, W, m, M, d, D oder leer.

Geburtstag

Datumsfeld für Geburtstag. Gültige Formate sind yyyy-MM-dd oder dd.MM.yyyy.

Klasse

Textfeld für Klassenkürzel, entsprechend der Angabe im Stundenplan- oder Verwaltungsprogramm.

Fach

Textfeld für Fachkürzel, entsprechend der Angabe im Stundenplan- oder Verwaltungsprogramm.

Lehrer

Textfeld für Lehrerkürzel, entsprechend der Angabe im Stundenplan- oder Verwaltungsprogramm.

Testen

  1. Im Suchfeld der Windows-Taskleiste Eingabeaufforderung eintippen und die Windows-Eingabeaufforderung öffnen.

  2. Mit folgendem Befehl in unser Enbrea-Verzeichnis wechseln:

    cd c:\enbrea

  3. Folgenden Befehl eintippen und bestätigen:

    enbrea import -p lusd -c enbrea.json

Die Daten aus LUSD werden ins ECF-Format übersetzt und anschließend nach Enbrea übertragen.

Automation

Die Synchronisation zwischen LUSD und Enbrea kann natürlich automatisiert werden. Am einfachsten geht dies mit dem Enbrea Cli-Befehl create-import-task.

Ein Beispiel:

  1. Im Suchfeld der Windows-Taskleiste Eingabeaufforderung eintippen und die Windows-Eingabeaufforderung als Administrator öffnen.

  2. Mit folgendem Befehl in unser Enbrea-Verzeichnis wechseln:

    cd c:\enbrea

  3. Folgenden Befehl eintippen und bestätigen:

    enbrea create-import-task -p lusd -c enbrea.json -i 15

Mit diesem Aufruf wird der in enbrea.json konfigurierte LUSD-Import nach Enbrea alle 15 Minuten ausgeführt.

Eine ausführliche Beschreibung der Möglichkeiten rund um das Thema Automation findet sich im Kapitel Automation.

Tipps und Tricks

Export aus der LUSD

Voraussetzung für den Abgleich mit LUSD ist der Export einer LUSD-Dateien aus LUSD heraus.

Anleitung:

  • Rufen Sie den Abfrageassistent auf.

    LUSD

  • Wählen Sie Datenquelle > Kurse aus. Klicken Sie auf Hinzufügen und vergeben Sie einen Namen für Ihre Abfrage.

    LUSD

  • Fügen Sie Felder für Ihre Abfrage hinzu.

    LUSD

  • Über die Lupe oben rechts im Fenster können Sie alle Schüler der Abfrage hinzufügen (Auswählen > gewünschte Schulformen > Alle Übernehmen). Klicken Sie unten rechts im Fenster auf LUSD um den Report aufzurufen.

    LUSD