Versionen im Vergleich

Schlüssel

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

Die Datensatzbearbeitung von Base stellt dem Anwender ein Formular zum Erstellen oder Verändern eines Datensatzes bereit. Diese Ansicht kann über Events beeinflusst und erweitert werden.

Schaltfläche zum Erstellen eines Datensatzes
Codeblock
languagephp
use Brandbox\Framework\Base\Edit;

$identifier = 'shopArticle'; // Identifikator der Datenbanktabelle

$button = $this
	->staticController(Edit\Manager::class)
	->getButtonCreate($identifier)
;

// $button kann 'null' oder ein \Brandbox\FrameworkStyleguide\Entity\FrameworkButton


Schaltfläche zum Bearbeiten eines Datensatzes
Codeblock
languagephp
use Brandbox\Framework\Base\Edit;

$identifier = 'shopArticle'; // Identifikator der Datenbanktabelle
$id = 123; // ID des Datensatzes

$button = $this
	->staticController(Edit\Manager::class)
	->getButtonEdit($identifier, $id)
;

// $button kann 'null' oder ein \Brandbox\FrameworkStyleguide\Entity\FrameworkButton

Toolbar

Die Toolbar der Datensatzbearbeitung wird mithilfe von Component/Toolbar aufgebaut. Als Kontextklasse für diese Toolbar wird \Brandbox\Framework\Base\Edit\Lib\Struct\ToolbarContext genutzt.

Speicheroptionen

Ähnlich zu den Kopier- und Löschfunktionen von Base, stehen auch hier Speicheroptionen zur Verfügung.

Eventübersicht

Klassenname

Beschreibung

OnExecuteSave

Wird beim Speichern des Datensatzes ausgelöst.

OnPopulateActions

Wird vor dem Speichern eines Datensatzes ausgelöst um die verfügbaren Speicheroptionen einzusammeln.

OnPopulateEdit

Wird beim Aufbau der Datensatzbearbeitungsansicht ausgelöst.

OnPopulateEditContainer

Wird ebenfalls beim Aufbau der Ansicht ausgelöst um den mehrspaltigen Container zu befüllen.

OnPopulateEditForm

Wird nach Aufbau des Formulars ausgelöst.

OnPopulateEditToolbarButtons

Wird beim Aufbau der Toolbar ausgelöst um die Schaltflächen für das Speichern des Datensatzes einzusammeln.

OnPopulateEntity

Wird vor Aufbau der Ansicht ausgelöst um das zu bearbeitende Entity zu definieren.

OnPopulateListed

Wird beim Aufbau des Formulars und beim Speichern des Datensatzes ausgelöst um die anzuzeigenden Eingabefelder und zu ignorierenden Fehlermeldungen bei der Validierung zu definieren.

OnValidateEntity

Wird beim Speichervorgang ausgelöst um das zu speichernde Entity zu validieren.

Nachfolgend eine Übersicht über die Zusammenhänge der genannten Events.

Drawio
bordertrue
diagramNameDatensatzbearbeitung (Eventübersicht)
simpleViewerfalse
width800
linksauto
tbstyletop

...

lboxtrue

...

diagramDisplayName

...

revision2
diagramWidth681