Locate Expression (Magic xpa 3.x)
A Locate Expression is used to position the data view to start from a specific row when a task starts running. When a task begins, Magic xpa scans the data view from the beginning until the Locate Expression evaluates to True for a row. That row is fetched and the cursor is positioned on it. The end user can move backward or forward within the data view using the direction keys.
The Locate Expression property is relevant for Online tasks only.
The Locate Expression property should be used in cases where the locate condition is not based on a single contiguous range, or when the search criteria are complex. Otherwise, you can use the variable's Locate Lower/ Upper limit expressions, which will run faster.
All variables included in the Locate Expression are evaluated at the task’s initialization; therefore they may contain only property variables or variables of ancestor tasks.
If a Locate Expression is not specified, the cursor is positioned on the first data view row fetched.
If the starting row cannot be found when an Online task starts execution, an appropriate warning message is displayed and the cursor is positioned on the first row of the data view or on the next closest value, if one exists.
