Datensatzbearbeitung (Base/Edit)

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

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

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

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.