Handling Multi-marked Records (Magic xpa 3.x)
You can handle events triggered on multi-marked records in a batch-like fashion.
The Magic xpa Table control allows the end user to mark multiple records that are displayed in the table. You can design your task to perform a defined logic unit that handles the marked records automatically. For example, you can provide the end-user with an option to mark invoice records and activate a predefined event to summarize the total of each invoice and display the calculated sum.
This section describes multi-marked record handling. For information on Multi-marking and how to mark records, refer to the Display Forms section in the Reference Guide (in the Magic xpa Help).
When an event is triggered while records are marked in the Table control, the logic unit corresponding to the triggered event is executed for each record. All marked records are automatically handled one after the other.
Marked records are always handled in the order in which they are listed in the task, from top to bottom. They are not handled in the order in which they were marked.
Before every record is handled, the engine enters each record, performs the Record Prefix, and then the logic unit is executed. If the record has been updated and set to execute the Record Suffix, the Record Suffix is executed. The engine moves to the next marked record and handles it in the same way. This continues until all marked records are handled.
The task can be parked on a record that need not be either the first marked record, the last marked record, or a part of the marked records.
Before the runtime engine begins to handle the marked records, the engine exits the current parked record. This means that the engine performs the Control Verification handlers and the Record Suffix of the record if the Record was updated.
When the handling of marked records is finished, the task remains parked on the last marked record.
|
Note:
|
The runtime engine parks on the last marked record once the full record cycle is complete. This means that when the last marked record is reached, the following process occurs: Record Prefix, logic unit, Record Suffix, and again the Record Prefix to park on the record.
|
In this section, you can find information about the following:
Internal Handling of Multi-marked Records
Triggering Events During the Process
Supporting Functions
