Skip to content

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.