TrendWorX64 Runtime Toolbar

You can customize the display of a TrendWorX64 Viewer control within PortalWorX-SL using the runtime toolbar, which is illustrated below. You can access this toolbar by double-clicking within a chart that shows trending data.

The Runtime Toolbar as it Appears within the TrendWorX64 Silverlight Web Part

The options that you can access on runtime toolbar appear in the table below:

Button Image	Button Name	Button Action
	Edit Trend Period and Rates	Opens the Edit Trend Period and Rates configurator, which allows you to adjust the time format and interval for the chart as well as the frequencies for collecting and displaying data.
	Show/Hide Axes	Displays or hides the axes along the sides of the trend display.
	Swap Y/X Axes	Inverts the axes on the trend display (if the data values appeared on the y-axis originally, they would now appear on the x-axis).
	Enter/Exit Zoom Mode	Activates or deactivates Zoom Mode, which allows you to zoom in on a particular region of the trend display.
	Freeze/Unfreeze Trend	Activates or deactivates Freeze Mode, which causes the trend display to stop refreshing.
	Previous Trend Page/Next Trend Page	Move either back or forward in time on the trend display at an interval equal to the current trend period. This pair of buttons is visible only in Freeze Mode.
	Set Right Time	Opens the Navigate trend configurator, which allows you to set a time and date for each side of the trend display. This button is active only in Freeze Mode.
	Show/Hide Legend	Displays or hides the legend that appears underneath the trend display.
	Show/Hide operator comments	Displays or hides operator comments within the trend display. This option is meaningful only if you have enabled operator comments for the data being displayed.
	Refresh Data	Forces the trend display to re-draw the collected data.
	Show/hide the Side Panel	Displays or hides a side panel to the right of the trend display.

Edit Trend Period and Rates

The Edit Trend Period and Rates configurator allows you to adjust the trend interval and presentation as well as the data collection and display refresh rates. You can open the configurator by clicking the Edit Trend Period and Rates button on the Runtime toolbar.

You can adjust the following options in the configurator:

Trend Period: Specify the interval of time between the left and right edges of the trend display. Enter a period of time in the form dd.hh:mm:ss, where dd = days, hh = hours, mm = minutes, and ss = seconds.
Summary Trend Period: Specify the interval of time between the left and right edges of the summary pane display. Enter a period of time in the form dd.hh:mm:ss, where dd = days, hh = hours, mm = minutes, and ss = seconds.
Use UTC time stamps: Enable this check box to display all time stamps in Coordinated Universal Time (UTC). This time is not affected by Daylight Saving Time.

Note: All historical clients and reporting tools will always retrieve historical data in their local (non-UTC) time.

Time Format: Select a format for displaying times along one of the axes of the chart. You can choose from the following formats (where H or HH is the hour of the day between 0 and 23, h or hh is the hour of the day between 1 and 12, mm is the minute, ss is the second, and tt is either AM or PM):
- NO TIME (time will not appear on the chart)
- Short time (which is h:mm tt, for example: 1:30 PM)
- Long time (default) (which is h:mm:ss tt, for example: 1:30:05 PM)
- h:mm tt (example: 1:30 PM)
- hh:mm tt (example: 12:30 AM)
- H:mm (example: 13:30)
- HH:mm (example: 00:30)
- h:mm:ss tt (example: 1:30:05 PM)
- hh:mm:ss tt (example: 12:30:45 AM)
- H:mm:ss (example: 13:30:05)
- HH:mm:ss (example: 00:30:45)
Date Format: Select a format for displaying dates along one of the axes of the chart. You can choose from the following formats (where M or MM is the numerical month, MMMM is the name of the month, MMM is the name of the month abbreviated, dddd is the name of the day of the week, d or dd is the numerical day of the month, and yy or yyyy is the year):
- NO DATE (default) (date will not appear on the chart)
- Short date (which is M/d/yyyy, for example: 6/1/2012)
- Long date (which is dddd, MMMM dd, yyyy, for example: Friday, June 01, 2012)
- M/d/yyyy (example: 6/1/2012)
- M/d/yy (example: 6/1/12)
- MM/dd/yy (example: 06/01/12)
- MM/dd/yyyy (example: 06/01/2012)
- yy/MM/dd (example: 12/06/01)
- yyyy-MM-dd (example: 2012-06-01)
- dd-MMM-yy (example: 01-Jun-12)
- dddd, MMMM dd, yyyy (example: Friday, June 01, 2012)
- MMMM dd, yyyy (example: June 01, 2012)
- dddd, dd MMMM, yyyy (example: Friday, 01 June, 2012)
- dd MMMM, yyyy (example: 01 June, 2012)

Note: The time axis of the chart (usually the x-axis) must show either the time or date at all times.

Data Collection rate: Specify how often the chart's pens (graphs) read data from the data source. Enter a time interval between data collections in the form hh:mm:ss.000, where hh = hours, mm = minutes, ss = seconds, and 000 = milliseconds. In most instances data is collected less frequently than it is refreshed. Data collected is stored in the data buffer and shown in Summary View.
Display Refresh rate: Specify the frequency with which the control updates the display. Enter a time interval between data refreshes in the form hh:mm:ss.000, where hh = hours, mm = minutes, ss = seconds, and 000 = milliseconds. The smaller the refresh rate, the more up-to-date the display is, but the more resources are consumed.
History Refresh rate: Specify the refresh rate for requesting historical data from the server. Enter a time interval between historical data refreshes in the form hh:mm:ss.000, where hh = hours, mm = minutes, ss = seconds, and 000 = milliseconds. Whenever possible, the control will try to use the rate that you specify. However, it will internally calculate and use a slower history refresh rate if the server is requesting too much data or if the chart is not changing frequently.

Note: To force an immediate refresh of the data whenever needed, click the Refresh Data button on the Runtime toolbar.

Click the Close button in the top-right corner of the configurator to close the window and return to the main PortalWorX-SL window.

Zoom Mode

Zoom Mode allows you to examine a particular region of the trend display more closely, perhaps to view a particularly subtle or sensitive change in the trending data. You can enter this mode by clicking the Enter/Exit Zoom Mode button on the Runtime toolbar.

Once in zoom mode, click and drag over the area of the chart that you want to appear on the display once the zoom-in process is complete. The selected region will then fill the entire display. An example of this process appears below:

Selecting a Region while in Zoom Mode

To exit Zoom Mode, click the Enter/Exit Zoom Mode button on the Runtime toolbar again, or right-click the trend display and select Reset Zoom.

Freeze Mode

To enter Freeze Mode, click the Freeze/Unfreeze Trend button on the Runtime toolbar. Freeze Mode stops the data refresh animation within the trend display. While in this mode, the TrendWorX64 Viewer control is still collecting data, but the trend display does not show this new data.

After entering Freeze Mode, you will notice that the Runtime toolbar changes slightly
. There is also a cursor that appears near the center of the trend display. You can click and drag this cursor on the chart to inspect the values of the chart's pens (graphs) at different instants of time.

To view data from a different time on the chart while in Freeze Mode, complete one of the following actions:

Click the Previous Trend Page button or the Next Trend Page button to move back or forward a length of time equal to the trend period that the chart currently shows.
Adjust the trend period in the Edit Trend Period and Rates configurator
Enter an exact time and date to appear on either side of the chart in the Navigate trend configurator

Finally, there is a summary pane that appears beneath the chart while in Freeze Mode. This pane allows you to view the trend over a larger trend period and navigate across large intervals of time quickly.

To exit Freeze Mode, click the Freeze/Unfreeze Trend button on the Runtime toolbar again.

Navigate Trends

If you would like to set a specific trend period or a specific time and date for the left and right edges of the trend display, you can use the Navigate trend configurator, which appears below. You can open the configurator by clicking the Set Right Time button on the Runtime toolbar while in Freeze Mode.

Adjusting the Time Interval on the Trend Display using the Navigate trend Configurator

You can adjust the following options in the configurator:

Trend period: Specify the interval of time between the left and right edges of the trend display. Enter a period of time in the form dd.hh:mm:ss, where dd = days, hh = hours, mm = minutes, and ss = seconds.
Start time: Enter a time and date to appear on the left edge of the trend display. Enter the date in the form M/dd/yyyy, where M = the numerical month, dd = the day of the month, and yyyy = the full year. Enter the time in the form h:mm:ss tt, where h = the hour of the day between 1 and 12, mm = the minute, ss = the second, and tt is either AM or PM.
End time: Enter a time and date to appear on the right edge of the trend display. Enter the date and time in the same form as the one for Start time.

Note: Click the Show button to force the chart to refresh the display to show the specified trend period or start and end times.

Select Days: Select a day in the calendar provided, and click one of the following buttons on the right side:
- Click the Show Day button to have the chart display data across the selected day.
- Click the Show Week button to have the chart display data across the week that includes the selected day.
- Click the Show Month button to have the chart display data across the month that includes the selected day.

Click the Close button in the top-right corner of the configurator to close the window and return to the main PortalWorX-SL window.

Summary Pane

When you enter Freeze Mode, a smaller chart called the summary pane should appear beneath the main trend display. If the summary pane does not appear when you enter Freeze Mode, click the small arrow beneath the chart on the right side of the display.

Adjusting the Height of the Summary Pane and the Trend Period Visible in the Main Trend Display

The summary pane displays trend data in a smaller graph that generally includes a larger time interval than the one in the main trend display. The portion of this time interval that appears in the main trend display appears as a white box inside of the summary pane chart. The summary pane is useful for navigating across large periods of time quickly, allowing you to view trend data at a significantly different time interval than the one that currently appears in the main trend display.

When you move the cursor into the summary pane, handles will appear on either side of the white box inside of the pane, as shown in the figure above. You can click and drag these handles to adjust the trend period that appears in the main trend display.

You can also adjust the height of the summary pane itself by clicking and dragging the handle in top-center of the pane, as shown in the figure above.

To hide the summary pane, either click the small arrow in the bottom-right corner of the pane, or click the Freeze/Unfreeze Trend button on the Runtime toolbar to exit Freeze Mode.