--DataBook events

[Development@SIB]

This article is outdated - please use our new system at

https://doc.sibvisions.com




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.

Event triggers

• Saving records
• Discarding changes
• Inserting records
• Editing records
• Deleting records
• Row change
• Column change
• Updating data
• Row change in Master

Event examples

• INSERT
• UPDATE
• DELETE
• RESTORE
• VALUE CHANGED
• ROW SELECTED
• COLUMN SELECTED

Saving Records

saveSelectedRow.png (22.93 KiB) Viewed 121997 times

Discarding Changes

restoreSelectedRow.png (16.36 KiB) Viewed 121997 times

Inserting records

insert.png (16.59 KiB) Viewed 121997 times

Editing records

update.png (12.92 KiB) Viewed 121997 times

setValue.png (8.26 KiB) Viewed 121997 times

Deleting records

delete.png (19.02 KiB) Viewed 121997 times

Row change

setSelectedRow.png (23.49 KiB) Viewed 121997 times

Column change

setSelectedColumn.png (9.45 KiB) Viewed 121997 times

Updating data

reload.png (6.25 KiB) Viewed 121997 times

Row change in Master

masterchanged.png (6.17 KiB) Viewed 121902 times

Examples

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

BEFORE UPDATING		Manual locking
AFTER UPDATING		Control visibility or en-/disable components, when, for example, 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 UPDATED		Process server-tier data

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 DELETING		Call saveSelectedRow() at the DATA_SOURCE Isolation Level
BEFORE DELETED		If writeback is deactivated, a server action can be called to perform the deletion
AFTER DELETED		Calculate sums

BEFORE RESTORE		Throw exception to NOT discard changes
AFTER RESTORE		Update GUI/status

VALUE CHANGED

Change dependent values Reset the changed value Save row after each value change

BEFORE ROW SELECTED		Throw exception to prevent leaving the row
AFTER ROW SELECTED		Control visibility or en-/disable components after a row change

BEFORE COLUMN SELECTED		Throw exception to prevent leaving the column
AFTER COLUMN SELECTED		Control visibility or en-/disable components after a column change