Trace:
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
jvx:client:model:databook:events [2018/02/01 09:02] admin created |
jvx:client:model:databook:events [2020/06/08 15:38] (current) cduncan Edited for English grammar (capitalization, punctuation, correct verb conjugation) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ~~Title: DataBook events~~ | + | ~~Title: DataBook Events~~ |
| 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. | 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 == | + | ===== Triggers ===== |
| - | * Saving records | + | ==== 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 == | + | |
| {{:jvx:client:model:databook:saveselectedrow.png?nolink|}} | {{:jvx:client:model:databook:saveselectedrow.png?nolink|}} | ||
| - | == Discarding Changes == | + | ==== Discarding Changes ==== |
| {{:jvx:client:model:databook:restoreselectedrow.png?nolink|}} | {{:jvx:client:model:databook:restoreselectedrow.png?nolink|}} | ||
| - | == Inserting records == | + | ==== Inserting Records ==== |
| {{:jvx:client:model:databook:insert.png?nolink|}} | {{:jvx:client:model:databook:insert.png?nolink|}} | ||
| - | == Editing records == | + | ==== Editing Records ==== |
| {{:jvx:client:model:databook:update.png?nolink|}} | {{:jvx:client:model:databook:update.png?nolink|}} | ||
| Line 44: | Line 23: | ||
| {{:jvx:client:model:databook:setvalue.png?nolink|}} | {{:jvx:client:model:databook:setvalue.png?nolink|}} | ||
| - | == Deleting records == | + | ==== Deleting Records ==== |
| {{:jvx:client:model:databook:delete.png?nolink|}} | {{:jvx:client:model:databook:delete.png?nolink|}} | ||
| - | == Row change == | + | ==== Row Change ==== |
| {{:jvx:client:model:databook:setselectedrow.png?nolink|}} | {{:jvx:client:model:databook:setselectedrow.png?nolink|}} | ||
| - | == Column change == | + | ==== Column Change ==== |
| {{:jvx:client:model:databook:setselectedcolumn.png?nolink|}} | {{:jvx:client:model:databook:setselectedcolumn.png?nolink|}} | ||
| - | == Updating data == | + | ==== Updating Data ==== |
| {{:jvx:client:model:databook:reload.png?nolink|}} | {{:jvx:client:model:databook:reload.png?nolink|}} | ||
| - | == Row change in Master == | + | ==== Row Change in Master ==== |
| {{:jvx:client:model:databook:masterchanged.png?nolink|}} | {{:jvx:client:model:databook:masterchanged.png?nolink|}} | ||
| + | \\ | ||
| - | === Examples === | + | ====== Examples ====== |
| - | == Insert == | + | ==== Insert ==== |
| ^Event^Description^ | ^Event^Description^ | ||
| |BEFORE INSERTING|<WRAP> | |BEFORE INSERTING|<WRAP> | ||
| - | * Change current selection, e.g. to always insert in the first or last row | + | * Change current selection, e.g., to always insert in the first or last row |
| * Throw exception to prevent insertion | * Throw exception to prevent insertion | ||
| </WRAP>| | </WRAP>| | ||
| Line 81: | Line 61: | ||
| |AFTER INSERTED|Process server-tier data| | |AFTER INSERTED|Process server-tier data| | ||
| - | == Update == | + | ==== Update ==== |
| - | == Delete == | + | ^Event^Description^ |
| + | |BEFORE UPDATING|Manual locking| | ||
| + | |AFTER UPDATING|Control visibility or en-/disable components. For example, when editing is not permitted| | ||
| + | |BEFORE UPDATED|<WRAP> | ||
| + | * Calculate dynamic columns and copy values into writeback columns | ||
| + | * If writeback is deactivated, a server action can be called to perform the update | ||
| + | </WRAP>| | ||
| + | |AFTER UPDATED|Process server-tier data| | ||
| - | == Restore == | + | ==== Delete ==== |
| - | == Value changed == | + | ^Event^Description^ |
| + | |BEFORE DELETING|<WRAP> | ||
| + | * 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. | ||
| + | </WRAP>| | ||
| + | |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| | ||
| - | == Row selected == | + | ==== Restore ==== |
| - | == Column selected == | + | ^Event^Description^ |
| + | |BEFORE RESTORE|Throw exception to NOT discard changes| | ||
| + | |AFTER RESTORE|Update GUI/status| | ||
| + | |||
| + | ==== Value Changed ==== | ||
| + | |||
| + | ^Event^Description^ | ||
| + | |VALUE CHANGED|<WRAP> | ||
| + | * Change dependent values | ||
| + | * Reset the changed value | ||
| + | * Save row after each value change | ||
| + | </WRAP>| | ||
| + | |||
| + | ==== Row Selected ==== | ||
| + | |||
| + | ^Event^Description^ | ||
| + | |BEFORE ROW SELECTED|Throw exception to prevent leaving the row| | ||
| + | |AFTER ROW SELECTED|Control visibility or en-/disable components after a row change| | ||
| + | |||
| + | ==== Column Selected ==== | ||
| + | |||
| + | ^Event^Description^ | ||
| + | |BEFORE COLUMN SELECTED |Throw exception to prevent leaving the column| | ||
| + | |AFTER COLUMN SELECTED|Control visibility or en-/disable components after a column change| | ||