Table of Contents

Das IDataBook Interface definiert die möglichen Events die während der Arbeit mit DataBooks auftreten können. Diese Events werden zu unterschiedlichsten Anlässen ausgelöst. Diese Beschreibung zeigt die möglichen Event Auslöser und die genaue Event Reihenfolge.

Auslöser

Datensätze speichern

Änderungen verwerfen

Einfügen von Datensätzen

Ändern von Datensätzen

Löschen von Datensätzen

Zeilenwechsel

Spaltenwechsel

Aktualisieren der Daten

Zeilenwechsel im Master


Anwendungsbeispiele

Einfügen

EventDescription
BEFORE INSERTING
  • Aktuelle Selektion wechseln um z.B. immer in der ersten oder letzten Zeile einzufügen
  • Exception verursachen um Einfügen zu verhindern
AFTER INSERTINGDefault Werte setzen
BEFORE INSERTED
  • Eingabeabhängige Änderung von Werten
  • Wenn writeback deaktiviert ist, dann kann z.B. eine Server Action aufgerufen werden um das Insert durchzuführen
AFTER INSERTEDDaten aus der Server Tier verarbeiten

Änderungen

EventDescription
BEFORE UPDATINGManuelles Locking
AFTER UPDATINGVisibility oder En/Disable von Komponenten steuern z.B. wenn Editieren nicht erlaubt ist
BEFORE UPDATED
  • Dynamische Spalten berechnen und Werte in writeback Spalten übernehmen
  • Wenn writeback deaktiviert ist, dann kann z.B. eine Server Action aufgerufen werden um das Update durchzuführen
AFTER UPDATEDDaten aus der Server Tier verarbeiten

Löschen

EventDescription
BEFORE DELETING
  • Exception auslösen um Löschen zu verhindern
  • Lösch Abfrage. Dazu wird der Isolation Level auf DATA_SOURCE gesetzt und ein Info Dialog angezeigt. Bei Bestätigung wird saveSelectedRow() aufgerufen und der Isolation Level wieder zurückgesetzt. Bei Abbruch wird restoreSelectedRow() aufgerufen und der Isolation Level wieder zurückgesetzt.
AFTER DELETINGsaveSelectedRow() im DATA_SOURCE Isolation Level aufrufen
BEFORE DELETEDWenn writeback deaktiviert ist, dann kann z.B. eine Server Action aufgerufen werden um das Delete durchzuführen
AFTER DELETEDSummen berechnen

Verwerfen und Wiederherstellen

EventDescription
BEFORE RESTOREException auslösen um Änderungen NICHT zu verwerfen
AFTER RESTOREGUI/Status aktualisierungen

Wertänderung

EventDescription
VALUE CHANGED
  • Abhängige Werte ändern
  • Den geänderten Wert zurücksetzen
  • Zeile speichern bei jeder Wertänderung

Zeilenwechsel

EventDescription
BEFORE ROW SELECTEDException auslösen um das Verlassen der Zeile zu verhindern
AFTER ROW SELECTEDVisibility oder En-/Disable von Komponenten steuern nach einem Zeilenwechsel

Spaltenwechsel

EventDescription
BEFORE COLUMN SELECTED Exception auslösen um das Verlassen der Spalte zu verhindern
AFTER COLUMN SELECTEDVisibility oder En-/Disable von Komponenten steuern nach einem Spaltenwechsel