Um Dateien wie zum Beispiel Bilder in brandbox mit Datensätzen zu verknüpfen, steht die Dateiauswahl zur Verfügung. Die Dateiauswahl kann konfigurativ um Funktionen erweitert werden.
Konfiguration
Integriert werden kann diese Art des Eingabefeldes durch die Datenmodellierung und die Datenbankwidgets. Um ein Dateiauswahlfeld in seiner einfachsten Form zu erhalten, muss lediglich der Wert für "formType" auf "file" gesetzt werden. In der Datenmodellierung ist das Pendant dazu der Feldtyp "Dateiauswahl".
In dieser Form gibt es aber noch keine Interaktionsmöglichkeit mit der Dateiauswahl. Es ist dem Nutzer nur möglich den Dateipfad einzusehen oder die Auswahl aufzuheben. Diese Art von Konfiguration ist nur für Felder zu empfehlen, deren Inhalte nur von Geschäftslogik definiert werden.
Um dem Nutzer Interaktionsmöglichkeiten bereitzustellen, muss das Feld entsprechend konfiguriert werden.
Bezeichnung | Konfiguration | Darstellung |
---|---|---|
Upload | Ein Objekt upload in der Konfiguration.
File-Upload Konfiguration "configuration": { "upload": { "isEnabled": true, "configKey": "base-shopArticle" } } | |
Download | Ein Boolescher Wert in der Konfiguration. Dieser Wert bestmimt, ob der Button für den Download dargestellt werden soll. Datei-Konfiguration Download "configuration": { "isEnabledDownload": true } | |
Galerie | Ein Objekt
Datei-Konfiguration Galerie "configuration": { "gallery": { "isEnabled": true, "configKey": "base-shopArticle" } } |
Hinweis - Formulartyp Dateiauswahl
Bis zu dieser Version war das Auswahlfeld ein direkter Bestandteil von uiBase. Im Zuge von v5.5 wurde das Feld jedoch als addon/input Plugin ausgelagert. Um möglichst kompatible mit den anderen Versionen zu bleiben, wurde die Option "Dateiauswahl" für den Formulartyp in der Feldkonfiguration beibehalten. Diese Auswahl resultiert dann in dem Feld input/file.upload/gallery bedarf aber keiner weiteren Konfiguration. Allerdings sollte hier dennoch die Konfiguration als "Benutzerdefiniertes Feld" bevorzugt werden. "Dateiauswahl" sollte im Adminbereich und in den Editoren funktionieren, wird aber nicht genauso in Formularen im Shop dargestellt - z.B. Erweiterung der Benutzerfelder. In diesem Fall muss die Konfiguration als "Benutzerdefiniertes Feld" erfolgen.