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:

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

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

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

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.

  

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

  

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

  

• Ü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.