Download erlauben

Blendet dem Benutzer einen Download-Knopf ein, wenn eine Datei ausgewählt wurde.

Durch Klicken auf den Download-Knopf wird die Datei direkt heruntergeladen.

Hinweis: Ist das "content" Feld der Elementdaten leer/null und im Feld "remoteFilePath" steht ein gültiger Server-Dateipfad (relativ zum Lobster Data Platform / Orchestration Upload-Verzeichnis), so benötigt der Benutzer zusätzlich das Recht Dateien lesen zu können (Verwaltung/System/Dateimanager/Lesen).

Wachsen für Drag&Drop

Aktiviert/Deaktiviert das automatische "Wachsen" der Dateikomponente, wenn eine Datei darüber gezogen wird

Datei/Zeichnung wechseln erlaubt

Erlaubt dem Benutzer das Wechseln zum Anzeigetyp "Zeichenfläche",
um eine Zeichnung oder Unterschrift direkt zu erfassen (siehe Darstellungstyp "Zeichenfläche").
Zum Wechseln wird dazu ein separater Knopf eingeblendet.

Rahmen anzeigen

Nur aktiv, wenn die Option "Datei/Zeichnung wechseln erlaubt" aktiviert ist.
Legt fest, ob die Zeichenfläche mit einem Rahmen dargestellt werden soll.

Standard Dateiname

Legt den Namen der Datei fest, sollte dieser nicht ermittelt werden können.
Beispielsweise beim Erfassen einer Unterschrift oder wenn kein Dateiname gegeben ist
(z.B. beim Laden einer Datei aus den Formulardaten).

Hier kann auch ein Berechnungsausdruck hinterlegt werden.

Typfilter

Eine optionale komma-separierte Liste von Mime-Typen, welche als Dateityp-Filter im Dateiauswahldialog des Browsers gesetzt werden.
Die Mime-Typen sind in der Webwelt standardisiert und können durch eine kurze Internet-Recherche einfach herausgefunden werden.

Beispiel für einen Filter, welcher gängige Bilddateiformate und PDF-Dateien filtern soll:
"image/jpeg, image/png, application/pdf"

Tipp: Der Mime-Type einer bestimmten Datei kann auch herausgefunden werden, indem diese über das Datei-Element (mit Datenfeld!) im Testmodus des Editors hochgeladen wird.
Anschließend kann über die Ribbonfunktion "Struktur Export" der Dateityp eingesehen werden.

Uploadmodus

Der Uploadmodus legt fest wie die ausgewählten Dateien hochgeladen werden sollen.

• BASE64
  Die Datei wird komplett lokal als ByteArray in die Formulardaten geschrieben und zur Verarbeitung als Text (z.B. Lobster_data Knoten) als BASE64 String kodiert.
  Vorteile:
  - Die Datei kann direkt verarbeitet werden
  Nachteile:
  - Große Dateien können den verfügbaren Arbeitsspeicher des Browsers oder der Applikation erschöpfen und damit zum Absturz der Anwendung führen
  - Keine Möglichkeit der Anzeige eines Fortschritts. Der Vorgang blockiert die Applikation bis die Daten übertragen wurden

• SERVER_UPLOAD (nicht verwendbar in Verbindung mit der "Zeichenfläche")
  Die Datei wird entweder direkt in das Zielverzeichnis auf dem Server übertragen (relativ zum konfigurierten Upload-Verzeichnis von Lobster Data Platform / Orchestration) oder mit einem automatisch generierten Dateinamen in das temporäre Verzeichnis von Lobster_data geschrieben. Abhängig von der verwendeten Variante steht nach dem Hochladen entweder der als Ziel verwendete Dateipfad (remoteFilePath) oder der generierte Name der Temporärdatei (tempFileName) in den Formulardaten des Elements zur Verfügung.
  Vorteile:
  - Große Dateien können hochgeladen werden ohne sie in den Arbeitsspeicher des Clients zu laden
  - Dem Benutzer kann der Fortschritt des Hochladevorgangs angezeigt welcher den Vorgang sogar abbrechen kann
  Nachteile:
  - Dateien können nicht direkt in den Formulardaten verarbeitet und übertragen werden sondern müssen erst auf der Server-Seite entsprechend gelesen oder anderweitig abgelegt werden
  - Ohne die Angabe eines Zielverzeichnisses können hochgeladene Inhalte nicht direkt im Formular angezeigt werden (Stichwort: Vorschau)
  
  ►HINWEIS◄ Zum Verarbeiten einer temporär hochgeladenen Datei steht in Lobster_data die Funktion Lobster_pro: resolve temporary uploaded file path (_data-Funktion) zur Verfügung, die anhand des Namens der Temporärdatei tempFileName den relativen Pfad zu dieser Datei ermittelt.

Existierende Dateien immer ersetzen

Diese Einstellmöglichkeit steht nur zur Verfügung, wenn als Uploadmodus "SERVER_UPLOAD" gewählt wurde.
Deaktiviert/Aktiviert die Benutzerrückfrage für den Fall dass eine hochzuladende Datei bereits im Zielverzeichnis existiert.

Zielverzeichnis auf dem Server

Diese Einstellmöglichkeit steht nur zur Verfügung, wenn als Uploadmodus "SERVER_UPLOAD" gewählt wurde.
Gibt das Zielverzeichnis auf dem Server relativ zum konfigurierten Upload-Verzeichnis von Lobster Data Platform / Orchestration als Berechnungsausdruck an.
Hinweis: Das Upload-Verzeichnis kann im Dateimanager verwaltet werden.

content

Die ausgewählte Datei als Byte Array (Als Textbasis auch Base64 kodiert) oder leer, wenn als Uploadmodus SERVER_UPLOAD gewählt wurde

name

Der Name der Datei

remoteFilePath

Beinhaltet den für den Client erreichbaren Dateipfad auf dem Server (nur bei SERVER_UPLOAD mit definiertem Zielverzeichnis, sonst null)

tempFileName

Beinhaltet den Namen einer temporär hochgeladenen Datei (nur bei SERVER_UPLOAD ohne definiertem Zielverzeichnis, sonst null)

size

Die Größe der Datei in Bytes

creationDate

Der Erstellzeitpunkt der Datei als UNIX Zeitstempel in Millisekunden

creator

Der Ersteller der Datei (optional)

modificationDate

Der Zeitpunkt der letzten Dateiänderung als UNIX Zeitstempel in Millisekunden

type

Der Typ der Datei (z.B.: "image/png", "application/pdf", ...)

downloadUrl

Wenn kein content und kein remoteFilePath gesetzt ist, wird diese Url - sofern befüllt - für den Download verwendet