Documentation

Trace: DataBook Events

(jvx:client:model:databook)

DataBook Events

Translations of this page:

The IDataBook Iinterface defines the possible events that can occur while using DataBooks. These events are triggered on different occasions. The following instructions show the possible event triggers and the exact event sequence.

Triggers

Saving Records

Discarding Changes

Inserting Records

Editing Records

Deleting Records

Row Change

Column Change

Updating Data

Row Change in Master


Examples

Insert

EventDescription
BEFORE INSERTING
  • Change current selection, e.g., to always insert in the first or last row
  • Throw exception to prevent insertion
AFTER INSERTINGSet default values
BEFORE INSERTED
  • Input-independent change of values
  • If writeback is deactivated, a server action can be called to perform the insertion
AFTER INSERTEDProcess server-tier data

Update

EventDescription
BEFORE UPDATINGManual locking
AFTER UPDATINGControl visibility or en-/disable components. For example, when editing is not permitted
BEFORE UPDATED
  • Calculate dynamic columns and copy values into writeback columns
  • If writeback is deactivated, a server action can be called to perform the update
AFTER UPDATEDProcess server-tier data

Delete

EventDescription
BEFORE DELETING
  • Throw exception to prevent deletion
  • Delete prompt. For this purpose, the Isolation Level is set to DATA_SOURCE and a dialogue is displayed. Upon confirmation, saveSelectedRow() is called and the Isolation Level is reset. If cancelled, restoreSelectedRow() is called and the Isolation Level is reset.
AFTER DELETINGCall saveSelectedRow() at the DATA_SOURCE Isolation Level
BEFORE DELETEDIf writeback is deactivated, a server action can be called to perform the deletion
AFTER DELETEDCalculate sums

Restore

EventDescription
BEFORE RESTOREThrow exception to NOT discard changes
AFTER RESTOREUpdate GUI/status

Value Changed

EventDescription
VALUE CHANGED
  • Change dependent values
  • Reset the changed value
  • Save row after each value change

Row Selected

EventDescription
BEFORE ROW SELECTEDThrow exception to prevent leaving the row
AFTER ROW SELECTEDControl visibility or en-/disable components after a row change

Column Selected

EventDescription
BEFORE COLUMN SELECTED Throw exception to prevent leaving the column
AFTER COLUMN SELECTEDControl visibility or en-/disable components after a column change
This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.More information