Sane Reports by Demisto

Reports library that will keep you sane and not pulling your hair out

Quick start

$ npm install sane-reports
$ cd sane-reports
$ phantomjs reportsServer.js templates/test.json dist/test.pdf

Report will be generated in: dist/test.pdf

Generating dashboard mode (browser) report

$ git clone git@github.com:demisto/sane-reports.git
$ cd sane-reports
$ npm install
$ npm start

Now open browser at: http://localhost:8082

Generating PDF report

$ git clone git@github.com:demisto/sane-reports.git
$ cd sane-reports
$ npm install
$ npm run production
$ npm run generate-report

This will generate a PDF report in the dist folder. The name of the report will start with report-.

Generate report options:

You can create PDF report with the following command as well:

phantomjs reportServer.js <report_template_file> [<output_file> <dist_folder> <orientation> <resourceTimeout> <type> <headerLeftImage> <headerRightImage>]

• report_template_file: The template of the report (JSON format)
• output_file: The name of the generated report (leave empty for default name)
• dist_folder: should be dist
• orientation: The orientation of the report: portrait/landscape (default portrait)
• resourceTimeout: Timeout for generating the report (default is 4000ms)
• type: The report type: pdf or csv (default is pdf)
• headerLeftImage: The image to show at the left side of the report header of each page (base64 or url)
• headerRightImage: The image to show at the right side of the report header of each page (base64 or url)

PDF Example:

phantomjs reportsServer.js templates/test.json dist/test.pdf dist portrait 4000 pdf

CSV Example:

phantomjs reportsServer.js templates/testCSV.json dist/test.csv dist portrait 4000 csv

Demo

Reports templates (JSON) examples can be found in the templates folder.

Example reports outputs can be found in the examples folder.

Create your own report template

You can edit existing report templates or create your own template. Report templates are created in JSON format and includes sections. Sections are ordered according to their row and column positions.

Section types: Header, Divider, Date, Image, JSON, Markdown, Table, Text, Bar Chart, Line Chart, Pie Chart

Each section can have its own style (camled case css style: font-size -> fontSize).

License

demisto/sane-reports is licensed under the Apache License 2.0