Specifying the refresh behavior of reports in Application Studio WebServices

Actions executed in a report cause the entire report to refresh when it is viewed in Application Studio WebServices. This can reduce performance if the report is large, and can cause the display to flicker, which users can find inconvenient. To reduce these problems you can specify that all, some or only one of the cells are refreshed when a Select Element or Set Parameters action is executed.

You specify the refresh behavior with an optional input in the definition of a Select Element or Set Parameters action.

Note: Specifying the refresh behavior has risks associated with it.

See Risks, limitations and known issues.

To specify the refresh behavior of a report in Application Studio WebServices:

Create a Select Element or Set Parameters action.
See Defining actions.
In the Inputs section of the action, double-click <New Input>.
A list is enabled.
Select Optional Inputs > Refresh.
The Value field is enabled.
In the Value field, select a refresh option. You can specify these refresh options:
- Whole report: The whole report is refreshed in Application Studio WebServices when a Select Element or Set Parameters action is executed. The effect of this is the same as if you do not specify a refresh option. Use it if you have specified a refresh option but need to change it for testing, for example.
- Single cell: Only the cell which contains the action is refreshed
- Range: A range of cells is refreshed. A range can be a single cell, outside the cell which contains the action.
- None: The action is executed, but no cells are refreshed. Use this option if, for example, there are multiple combo boxes in a report and the report should not refresh until a user has made a selection from all of them. Specify Refresh:None on all combo boxes except the last.
The default value of the input is Whole Report. Do not change this value unless you understand the risks associated with changing the default refresh behavior of reports in Application Studio WebServices.