CSV importer

ID

Bezeichnung / Benamung der Headline

CSS class

Elemente einer Gruppe/Klasse zuordnen, für die dann bestimmte Formatierungen gelten

Option 1: in Properties bestehende Bootstrap-Klassen einfügen

Option 2: über Hauptmenü in den Page Templates (für “alles verfügbar”)

Option 3: Page definitions (nur für diese Seite)

Tab index

Bei Navigation in der Page mit Tastatur (Tab), lässt sich mit dem Tab index die Reihenfolge festlegen, wo der Cursor als nächstes aktiv wird.

In der Data form kann zusätzlich für jedes Formularfeld ein Tab index vergeben werden.

Access

Access rights der Komponente:

• Import files (Berechtigung um Dateien importieren zu dürfen)

Data layer

Data layer der Tabelle (Tabelle in die importiert wird)

Save mode

Optionen:

• Append (Append data to the table)
  Importierte Datensätze werden zu bestehenden Datensätzen hinzugefügt. 
• Overwrite (Empty Table before import)
  Vor dem Import werden ALLE Datensätze der Tabelle gelöscht

Error handling

Continue on error (0 = never)

Max errors

Anzahl erlaubter, fehlerhafter Datensätze (Wenn bei Error handling die Checkbox "Continue on error" aktiviert ist).
Bei überschreiten der angegebenen Anzahl wird der Import-Vorgang abgebrochen.  

Transaction

Checkbox: Use single transaction for each file.

Das Importieren der Datensätze wird in einer Transaction ausgeführt.

Bedeutet, im Fehlerfall, bei Abbruch des Imports, werden alle zuvor geschriebenen Daten rückgängig gemacht. 

Der Importer erlaubt es auch mehrere CSV-Dateien hochzuladen. Wenn die Transaction nicht auf jede einzelne Datei angewendet werden soll, sondern alle Dateien in einer Transaction behandelt werden soll, müssen sie für diese Checkbox keinen Haken setzen.  

Upload mode

Optionen:

• Instantly
  Dateien werden bei Auswahl sofort hochgeladen und importiert

• Use buttons
  Ausgewählte Dateien werden erst hochgeladen und importiert wenn auf den Upload Button geklickt wird.

Files

Allow multiple:

Sie können mehrere Dateien auswählen und importieren

Show files:

Für den Import ausgewählte Dateien werden angezeigt vor und während dem Upload

Canceling

“Allow canceling” zeigt einen Button mit dem die ausgewählten Dateien vor dem Imports gelöscht werden können.

CSV settings

Grundlegene Einstellungen der CSV-Datei und einlesen der Datei für das CSV-Mapping.

Analyze a sample file 

Laden Sie ihre CSV-Datei hoch, damit sie analysiert werden kann und die Spalten im CSV Mapping bereitgestellt werden kann.

File

File encoding: Wählen Sie die Codierung der Datei (z.B. ANSI oder UTF-8)

String quotes (optional): Zeichen, die einen Text als zusammenhängend markieren.

Skip first lines: Anzahl an Zeilen am Anfang der Datei, die nicht eingelesen werden sollen.

Escape char: Maskierungskennzeichen das verhindert, dass das nachfolgende Zeichen als Funktionszeichen erkannt wird

Columns: Column names in first line (Checkbox):
Wenn die Datei in erster Zeile Spaltennamen enthält, diese Checkbox aktivieren

Column separators: Angabe des Trennzeichens der CSV-Datei

Behaviour:

Ignore empty lines: Checkbox aktivieren, wenn die Datei leere Zeilen enthält.

Ignore defective lines: Checkbox aktivieren wenn fehlerhafte Zeilen der Datei ignoriert werden sollen (wird dann nicht als Fehler interpretiert) 

Columns

Es werden alle Feldnamen des Data layers ausgegeben

CSV mapping

Hier können sie das Mapping von Datenbankfelder zu Spalte der CSV-Datei definieren. 
Bei Operation können Sie für jedes Datenbankfeld eine Auswahl treffen:

• Map (Map erlaubt die Zuweisung einer CSV-Spalte )
• Fix value (Sie können einen fixen Wert definieren)
• Null (Beim Import wird ein Null Wert geschrieben)
• Ignore (Datenbankfeld wird beim Import nicht beachtet)

Je nach Datentyp können auf die CSV-Spalte weitere Methoden angewandt werden:

• Take value: Inahlt wird unverändert übernommen
• Trim: Entfernt Leerzeichen vor und nach dem Wert des Feldes
• Trim left / right: Entfernt Leerzeichen vor / nach dem Wert des Feldes
• Null if empty: Wenn das Feld leer ist, wird ein Null Wert geschrieben 
• Comma-Decimals:Wenn in der Datei bei Zahlen Komma für Nachkommastellen verwendet wird 
• Point-Decimals: Wenn in der Datei bei Zahlen Punkt für Nachkommastellen verwendet wird 
• Bei Datumsfelder kann das Datumsvormat angegeben werden, wie es in der Datei formatiert ist (YYYY-MM-DD, DD-MM-YYYY,  MM-DD-YYYY)