Optionen mit CSV-Datei importieren
Statt Optionen für Feldern vom Typ Listbox, Radiobutton und Checkbox Gruppe manuell anzulegen, können Sie diese auch mithilfe einer CSV-Datei importieren. Wenn Sie eine größere Anzahl an Optionen benötigen oder viele Felder dieser Typen in Ihrem Formular verwenden, kann dies eine große Arbeitserleichterung sein.
Das CSV-Datei-Format
- Die CSV-Datei darf keine Header-Zeile enthalten.
- Jede Option ist eine eigene Zeile.
- Jede Option hat mindestens 2 und höchstens 3 Elemente.
- Die Elemente werden durch einen Trenner getrennt.
- Dieser Trenner muss innerhalb der gesamten Datei derselbe sein.
- Sie können entweder ein Komma oder ein Semicolon als Trenner verwenden.
- Hinter dem letzten Element steht kein Trenner.
- Die Elemente müssen folgende Reihenfolge haben: Optionswert, Optionslabel, Default.
- Das dritte Element (Default) hat, wenn es angefügt wird, immer den Wert 1.
- Der Trenner kann nicht innerhalb eines Elements verwendet werden.
- Optionswerte sollten einfach und kurz gehalten werden.
- Die Elemente dürfen keine Anführungszeichen (einfach oder doppelte) enthalten.
Beispiele für gültige CSV-Dateien
Komma-separiert
wert1,label1
wert2,label2,1
wert3,label3
wert4,label4
wert mit leerzeichen, label mit leerzeichen
Semikolon-separiert
wert1;label3
wert2;label2
wert3;label3;1
wert mit leerzeichen; label mit leerzeichen
Der Importvorgang
Optionen importieren
- Wählen Sie zuerst das verwendete Trennzeichen aus.
- Wählen Sie die Import-Datei auf Ihrem Rechner aus (Optionen importieren).
Der Import startet automatisch, sobald Sie eine Importdatei ausgewählt haben.
Bestehende Optionen werden überschrieben
Sollten zum Feld bereits Optionen angelegt worden sein, so werden diese durch den Import überschrieben. Visforms löscht zuerst alle eventuell bereits vorhandenen Optionen.
Jede neu zu importierende Option wird auf Ihre Validität geprüft. Enthält eine Option in der CSV-Datei ungültige Werte, so wird sie beim Import übersprungen.
Es werden immer alle Optionen importiert, d.h. Sie müssen für jedes Feld eine eigene Importdatei erstellen.
Hinweis: Nach erfolgreichem Import müssen Sie das Feld speichern, damit die Optionen auch in der Datenbank gespeichert werden.
Sie können alle importierten Optionen wie gewohnt manuell nachbearbeiten. Nach erfolgreichem Import können weitere Optionen manuell angelegt werden.
Bekannte Problem
Begrenzungen der HTML5 File-API
Der Import erfolgt mit JavaScript und mithilfe der HTML5 File-API. Dies ist praktisch, weil Sie nur die Datei auswählen müssen. Alles andere erfolgt automatisch direkt durch den Browser. Dieses Vorgehen hat aber einige Begrenzungen, die Sie bitte beachten müssen.
Einen modernen Browser verwenden
Sie benötigen einen modernen Browser, der die HTML5 File-API implementiert. Sollte Ihr Browser die File-API nicht unterstützen erhalten Sie eine entsprechende Fehlermeldung. Bitte wechseln Sie zumindest für den Import auf einen moderneren Browser. Hier können Sie nachschlagen, welche Browser die File-API unterstützen: CanIUse.
Importierte Daten lassen sich nicht speichern
Wenn Sie für eine Listbox sehr viele Optionen (etwa größer als 200) anlegen, kann es passieren, dass die Optionen nicht gespeichert werden können. Wenn Sie auf den “Speichern” Button klicken, wir das Feld nur scheinbar korrekt gespeichert. Wenn Sie aber das Feld erneut öffnen sehen Sie, dass alle Optionen verloren gegangen sind. Das Problem tritt auf, wenn der “php_value_max_input_vars” in der Serverkonfiguration zu niedrig eingestellt ist. Wenn Ihr Provider es erlaubt, Servereinstellungen in der .htaccess Datei zu setzen, können Sie versuchen das Problem zu beheben. Fügen Sie in der .htaccess Datei im Root Ihres Webservers diese Zeile ein:
php_value max_input_vars 4000
Oder klären Sie direkt mit Ihrem Provider, wie diese Einstellung hochgesetzt werden kann.