Zum Inhalt

Import aus Excel/CSV

Manchmal liegen externe Daten als einfache Excel-Tabelle vor. Enbrea kann Daten direkt aus einfachen Excel-Tabellen importieren. Unterstützt werden die Formate XLSX und CSV. Excel muss dazu nicht installiert sein.

Wie funktioniert der Import?

Der Workflow besteht grob aus zwei Schritten:

  1. Enbrea Cli liest direkt aus einer Excel-Datei oder CSV-Datei und generiert ECF-Dateien.

  2. 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.

Bei einem Zugriff auf eine XLSX-Datei müssen folgende Eigenschaften ebenfalls angepasst werden:

Excel

Excel.DataProvider

Wert = XLSX

Excel.DataFile

Dateiname der XLSX-Datei

Excel.XlsMapping

Abbildung der Tabellenspalten (siehe Beispiel)

Bei einem Zugriff auf eine CSV-Datei müssen folgende Eigenschaften ebenfalls angepasst werden:

CSV

Excel.DataProvider

Wert = CSV

Excel.DataFile

Dateiname der CSV-Datei

Excel.CsvMapping

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": "1. HJ 20223/2004",

  ... 

  "Excel": {
    "DataProvider": "Xlsx",
    "DataFile": ".\\excel\\beispiel.xlsx",
    "XlsxSheetName": null,
    "XlsxFirstRowNumber": 2,
    "XlsxLastRowNumber": null,
    "XlsxMappings": [
      {
        "FromHeader": "A",
        "ToHeader": "Vorname"
      },
      {
        "FromHeader": "B",
        "ToHeader": "Nachname"
      },
      {
        "FromHeader": "C",
        "ToHeader": "Klasse"
      }
    ],
    "TargetFolder": ".\\excel\\export"
  }
}

Beispiel für CSV

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

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

  ... 

  "Excel": {
    "DataProvider": "csv",
    "DataFile": ".\\excel\\beispiel.csv",
    "CsvQuote": "\"",
    "CsvSeparator": ";",
    "CsvMappings": [
      {
        "FromHeader": "VNAME",
        "ToHeader": "Vorname"
      },
      {
        "FromHeader": "NNAME",
        "ToHeader": "Nachname"
      },
      {
        "FromHeader": "KLASSE",
        "ToHeader": "Klasse"
      }
    ],
    "TargetFolder": ".\\excel\\export"
  }
}

Importierbare Felder

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

Id

Textfeld für Id. Diese muss eindeutig sein und wird beim erneuten Import genutzt um Dopplungen zu vermeiden, die Daten aber zu aktualisieren. Es kann eine externe ID oder eine eigene, künstliche ID (z.B. gebildetet aus Vorname.Nachname.Geburtstag) verwendet werden, diese ID wird in der Oberfläche jedoch nicht dargestellt.

Vorname

Textfeld für Vorname.

Mittelname

Textfeld für Mittelname.

Nachname

Textfeld für Nachname.

Geburtstag

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

Geschlecht

Aufzählungsfeld für Geschlecht. Gültige Werte sind W, w, M, m, D oder d.

Anrede

Textfeld für Anrede.

Klasse

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

Fach1 .. Fach20

Bis zu 20 Textfelder für Fachkürzel, entsprechend der Eintragung 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 excel -c enbrea.json
    

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

Automation

Die Synchronisation zwischen Excel 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 excel -c enbrea.json -i 15
    

Mit diesem Aufruf wird der in enbrea.json konfigurierte Excel-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

Import aus der LUSD

Mit dieser Excel-Schnittstelle können Sie auch Daten aus der LUSD importieren. Sie benötigen dazu eine CSV-Exportdatei.

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 Excel um den Report aufzurufen.

    LUSD