Niagara Simple Line Chart


Overview


Drag and drop the Simple Line Chart widget from the palette onto your px view. It automatically updates when the history value changes. Its completely configurable and easy to use. Also check out the Energy View Template.

Usage


1. Copy the simpleLineChart-ux.jar file to your modules directory.
2. Open the module from your palette file.
3. Drag and drop the widget from the palette onto your px view.

Drag n' Drop Widget'

Widget Properties

Properties


The chart has a number of configurable properties that can be used to modify look, feel, and functionality. Change the properties as required.

Changing Widget Properties - most properties are self-explanatory but some require some explaining.

Ord Value - this is the live value of the meter or the main meter value. The ord reference should be a numeric point or numeric writable. It can an absolute ord, e.g.
station:|slot:/Drivers/NiagaraNetwork/AHU5 or relativized ORD e.g.
slot:AHU5
The ord should point to a numeric point/writable that has a numeric interval extension.
OR
You can reference a history ord directly e.g.
history:/demoStation/AHU5

Date Format.

Examples:

  • dddd h:mmtt d MMM yyyy = Friday 9:49am 19 Jan 2018
  • M/d/y = 1/19/2018
  • HH:mm:ss = 09:49:29
  • hh:mm:ss TT = 09:49:39 AM
  • yy/M/d = 18/1/19
  • ddd MMM d \a\t h:mm TT = Fri Jan 19 at 9:49 AM


History BQL.

You must bind the chart to a history bql query.
1. Set the value binding to a actual point.
Example: station:|slot:/Drivers/NiagaraNetwork/AHU1

2. Set the history BQL property.
Example 1: |bql:select timestamp,value as 'Kw' order by timestamp DESC
Example 2: ?period=weekToDate|bql:select timestamp, value order by timestamp DESC

Using in your HTML Page


You can now use the widget in your custom html page as long as the html file is in a appropriate station directory.
E.g. C:/../../webfiles/demo1.html

1. Create an html page and place in your station files directory.
2. Create a div element and give it an id so you can inject the widget into this area. E.g.: widget1.
3. Add the following scripts before the closing head tag or the closing body tag. E.g.:


<script type="text/javascript">

var require = {
    paths: {
        "nmodule": "/module",
        "baja": "/module/bajaScript/rc/plugin/baja",
        "bajaScript": "/module/bajaScript/rc",
        "bajaux": "/module/bajaux/rc",
        "lex": "/module/js/rc/lex/lexplugin",
        "css": "/module/js/com/tridium/js/ext/require/css",

        "jquery": "/module/js/rc/jquery/jquery-2.1.1",  // For N4.4 or higher use /module/js/rc/jquery/jquery-3.2.0.min
        "Promise": "/module/js/rc/bluebird/bluebird",

        // these are runtime dependencies
        "hbs": "/module/js/rc/require-handlebars-plugin/hbs", // For N4.4 or higher use /module/js/rc/handlebars/handlebars.min-v4.0.6
        "i18nprecompile": "/module/js/rc/require-handlebars-plugin/hbs/i18nprecompile",
        "json2": "/module/js/rc/require-handlebars-plugin/hbs/json2",
        "underscore": "/module/js/rc/underscore/underscore",
    },

    hbs: {
        disableI18n: true
    }
}
</script>
<script type="text/javascript" src="/module/js/com/tridium/js/ext/require/require.min.js"></script>
<script>
    require(['/module/simpleLineChart/rc/simpleLineChartWidget.run.js'], function (app) {

        app.initialiseSimpleChart({
            backgroundColor: '#3D3D3D',
            borderColor: '#727272',
            borderThickness: 4,
            dateFormat: 'd/M/yy',
            divId: '#widget1',
            historyBql: "|bql:select timestamp,value as 'Kw' order by timestamp DESC",
            legendLocation: '100,120',
            limit: 10,
            lineColor: '#1f77b4',
            offset: 0,
            ord: 'station:|slot:/Drivers/NiagaraNetwork/AHU2', // use absolute ord
            padding: '60,80,60,80',
            titleFontColor: '#fff',
            titleFontSize: '16px',
            titleFontWeight: 'bold',
            titleXOffset: 50,
            titleYOffset: 40,
            title: 'Chart 1',
        });
    });
</script>
</head>  
<!--Rest of your html below...-->
                                

4. Change the configuration values as required.


Add your own CSS file:

1. Using the demo1.html file created above, you can also use your own css for further customisation. Add the following before the closing head section to bring in your css (Note: the following href points to the default css file):


<link rel="stylesheet" href="/module/simpleLineChart/rc/simpleLineChartWidget.css" type="text/css" />

                                

2. The default CSS file is as follows. Modify as needed:

 
    .demo1 {
        position: relative;
        width: 100%;
        height: 100%;
        box-sizing: border-box;
        float: left;
    }

    .bajaux-widget-max {
        background-color: white;
        overflow: hidden;
        height: 300px;
        width: 300px;
        display: inline-block;
    }

    .bajaux-max {
        overflow: hidden;
        height: 100%;
        width: 100%;
        display: inline-block;
    }

    .SimpleLineChartWidgetOuter {
        overflow: hidden;
        height: 100%;
    }

    .bajaux-widget-outer {
        overflow: hidden;
        height: 100%;
    }

    .bajaux-widget-outer > div.SimpleLineChartWidgetOuter.bajaux-widget {
        overflow: hidden;
        height: 100%;
    }

    .SimpleLineChartWidget .title text, .SimpleLineChartWidget .valueText text {
        font-size: 16px;
        font-weight: 100;
    }

    .SimpleLineChartWidget .label text {
        font-size: 13px;
    }


                              

Licensing


Widgets and drivers must be licensed with us. Licenses are bound to the stations host Id. You will be provided access to the Software and Licensing Portal where you can manage your own licenses. Here you can add, update, or delete licenses as needed.

There are few ways to get a license file:

1. Add our licensing module to your station services. This module automatically retrieves the license from our servers and saves it to your stations shared folder directory.

2. Alternatively, Login to the Software and Licensing Portal (link provided in Order Confirmation) and add your host id's as needed. Copy the license file to the stations shared directory.

Finally, make sure the station user has access to WLicenseService in the user management and category service section.

Niagara Licensing

Niagara Dashboard


Niagara IOT technologies and modern toolsets allow you to build a powerful Niagara dashboard which is real time, data-driven, and cost effective. Our widgets are purpose-built by providing information with faster communication through real-time, data-driven, dashboards for web, desktop and mobile devices. You can now create a cutting-edge display of conventional HVAC system graphics, Dashboards, Alarms & Scheduling, Historical Data, and Analytics.

You May Also Like

Multiline Chart

Totals Chart

Energy Benchmark Chart


back to more widgets...