✎ DataBook Ereignisse | Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
~~Title: DataBook Events~~

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.

===== Trigger =====

==== Datensätze speichern ====

{{:jvx:client:model:databook:saveselectedrow.png?nolink|}}

==== Änderungen verwerfen ====

{{:jvx:client:model:databook:restoreselectedrow.png?nolink|}}

==== Einfügen von Datensätzen ====

{{:jvx:client:model:databook:insert.png?nolink|}}

==== Ändern von Datensätzen ====

{{:jvx:client:model:databook:update.png?nolink|}}

{{:jvx:client:model:databook:setvalue.png?nolink|}}

==== Löschen von Datensätzen ====

{{:jvx:client:model:databook:delete.png?nolink|}}

==== Zeilenwechsel ====

{{:jvx:client:model:databook:setselectedrow.png?nolink|}}

==== Spaltenwechsel ====

{{:jvx:client:model:databook:setselectedcolumn.png?nolink|}}

==== Aktualisieren der Daten ====

{{:jvx:client:model:databook:reload.png?nolink|}}

==== Zeilenwechsel im Master ====

{{:jvx:client:model:databook:masterchanged.png?nolink|}}

\\ 

====== Anwendungsbeispiele======

==== Einfügen ====

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

==== Änderungen ====

^Event^Description^
|BEFORE UPDATING|Manual locking|
|AFTER UPDATING|Control visibility or en-/disable components, when, for example, 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|

==== Löschen ====

^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|

==== Verwerfen und Wiederherstellen ====

^Event^Description^
|BEFORE RESTORE|Throw exception to NOT discard changes|
|AFTER RESTORE|Update GUI/status|

==== Wertänderung ====

^Event^Description^
|VALUE CHANGED|<WRAP>  
  * Change dependent values
  * Reset the changed value
  * Save row after each value change
</WRAP>|

==== Zeilenwechsel ====

^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|

==== Spaltenwechsel ====

^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|