HINWEIS: Das Plugin Multipler Upload ist eine Eigenentwicklung der N12h GmbH. Bitte wenden Sie sich bei Fragen oder Unterstützung an den Herausgeber.	

Angaben zum Herausgeber:		
N12h GmbH		
Website: https://n12h.digital
E-Mail: kontakt@n12h.digital
Support: support@n12h.digital	

Inhaltsverzeichnis

• Voraussetzungen
• Installation
• Plugin-Einstellungen
  • Element einfügen
  • Eigenschaften des Elements
  • Wiederholbare Container
• Prüfung und Sicherheit
• Daten im Vorgang
• Hinweise und Grenzen

Das Plugin ergänzt den formcycle-Designer um das Formular-Element Multipler Upload. Damit können Antragstellende in einem einzigen Feld mehrere Dateien hochladen. Die Dateien können auf einmal ausgewählt oder per Drag & Drop in das Formular gezogen werden. Weitere Dateien lassen sich jederzeit hinzufügen, einzelne Dateien wieder entfernen.

Dateityp, Größe und Anzahl werden bereits im Browser geprüft. Beim Absenden prüft der Server alle Dateien noch einmal verbindlich. Alle Dateien werden anschließend als Anhänge im Vorgang gespeichert.

Das Element bietet folgende Funktionen:

• Mehrere Dateien in einem Feld: Mehrfachauswahl im Dateidialog, Drag-&-Drop-Fläche, „Weitere hinzufügen“ ohne Verlust der bisherigen Auswahl, einzelne Dateien entfernen und „Alle entfernen“.
• Sofortige Rückmeldung im Browser: Der Browser prüft Dateityp, Größe pro Datei, Gesamtgröße, Anzahl, leere Dateien und doppelt gewählte Dateien. Außerdem zeigt er die belegte Gesamtgröße an.
• Verbindliche Prüfung auf dem Server: Jede einzelne Datei wird unabhängig vom Browser geprüft (siehe Prüfung und Sicherheit).
• Pflichtfeld: Das Element kann als Pflichtfeld festgelegt werden und wird dann auch auf dem Server geprüft.
• Wiederholbare Container: Jede Wiederholung hat ihre eigene Dateiauswahl.
• Wie das formcycle-Upload-Element: Auch hier gibt es einen Dateinamen-Alias und die Nachverarbeitung der Dateien, zum Beispiel das Entfernen von EXIF-Daten.
• Mehrsprachig: Die Texte erscheinen auf Deutsch oder Englisch, passend zur Formularsprache. Die Beschriftungen sind anpassbar.
• Barrierearm: Das Element ist per Tastatur bedienbar und gibt Statusmeldungen für Screenreader aus.
• Keine externen Ressourcen: CSS und JavaScript werden direkt mit dem Element ausgeliefert. Es werden keine Daten an Dritte übertragen und es wird kein Konto bei einem Drittanbieter benötigt.

Voraussetzungen

• formcycle ab Version 8.5.0 (getestet mit Version 8.5.5)
• Aktuelle Version von Chrome, Edge, Firefox oder Safari für die Nutzerinnen und Nutzer des Formulars

Installation

Die Installation des Plugins kann unter Mandant > Plugins oder unter System > Systemplugins erfolgen.

Plugin-Einstellungen

Die Einstellungen gelten für alle Formulare des Systems beziehungsweise des Mandanten. Die Einstellungen sind in der Plugin-Verwaltung beim Plugin Multipler Upload zu finden. Nach einer Änderung ist das Plugin gegebenenfalls zu deaktivieren und wieder zu aktivieren, damit die neuen Werte übernommen werden.

Leere Beschriftungen und Meldungen verwenden den Standardtext in der Sprache des Formulars (Deutsch oder Englisch). Ungültige Werte, zum Beispiel Text statt einer Zahl, werden ignoriert. Dann gilt der Standardwert und im Server-Log erscheint ein Hinweis.

Verwendung im Designer

Element einfügen

1. Das gewünschte Formular im formcycle-Designer öffenen.
2. Das Element Multipler Upload aus der Elementpalette an die gewünschte Stelle im Formular ziehen.
3. Im rechten Bereich die Beschriftung, das Pflichtfeld und gegebenenfalls die Upload-Eigenschaften festlegen.

Eigenschaften des Elements

Die Anzahl und die Gesamtgröße der Dateien werden nur über die Plugin-Einstellungen festgelegt. formcycle bietet dafür keine Element-Eigenschaft. Gelten für ein Element andere Werte bei Größe oder Dateityp, wird der Wert des Elements verwendet.

Wiederholbare Container

Das Element kann in wiederholbaren Containern verwendet werden. Jede Wiederholung hat eine eigene Dateiauswahl. Die Grenzen und die Pflichtfeld-Prüfung gelten jeweils pro Wiederholung.

Prüfung und Sicherheit

Die Prüfungen im Browser dienen dem Komfort. Verbindlich ist die Prüfung auf dem formcycle-Server, die beim Speichern jeder einzelnen Datei erfolgt:

Dabei gilt:

• Dateien, die eine Grenze verletzen, werden auf dem Server verworfen und nicht im Vorgang gespeichert. Das ist nur bei manipulierten Anfragen möglich, weil der Browser solche Dateien gar nicht erst zulässt. Jeder Fall wird im Server-Log mit der Meldung "Multipler Upload: Datei … serverseitig verworfen" protokolliert.
• Die Dateiendung wird anhand des letzten Punkts im Dateinamen bestimmt. Die Datei rechnung.pdf.exe gilt deshalb als .exe.
• Tritt bei der Prüfung einer Datei ein Fehler auf, wird die Datei verworfen.
• Dateinamen werden ausschließlich als Text dargestellt. Eingeschleuster HTML- oder Skript-Code wird nicht ausgeführt.
• formcycle prüft seit Version 8.1 zusätzlich systemweit, ob Endung und Dateiinhalt (MIME-Typ) zusammenpassen. Die Einstellung befindet sich unter Systemeinstellungen > Allgemein > Benutzerdefinierte MIME-Typ-Zuordnungen. Diese Prüfung sollte aktiviert bleiben.

Wichtig: Schädlicher Inhalt in echten Dateien (z.B. Makros) wird nicht erkannt. Es wird der Virenscanner von formcycle (System-Plugin) empfohlen.

Daten im Vorgang

• Alle Dateien werden als Anhänge des Vorgangs gespeichert. Sie stehen wie gewohnt in Workflow, E-Mail-Aktionen und Export zur Verfügung.
• Der Wert des Elements enthält die Dateinamen, durch Komma getrennt. Er kann zum Beispiel mit dem Platzhalter [%feldname%] in E-Mails verwendet werden.
• Es werden keine zusätzlichen Formularwerte gespeichert.
• Bearbeiten gespeicherter Vorgänge: Wird ein Vorgang erneut geöffnet (z.B. im Postfach), zeigt das Element die gespeicherten Dateien mit Download-Link an. Beim Speichern bleiben sie erhalten, einzelne Dateien können entfernt werden. Neue Dateien können hinzugefügt werden, sobald alle gespeicherten Dateien entfernt sind (Hinweis im Element).

Hinweise und Grenzen

• Workflow: In Workflow-Aktionen, die ausdrücklich ein Upload-Feld abfragen, bietet formcycle derzeit nur das eingebaute Upload-Element zur Auswahl an. Die Dateien des Elements Multipler Upload sind trotzdem normale Anhänge des Vorgangs.
• Erneute Auswahl nach Prüffehlern: Schlägt die Prüfung beim Absenden fehl, zum Beispiel weil ein anderes Pflichtfeld leer ist, verwirft formcycle aus Sicherheitsgründen alle gewählten Dateien. Sie müssen dann erneut ausgewählt werden. Das gilt ebenso für das formcycle-Upload-Element.
• Globale Upload-Grenzen: Zusätzlich sollten die systemweiten Grenzen von formcycle passend zu den Plugin-Einstellungen gesetzt werden. Es handelt sich um defaults.upload.max_size, defaults.upload.max_size_total und defaults.upload.max_count. Diese Grenzen gelten für die gesamte Anfrage und brechen das Absenden bei Überschreitung ab.
• Große Dateien: Die Dateien werden erst beim Absenden des Formulars übertragen, nicht vorab. Bei sehr großen Gesamtgrößen dauert das Absenden entsprechend länger. Die Grenzen sollten zur Internetanbindung der Antragstellenden passen.
• Browser: Unterstützt werden aktuelle Versionen von Chrome, Edge, Firefox und Safari.

Empfehlung: Die Option Prüfe serverseitig sollte am Element aktiviert bleiben (Standard). Sie sorgt dafür, dass das Pflichtfeld auch auf dem Server geprüft wird und das Zwischenspeichern ohne Prüfung trotzdem funktioniert.