User Guide › Dashboard › Dashboard Refresh

Dashboard Refresh

The Dashboard is equipped with two types of refresh mechanisms:

Automatic

The auto refresh operation is used for refreshing the dashboard entities every X period of time. The auto refresh only refreshes the current page the user is working on (i.e., if there is more than one page in the workspace, the auto refresh mechanism refreshes the tab the user is working on now and performs the refresh for other tabs as the user switches to them). The automatic refresh mechanism does not initiate a full recalculation, but just collects the last available calculated results. The auto refresh parameters are configurable under Administration, Site Settings, Advanced, Dashboard, Client updates intervals.

For example, the workspace contains three tabs (tab0, tab1, tab2). X is the auto refresh delay time and tab0 is the start tab. When the workspace is loaded, the auto refresh interval starts for tab0 (i.e., the tab is refreshed every X period of time). If the user stays only in tab0, only this tab is refreshed. If the user clicks on tab1 or tab2 for the first time, the tab data is loaded for the first time. After the tab is loaded, the auto refresh interval is reset and a new interval is set for tab1 or tab2 with X delay time (i.e. the tab is refreshed every X period of time). While in tab1 or tab2, tab0 is not refreshed. If the user clicks on tab0 again, a check is performed to see when this tab was last refreshed.

• If the time span between the last refresh time of the tab and now is greater or equal to X (i.e., the tab should be auto refreshed), the tab is auto refreshed and a new auto refresh interval is set for the current tab (i.e., the tab is refreshed every X period of time).
• If the time span between the last refresh time of the tab and now is lower than X (i.e., the tab should not be refreshed now, but in Y period of time, which equals, the last refresh time + the current time). The old interval is cleared and a new interval with the Y delay time is set. Tab0 is refreshed in Y delay time, and afterwards the old interval is cleared and a new interval is set with X delay time (the original delay time).

Manual

The manual refresh operation is performed on each element in the Dashboard (i.e., page, dashview or widget). When the user manually refreshes the current page, the last refreshed time is updated to be now. The next interval of the auto refresh is set to X delay time from now (i.e. the manual refresh can affect the auto refresh). The manual refresh mechanism does not initiate a full recalculation, but just collects the last available calculated results.