History Chart view

The History Chart view uses one or more of the controls and options described in this topic.

Figure 1. History Chart view controls and options


To view a history chart, expand Station > History, right-click the chart name and click Views > History Chart.

  • The Live Updates icon () starts on-demand history plotting. The icon changes to a pause icon while live history plotting is active.

  • The Delta icon () configures the chart to display value changes (delta).

  • The Time Range drop-down list Time range option list has a variety of predefined time range options, including an option to restrict your data presentation to a particular date and time range that you specify.

  • The from and to dates display to the right of the drop-down list.

  • The clock icon () opens an Edit Time Range window for editing the End Time.

  • The chart title displays the name of the chart and identifies the point. You edit this name in the Chart Builder view.

  • The Y axis (vertical axis) displays units.

  • The X axis (horizontal axis) displays time

  • Charted values display in the body of the chart You can edit the color and type of line in the Chart Builder view.

  • When you hover the mouse pointer over a point in the history chart, a tool tip displays the date, time, and value of that location in the chart. The values are defined by chart axes and not the values of the actual data points.

Export options

Right-clicking on the History Chart invokes a short menu with two options: Export Data and Export View. Both open an Export window. The difference between the windows is in the Select Exporter drop-down list.

Clicking Export Data opens the Export window with table export options.

Action tab

Figure 2. Export Data options


Export Data exports the table to an oBIX, PDF, HTML, Text, or CSV (comma separated variable) file.

Note: This export function works only with charts configured with a single history. Multiple histories do not export to table-type data in a usable format.

Clicking Export View opens the Export window with chart export options.

Figure 3. Export view options


Export View exports the chart view to an oBIX, PDF, Text, HTML, or CSV (comma separated variable) file.

Setup tab

As of Niagara 4.14, on the Setup tab, you can specify the export Time Range and Delta mode to use for the export of history data to the following outputs:

  • History to Table Pdf

  • History to Chart Pdf

  • History to CSV

  • History to Html

  • History to Text

When you export the data while viewing a history, the Time Range and Delta export settings are pre-filled to match the settings configured in the history view (if applicable). You have the option to change the settings before continuing with the export.
Figure 4. Example of “History to Text” setup in Workbench view


Figure 5. Example of “History to Text” setup in browser view


The Include Non Default Query Params In Header property (defaults to true) applies only to the following exports:

  • History to CSV

  • History to Html

  • History to Text

It decides whether the exported file should include any non-default time range or delta indications in the header of the exported data.
Even with Include Non Default Query Params In Header set to true, if the Time Range is set to default, it will not be included, and if Delta is set to false, it will not be included in the header. For the History to Html export, the indication is included in the title instead of the header. You can hover over the browser tab to see it in the title.
Note: The Include Non Default Query Params In Header property does not apply to the PDF exports since it automatically decides when to include the extra information in the header and when not. When Delta is set to true and the header is expected, you will see "Delta Values Displayed" in the exported data header/title.