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

SET VALUE ACTION sets the value of user interface data entry objects such as,

• REALBOX
• CHOICE LIST
• TEXTBOX
• 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:

• For a single SET VALUE ACTION in an ACTION GROUP,
  • Setting Fire Value Changed:→ TRUE typically is not required.
  • If the UI is not updating, set:
    • Fire Value Changed: TRUE
    • Check to see the VALUE CHANGED EVENT propagates
• For a sequence of SET VALUE ACTION's in an ACTION GROUP,
  • Set the last Fire Value Changed: TRUE
  • Set all other Fire Value Changed: FALSE

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

These above use creates the most efficient EASAP user interface. (ie. Setting each Fire Value Changed:→TRUE may needlessly 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 delimit object references in Value: (default→ %)
Fire Value Changed:	Select whether all an EASAP's object values should be updated after action completes (default→FALSE, TRUE)