Mithilfe der Ansichtseinstellungen werden in brandbox die Darstellungen der einzelnen Datensatzlisten gesteuert. Diese werden pro Anwender/Tabelle festgelegt und können zwischen Anwendern geteilt werden. Erreichbar sind die Ansichtseinstellungen über den Button mit dem Stapel Symbol in den Toolbars der einzelnen Datensatzlisten.
Verfügbare Einstellungen
Für jede Datensatzliste (Datenbanktabelle) stehen die folgenden Einstellungen zur Verfügung:
Art der Darstellung einer Datensatzliste (Tabelle, Baum, Karten)
Sortierung der Datensätze in dieser Liste (maximal 3 Sortierkriterien)
Maximale Anzahl von Datensätzen pro Seite
Kollation der Datensätze bei mehrsprachigen Datenbanktabellen
Zusätzlich stehen pro Darstellung spezifische Einstellungen zur Verfügung. Für jede Darstellung werden zudem die zu zeigenden Informationen konfiguirert. Hier wählen Sie in einer erweiterbaren Liste die verfügbaren Informationen aus.
Programmatischer Abruf
Um auf Ansichtseinstellungen zugreifen zu können, wird zunächst das Entity der Datensatzes benötigt. Der Manager von Component/Settings steht hierzu die folgenden Methoden zur Verfügung:
Methode | Beschreibung |
---|---|
| Der Parameter |
| Hiermit wird ein bestimmter Einstellungssatz aus der Datenbank abgerufen. Der Parameter |
Sobald man über einen Einstellunsdatensatz verfügt kann dieser in einen Provider für die Einstellungen eingesetzt werden oder der Manager-Methode populate()
übergeben werden damit ein Doctrine-QueryBuilder entsprechend mit Bedingungen gefüllt wird.
Einstellungsprovider
// Abrufen eines Einstellungsdatensatzes $entity = $this ->staticController(Component\Settings\Manager::class) ->getSettingsTemporary('[Identifikator des Entities]') ; // Erstellen eines Providers $provider = new Component\Settings\Lib\Struct\Provider($entity); // Alter Provider aus Base/Settings (deprecated) $provider = $this ->staticController(Base\Settings\Manager::class) ->getProvider('[Identifikator des Entities]') ;
Eventübersicht
Klassenname | Beschreibung |
---|---|
| Wird ausgelöst um die verfügbaren Datensatzlistendarstellungen einzusammeln. |
| Wird ausgelöst um die Standarddarstellung einer Datensatzliste festzulegen, sofern keine durch den Anwender bestimmt wurde. |
| Wird ausgelöst um die verfügbaren Sortierspalten für eine Datensatzliste einzusammeln. |
| Wird ausgelöst um die Standardsortierung für eine Datensatzliste festzulegen. |
| Wird ausgelöst um die Bearbeitungsoberfläche für die Ansichtseinstellungen aufzufüllen. Das Event für die mögliche Datensatzlistendarstellung ausgelöst. |