Guide Section: Processing Events and Performing Actions | EASAP Tree: EVENT PROCESSING Branch

SET VALUE ACTION sets the value of user interface data entry objects, such as REALBOX, CHOICE LIST, TEXTBOX and FILE CHOICE.

The optional Value: parameter should be set to the desired value of the user interface object and it must correspond to the syntax of the target object’s Default: parameter. For instance, if a REALBOX is referenced, the value could be ‘10, m’. Leaving the Value: parameter unset will cause the action to clear the target object’s value, providing the target object allows no value.

The Fire Value Changed: parameter of SET VALUE ACTION can be used to force the EASAP to update all object data values after SET VALUE ACTION has been executed. The rules of use for the Fire Value Changed: parameter are as follows:

• When only one SET VALUE ACTION is present on the ACTION branch, setting the Fire Value Changed: parameter to ‘TRUE’ may not be required unless the UI is not updating as you would expect. In this case, the Fire Value Changed: parameter to ‘TRUE’ and try again.

• If using more than one SET VALUE ACTION in series, set the Fire Value Changed: parameter of the last object to ‘TRUE’ and all previous ones to ‘FALSE’.

Note: This parameter should be used with caution as it introduces the potential for loops.

If you stick to these rules of usage you will get the most efficient EASAP user interface. Do not always set Fire Value Changed: parameter to ‘TRUE’ for instance, as this will considerably slow the interface.

SET VALUE ACTION
Essential Parameters:
Object:	Select target object for which the ACTION will set the value
Optional Parameters:
Value:	Value to set for target object, DOR allowed, but not expression
Do if:	Logical expression, if TRUE then ACTION performed, if FALSE then ACTION NOT performed.
Delimiter:	Character to act as delimiter in DORs in Value: parameter. default→ %
Fire Value Changed:	Select whether all EASAP object values should be updated after action completes (default→FALSE, TRUE)