Mit dem Attachment ist es möglich in eine Formularanwendung weitere Dateien als Anhang hinzuzufügen.
Mögliche Anwendungen sind das Hinzufügen von Bildern oder Rechnungsbelegen zu Antragsformularen. Der Platzhalter in der beispielhaften Form [@attachments_1] liefert die Anzahl der Anhänge in diesem Control.
| Eigenschaft | Beschreibung |
|---|---|
| Filter | Angabe der erlaubten Dateiformate Die Beschreibung des Filters besteht aus mehreren Komponenten: - Bezeichnung - In Klammern die semikolonseparierte Aufzählung der Typen mit jeweils anführendem Sternchen ohne Leerzeichen - Anführender Trennstrich und semikolonseparierte Aufzählung der Typen mit jeweils anführendem Sternchen Beispiele für Filter: - Textdateien sind erlaubt: Textdateien(*.txt;*.docx)|*.txt;*.docx - Bilddateien und PDF-Dokumente sind erlaubt: Bilddateien(*.jpeg;*.jpg)|*.jpeg;*.jpg|PDF(*.pdf)|*.pdf- Alle Dateiformate sind erlaubt: AlleDateitypen(*.*)|*.* |
| MaxFiles | Angabe der maximalen Anzahl für hinzufügbare Dateien |
| MaxSize | Angabe der maximalen Größe aller hinzugefügten Dateien Angabe in kb Hinweis: Diese Uploadbeschränkung bezieht sich ausschließlich auf die Datei-Anhänge in dem betreffenden Control des individuellen Formulars (WIN und WEB). Davon zu unterscheiden ist die maximale Größe für Dokumente, die direkt auf den FormServer hochgeladen werden: Sie ist eine Eigenschaft des MASKITO FormServers, die in der Konfiguration des FormServers festgelegt werden kann. Die Angaben der maximal erlaubten Datenmenge für Datei-Anhänge im AttachmentControl eines Formulars und für Dateien, die auf den FormServer hochgeladen werden, können also verschieden sein und sind unabhängig voneinander. |
| Bildvorschau | Ab MASKITO Forms 7.2 kann über diese Eigenschaft definiert werden, ob bei einem im AttachmentControl hochgeladenen Bild eine Bildvorschau direkt im Control angezeigt werden soll. (True = Bildvorschau aktiv) Wird die Bildvorschau nachträglich für ein AttachmentControl deaktiviert, sind in bereits bestehenden Datensätzen trotzdem noch alle bereits hochgeladenen Bilder im Control als Bildvorschau sichtbar. Die Bilder können über den Löschen-Button entfernt werden. Die Anzeige der hochgeladenen Bilder in einem auf Basis des Formulars generierten PDFs erfolgt in Form des Dateinamens. Bei der Verwendung der Bildvorschau kann maximal ein Bild je Control hochgeladen werden. Es ist zu beachten, dass bei Formularausführung vom Nutzer hinzugefügte Anlagen erst nach dem Speichern des Web-Formulars an den MASKITO FormServer übertragen werden. Soll ein Attachment-Control mit Bildvorschau noch während der Eingabe per Funktion für weitere Eingaben gesperrt (disabled) bzw. nur noch zum Lesen dargestellt (read only) werden, muss der Datensatz zuvor gespeichert werden, damit das Bild als Vorschau im Formular ausgegeben wird. |
| SimpleMode | False = Ausgabe mit Zusatzinformationen wie Beschreibung und Gesamtgröße der Anlage True = platzsparende Ausgabe als eine Zeile Ab Version 5.4 verfügbar |
Positionierung per Drag&Drop auf dem Formular im Maskito FormDesigner.
Zählen Sie bei der Eigenschaft Filter die gewünschten Dateiformate durch einen senkrechten Strich oder ein Semikolon getrennt auf.
Beispiele:
|*.jpeg|*.jpg|*.png bzw. Bilddateien(*.jpeg;*.jpg;*.png)|*.jpeg;*.jpg;*.pngBilddateien(*.jpeg;*.jpg)|*.jpeg;*.jpg|Word-Dateien(*.docx)|*.docxDie Anzahl der im AttachmentControl enthaltenen Dateien kann mit Hilfe der Erweiterung .Value erhoben werden, z. B. [@attachments_1.Value], wenn der Name des Controls [@attachments_1]lautet. So kann beispielsweise für eine Vollständigkeitsprüfung ermittelt werden, ob ein Anhang hochgeladen wurde, oder auch die Summe aller im Formular enthaltenen Datei-Anhänge mit einer Funktion und der Berechnung [!Berechnung:0] kalkuliert werden, also z. B. [![@attachments_1.Value]+[@attachments_2.Value]:0].
Die Datei-Anhänge, die einem Formular im AttachmentControl mitgegeben werden, können ab MASKITO Forms 7.1 im Formular zusätzlich auch als übersichtliche Liste dargestellt werden, etwa für die Erstellung eines PDFs. Dazu wird mit dem Funktionseditor eine Funktion definiert, die einem geeigneten Ausgabe-Control die Liste der Datei-Anhänge semikolonsepariert mittels der Erweiterung .Text übergibt, z. B. [@attachments_1.Text].
Falls ein Zeilenumbruch anstatt des Semikolons als Trennzeichen gewünscht ist, kann dies mittels der Zeichenkettenfunktion str_replace umgesetzt werden, z. B.
[str_replace(";","
","[@attachments_1.Text]")]
In diesem weiteren Artikel stellen wir Ihnen die Anleitung für asynchronen Datenaustausch bereit, also wie Sie mit AttachmentControl einen effizienten asynchronen Datentransfer in MASKITO FormServer realisieren.
Kategorie: Controls