Versionen im Vergleich

Alte Version 5

changes.mady.by.user Dirk Münker

Gespeichert am

verglichen mit

Neue Version Aktuell

changes.mady.by.user Sebastian Schulz

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

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.

...

Image Added

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.


  • isEnabled

    • Boolescher Wert. Dieser Wert bestimmt, ob das Feld für den Upload dargestellt werden soll.


  • configKey

    • Zeichenkette. Ein Upload-Konfigurationsdatensatz mit dieser Kennung wird für den Upload genutzt. Dieser Datensatz sollte die whitelist für MimeTypes und einen persistenten Zielpfad beinhalten.




File-Upload Konfiguration
Codeblock
languagejs

...

...

"configuration": {
	"upload": {
		"isEnabled": true,
		"configKey": "base-shopArticle"
	}
}

...


Image Added

Download


Ein Boolescher Wert in der Konfiguration. Dieser Wert bestmimt, ob der Button für den Download dargestellt werden soll.


Datei-Konfiguration Download
Codeblock
languagejs

...

"configuration": {
	"isEnabledDownload": true
}

...




Image Added

Galerie

Ein Objekt gallery in der Konfiguration.

  • isEnabled

    • Boolescher Wert. Dieser Wert bestimmt, ob das Feld für den Upload dargestellt werde soll.

  • configKey

    • Zeichenkette. Ein Galerie-Konfigurationsdatensatz mit dieser Kennung wird für die Galerie genutzt. Dieser Datensatz sollte entsprechend konfiguriert sein.

Datei-Konfiguration Galerie
Codeblock
languagejs

...

...

"configuration": {
	"gallery": {
		"isEnabled": true,
		"configKey": "base-shopArticle"
	}
}

...


Image Added

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.

Mehrfachauswahl

Es ist möglich ein Dateifeld einzurichten, welches eine Mehrfachauswahl an Dateien erlaubt. So ist es beispielsweise möglich, mehrere Dateien hochzuladen oder mehrere Dateien in der Galerie auszuwählen und diese Information in einem Feld zu speichern. Es ist zu beachten, dass es sich hierbei um ein anderes Format beim Speichern der Dateien handelt. In diesem Fall werden die IDs der Dateien gespeichert, nicht die Pfade selbst. Somit ist die Standardkonfiguration eines Datei-Feldes nicht durch diese Konfiguration ersetzbar.

Konfiguration

Integriert werden kann diese Art des Eingabefeldes durch die Datenmodellierung und die Datenbankwidgets. Um ein Dateiauswahlfeld für mehrere Dateien zu erhalten, muss ein Feld vom Typ "Select"erstellt und auskonfiguriert werden. In der Datenmodellierung ist das Pendant dazu der Feldtyp "Auswahlfeld". Zudem muss in der Konfiguration das Key-Value-Paar "source": "FileAttachment" ergänzt werden. In dieser Form gibt es aber noch keine Interaktionsmöglichkeit mit der Dateiauswahl. Es ist dem Nutzer nur möglich die bereits gewählten IDs einzusehen oder die Auswahl aufzuheben. Um dem Nutzer Interaktionsmöglichkeiten bereitzustellen, muss das Feld entsprechend konfiguriert werden. Die Konfiguration ist identisch mit der Konfiguration des einfachen Dateifeldes (siehe oben).


Standardkonfiguration
Codeblock
languagejs
{
  "identifier": "testField",
  "labels": {
    "de": "LabelDE",
    "en": "LabelEN"
  },
  "formType": "Select",
  "configuration": {
    "source": "FileAttachment",
    "multiple": true,
    "isEnabledDownload": true
  }
}