Update control

These settings control under which conditions the widget is updated as well as what actions to take when rendering a widget that either is invalid or whose associated query contains errors.

Update mode
Specifies whether the widget is updated automatically or only when it receives an update request.
Default
Auto
Update the widget automatically whenever the dynamic variables that it references change.
Manual
Update the widget only when it receives an update request.

Update requests are sent to widgets when a button of type submit is clicked. See Button for more information.

Hold if any variables changed
If any of the variables in this comma-separated list change, invalidate the widget and await a manual update request.
Require condition to update
When this condition is false, invalidate the widget and update when the condition becomes true.
Refresh whenever condition is true
When this condition is true, update the widget (even if nothing appears to have changed).
When invalid
Specifies the action to take when rendering an invalidated widget.
Default
Hide
The widget is not displayed.
Block
The widget appears dimmed in its previously valid state, and a message is displayed.

If a Message when invalid is specified, it is displayed over the invalidated widget; otherwise, the message "Please wait..." will be used.

Leave active
The widget is displayed in its previously valid state.
Message when invalid
The text to display over a widget that is blocked when invalid.

In following example, the query associated with the grid widget references the value from the Input Store Number field, which has changed. However, the update mode of the grid widget is set to manual, so the grid widget displays a message to let the user know that they must click the Select button for the changes to take effect.

Note: See the first Example under Button for details about this particular example.
Message when errored
The text to display over a widget if its associated query contains errors.

In following example, the query used to populate the grid widget references the value from the Input Store Number field, which is empty, so the grid widget displays an error message to let the user know that they must select a store in order for the grid to display correctly.

Note: See the second Example under Button for details about this particular example.