Supporting Functions (Magic xpa 3.x)
Magic xpa provides you with additional functions that allow you to control the process of handling multi-marked records better.
You can use the MMCount function to query the number of records that are currently marked. This function can be directed to a particular task generation, allowing you to query the number of marked records in ancestor tasks.
|
Tip:
|
This function returns zero if no record is marked. In this way you can check if records are marked or not.
|
You can query which record out of the marked record is handled. The MMCurr function returns the number of the currently processed record from the total of marked records. This function can be directed to a particular task generation, allowing you to query the currently handled marked record in ancestor tasks.
The logic unit executed on multi-marked records is the same for all marked records. Sometimes you only need to execute part of the logic when the unit is first executed; for example, to reset variables or open a dialog box to confirm the process. At other times you may need to execute only part of the logic in the last cycle at the end of the process; for example, to display result information.
You can use the MMCurr and MMCount functions to identify these phases:
-
When the MMCurr function returns a value of 1. This means that it is the first cycle and the beginning of the process.
-
When the number of currently handled records equals the total number of marked records, in other words when MMCurr equals MMCount. This means that it is the last cycle and the end of the process.
When handling of the marked records is complete, the handled records remain marked. This lets the end-user perform several tasks on the same set of marked records. You can use the MMClear function to clear record marking.
You can use the MMStop function to stop the automatic process of handling marked records. This function lets you stop the logic unit from being executed on the remaining marked records.
When the MMStop function is evaluated during the process, the function completes the logic unit for the current running record. However, after this record is handled, the task parks on the record and the process stops. When you use the MMStop function to stop the process, the records remain marked.
|
Note:
|
Both the MMClear and MMStop functions are only relevant for the current task. You cannot stop the process or clear the marking of ancestor tasks.
|
