Element Details: Refresh+Series+Timer
 Back


Available in: Logi Info Source code name: RefreshSeriesTimerIntroduced in: 12.0.036

RefreshSeriesTimer updates charts automatically based on a time interval. When the interval is reached, a request is made back to the server to get updated data. Charts are updated with a smooth animation.

Charts may be refreshed in two ways. Either all the data is refreshed each time, or the chart data automatically slides to the left over time.

When the ChartXAxis element has AxisType="DateTimeLinear", newer values are added to the right side, previous values slide to the left, and old values fall out. Use the TimeSpan attribute to specify the age of data included.

When the TimeSpan attribute is set, the chart’s DataLayer may use a special @Chart token suitable for retrieving just the rows necessary to update the chart. On the initial chart request, @Chart.rdTimeSpanStart~ returns the current time minus the time span. But for subsequent refreshes, when AxisType="DateTimeLinear" and the x-axis will be sliding, @Chartt.rdTimeSpanStart~ returns the last time the chart was updated, so only the newest rows are retrieved. SQL Server example:

SELECT * FROM MyTable WHERE UpdateTime BETWEEN '@Chart.rdTimeSpanStart~' AND '@Function.DateTime~'.

The timer's interval is set in seconds. Be careful with setting a fast refresh rate if a very large number of users may display the report.



ATTRIBUTES

Click attribute Name to drill down for more information.

NamePossible ValuesDescription
RefreshInterval
UserDefined
(Required) The number of seconds to wait before refreshing elements specified in the RefreshElementTimer element. When used for the Real Time Update element, this will be the number of seconds to wait before refreshing the parent chart data. The value must be an integer greater than 0.
TimeSpan
UserDefined
A time span value, which must be in the format "hh:mm:ss". For example "00:02:00" represents two minutes.



PARENT ELEMENTS

Click element to drill down for more information.

Gauge.Arc
Gauge.Balloon Bar
Gauge.Bullet Bar
Gauge.Number
Series.Area
Series.Area Range
Series.Area Spline
Series.Area Spline Range
Series.Bar
Series.Bar Range
Series.Box Plot
Series.Bubble
Series.Funnel
Series.Heatmap
Series.Line
Series.Pie
Series.Pyramid
Series.Scatter
Series.Spline
Series.Waterfall
Series.Whiskers


CHILD ELEMENTS

Click element to drill down for more information.



 Back to top


 Chart Debug