flexi-file-upload¶
Das Datei-Upload-Feld erlaubt es dem Benutzer, Dateien zu einem Abschnitt hochzuladen, herunterzuladen und wieder zu entfernen. Die hochgeladenen Dateien werden zentral zum Dokument gespeichert und sind in jedem Browser, in dem das Dokument geöffnet wird, verfügbar.
Typischer Einsatz: Anhängen von Fotos, Messprotokollen, Lieferpapieren oder anderen Begleitdokumenten zu einem Formular.
Einstellungen¶
| Einstellung | Beschreibung |
|---|---|
| Bezeichnung | Der angezeigte Text über der Dateiliste |
| Name | Eindeutiger Bezeichner des Feldes (wird automatisch aus der Bezeichnung abgeleitet) |
| Erlaubte Dateitypen | Auswahl der zulässigen Dateiendungen (siehe unten). Ohne Auswahl sind alle Dateitypen erlaubt |
| Maximale Dateigröße | Obergrenze pro Datei in Megabyte. Bei 0 gilt der Standardwert von 10 MB |
| Pflichtfeld | Wenn aktiv, muss eine Mindestanzahl an Dateien hochgeladen werden, damit das Feld als gültig gilt |
| Mindestanzahl | (Nur bei Pflichtfeld) Geringste zulässige Anzahl hochgeladener Dateien |
| Maximalanzahl | (Nur bei Pflichtfeld) Höchste zulässige Anzahl hochgeladener Dateien |
| Fehlertext | (Nur bei Pflichtfeld) Meldung, die angezeigt wird, wenn die Anzahl der Dateien außerhalb des erlaubten Bereichs liegt |
Dateiliste¶
Im Formular zeigt das Feld eine Tabelle mit allen bereits hochgeladenen Dateien:
- Dateiname der hochgeladenen Datei
- Herunterladen – speichert die Datei lokal ab
- Löschen – entfernt die Datei (nur sichtbar, wenn das Dokument bearbeitbar ist)
- Vorschau – zeigt bei HTML-Dateien eine Vorschau in einem Dialog
Über die Schaltfläche Datei hochladen wird der Datei-Auswahl-Dialog des Betriebssystems geöffnet. Die ausgewählte Datei wird unmittelbar nach der Auswahl hochgeladen.
Vor dem ersten Upload muss das Dokument einmal gespeichert sein. Solange das Dokument noch nicht gespeichert wurde, erscheint ein Hinweis und die Schaltfläche Datei hochladen ist deaktiviert.
Erlaubte Dateitypen¶
Über die Auswahl Erlaubte Dateitypen kann der Datei-Dialog auf bestimmte Endungen eingeschränkt werden. Ohne Auswahl sind alle Dateitypen zulässig.
| Auswahl | Erlaubte Endung |
|---|---|
ZIP |
.zip |
HTML |
.html |
DAT |
.dat |
TIB |
.dat |
Mehrere Dateitypen können gleichzeitig ausgewählt werden.
HTML-Dateien erhalten zusätzlich eine Vorschau-Schaltfläche, mit der sich der Inhalt der Datei direkt in einem Dialog anzeigen lässt, ohne sie herunterzuladen.
Maximale Dateigröße¶
Über Maximale Dateigröße wird die Obergrenze pro Datei in Megabyte festgelegt. Wird beim Hochladen eine Datei ausgewählt, die größer ist als der eingestellte Wert, erscheint ein Hinweis und die Datei wird nicht übernommen.
Bei 0 gilt die Standardgrenze von 10 MB.
Pflichtfeld¶
Ist das Feld als Pflichtfeld markiert, wird die Anzahl der hochgeladenen Dateien geprüft. Liegt sie außerhalb des Bereichs zwischen Mindestanzahl und Maximalanzahl, gilt das Feld als ungültig und der hinterlegte Fehlertext wird angezeigt.
Ist das Feld kein Pflichtfeld, ist auch das Hochladen von Dateien optional.
Doppelte Dateien¶
Innerhalb desselben Feldes darf jeder Dateiname nur einmal vorkommen. Wird eine Datei mit einem Namen ausgewählt, der bereits in der Liste enthalten ist, erscheint ein Hinweis und die Datei wird nicht hochgeladen. Soll eine vorhandene Datei ersetzt werden, muss sie zuerst gelöscht und anschließend erneut hochgeladen werden.
Offline-Verhalten¶
Das Datei-Upload-Feld benötigt eine Internetverbindung. Ohne Verbindung wird statt der Dateiliste der Hinweis angezeigt, dass das Feld offline nicht verfügbar ist. Sobald die Verbindung wieder besteht, wird die Dateiliste automatisch geladen.