nreports

0.28.0 • Public • Published

NReports

NPM

A simple nodejs reporting framework that leverages template runtimes for report generation.

Features

  • Template Runtimes
    • Jade
    • Handlebars
  • Datasources
    • LiveJSON - JSON data embedded in the datasource
    • WebJSON - JSON data provided by a RESTful web service
  • Parameters

Limitations

Currently the framework is only designed to work with JSON data and supports Jade or Handlebars templates.

Sample Overview

The sample illustrates using the NReports reporting engine to build a report using the a handlebars template.

Sample LiveJson datasource

var NReports = require('nreports');
 
var params = [
    new ReportParameter("postalcode", "string", "6600"),
    new ReportParameter("country", "string", "AT"),
    new ReportParameter("username", "string", "demo")
];
 
var json = {
    "postalcodes":[
        {"adminCode3":"70805","adminName2":"Politischer Bezirk Reutte","adminName3":"Breitenwang","adminCode2":"708","postalcode":"6600","adminCode1":"07","countryCode":"AT","lng":10.7333333,"placeName":"Breitenwang","lat":47.4833333,"adminName1":"Tirol"},
        {"adminCode3":"70806","adminName2":"Politischer Bezirk Reutte","adminName3":"Ehenbichl","adminCode2":"708","postalcode":"6600","adminCode1":"07","countryCode":"AT","lng":10.7,"placeName":"Ehenbichl","lat":47.4666667,"adminName1":"Tirol"},
        {"adminCode3":"70820","adminName2":"Politischer Bezirk Reutte","adminName3":"Lechaschau","adminCode2":"708","postalcode":"6600","adminCode1":"07","countryCode":"AT","lng":10.7,"placeName":"Lechaschau","lat":47.4833333,"adminName1":"Tirol"}
        ]
};
 
var ds = new NReports.LiveJsonDatasource(params, json);
 

Sample Template

var NReports = require('nreports');
 
var template = '<h1>Sample Report</h1><ul>{{#each postalcodes}}<li>{{placeName}}</li>{{/each}}</ul><h3>Report Footer here...</h3>';
 

Rendering the report

var NReports = require('nreports');
 
 
var rpt = 
    new Report("sample")
        .addParameter("postalcode", "string", "6600")
        .addParameter("country", "string", "AT")
        .addParameter("username", "string", "demo")
        .setTemplate(template); // given the sample template above
 
var ds = new NReports.LiveJsonDatasource(rpt.parameters, json); // given the JSON from the sample datasource above
 
var engine = new NReports.ReportEngine();
 
engine.setRuntime(new NReports.HandleBarsRuntime());
 
engine.render(rpt, ds, function(err, html){
 
    if (err) console.error(err);
 
    console.log(html);
});
 

Dependencies (8)

Dev Dependencies (2)

Package Sidebar

Install

npm i nreports

Weekly Downloads

0

Version

0.28.0

License

none

Last publish

Collaborators

  • phil.a.taylor