Dateiupload

Konfiguration

Beispiel Konfiguration

Achtung: keine Abstände/Leerschläge zwischen den Definitionen (gif,jpg,jpeg)

1. Dateigrösse

Standardmässig sind 5 MB (5242880 Bytes) Angabe in Bytes. Die Anzeige der Dateigrösse beim Formularfeld, verhält sich dynamisch, kleinere Angaben werden in KB, grössere in MB angezeigt.
» Umrechnungstool (MB > bytes)

Dateigrösse per E-Mail: Bitte beachten Sie, dass es bei der Übermittlung der Anhänge via E-Mail oft Einschränkungen haben kann.

2. Gültige Dateiendungen

Wenn leer, werden alle Dateiendungen / Dateitypen zugelassen. Die Angabe der zulässigen Dateitypen basiert auf der Dateiendung. Die Angaben sind mit Komma zu trennen.

Beispiel Dateiupload

3. Testen / Fehlermeldung

Sind die erlaubten Dateiendungen/Dateigrössen einmal eingestellt, wird dies beim Upload automatisch verprüft (es sind also keine zusätzlichen Einstellungen nötig). 

Zieldateiname festlegen

Über eine Eigenschaft kann der gewünschte Dateiname festgelegt werden. Der Dateiname kann als Wert (Zeichen/String) oder als Formel mit Werten aus dem Formular zusammengesetzt werden.

Dies dient einer besseren Weiterverarbeitung von Datein. Nichtsaussagende Bennenungen wie "doc1.docx" können verhindert werden. Wird zweimal dieselbe Datei konzept.pdf hochgeladen, kann damit im themantischen Kontext eine Unterscheidung sichergestellt werden.

Konfiguration

Im Bereich (Reiter/Tab) Eigenschaften wird eine neue property angelegt [ + ]

Key = jax-filename-overwrite

Im zweiten Feld wird eine Formel erwartet. Text (String) muss mit " erfasst sein.

Als Formel können unterschiedlichste Werte zusammengefügt werden. Zum Beispiel

• "Portrait_von_" + feldName + "-" + feldVorname

Dies ergäbe beim Upload eines Portraits (.jpg) von Hans Muster folgenden Dateinamen Portrait_von_Hans-Muster.jpg

Hinweis : Dateiname statt GUID

Standardmässig wird jeder Upload als technische GUID (z.B. so 9f07d8c9-5f2b-4d66-a0a5-df00802d93c4) geführt. Die übliche Weiterverarbeitung gibt bei der Übermittlung den Dateinamen und die Datei weiter. Es ist nichts zu beachten.

Für die Verwendung des Dateinamens der hochgeladenen Datei in Regeln oder in Textausgaben als Wert dient die GUID nicht. Damit der Dateiname verwendet wird, muss in der Formel folgende Funktion verwendet werden:

• pInstruct(node(" feldname "), "jax", "fileName")
• pInstruct(node(" uploadTeilnahmebestaetigung "), "jax", "fileName")

Beispiel einer Regel:

Beispiel eines im XML gespeicherten Wertes

<var id="uploadTeilnahmebestaetigung">  
<?jax fileName="Quittung_Kurskosten_H.Muster.pdf" fileSize="153959"?>
9f07d8c9-5f2b-4d66-a0a5-df00802d93c4
</var>

Validierungsreihenfolge

Falls Ein Upload mit gültigen Dateiendungen konfiguriert wurde, so wird die im Browser ausgewählte Datei vor dem Upload an den Server mittels lokalem Javascript geprüft, und falls diese nicht der erwarteten Dateiendung(en) entspricht, so wird der Upload verhindert. Nach einem erfolgreichem Dateiupload wird serverseitig Folgendes in dieser Reihenfolge geprüft:

• Maximale Dateigrösse
• Allenfalls konfigurierte gültige Dateiendungen werden serverseitig nochmals geprüft
• Falls ein Viruschecker im System konfiguriert wurde, wird die Datei auf Malware geprüft
• Die hochgeladene Datei wird mittels einer MagicByte-Überprüfung auf gültigen Dateiinhalt überprüft. Im Sinne von: Ist das hochgeladene PDF (mit der Endung .pdf) auch wirklich ein PDF

<property mutable="true">
        <key>jaxfront.file.contentValidator.extensionWhitelist</key>
        <value>txt,csv,nls,svg</value>
</property

Könnte auch interessant sein

- Optimierte Darstellung beim Mehrfachuploads