jsreport second major release is now live. This release includes new features as well as breaking changes that accumulated over the last two years.
You can install jsreport v2 by following the common steps on download page.
To migrate existing v1 instance to v2 please follow the migration guide.
See now the v2 highlights.
The biggest change is replacement of phantomjs recipes with chrome based recipes in default jsreport installation. The phantomjs project is currently suspended and chrome-pdf recipe has better support for modern technologies so it is clear winner at this moment.
The v2 default installation includes several new extensions improving productivity.
version-control - version changes in templates and use commands like "commit" or "checkout" right from the studio
pdf-utils - join multiple pdfs, merge dynamic headers or watermark
freeze - avoid accidental changes in production templates
The fs-store was re-implemented from the ground up to support running in cluster. Multiple instances can now share the same file system. Another improvement is also support for Azure Blob Storage and AWS S3 drivers.
The custom scripts can now return promise and query jsreport document store. This makes it easy to load a custom configuration for example.
const jsreport = require('jsreport-proxy')
async function beforeRender(req, res) {
const assets = await jsreport.documentStore.collection('assets').find({name: 'myConfig'})
const config = JSON.parse(assets[0].content.toString())
req.data.config = config
}
The reports rendered through link propagates the query string parameters to the rendering pipeline https://jsreport.org/templates/Byz1CG_Kl?paramA=foo
function beforeRender(req, res) {
const paramA= req.context.http.query.paramA
req.data.paramA = paramA
}
We have renamed or changed several properties in the jsreport configuration to make it more readable. The connectionString was for example renamed to store or tasks to templatingEngines. The extensions configuration is now also nested into extensions node. See the migration guide for the full list of changes and utility to automate existing config update.
The configuration additionally supports global property allowLocalFilesAccess which is handy shortcut that lets scripts or helpers require custom node modules and assets to read local files.
{
"httpPort": 5488,
"allowLocalFilesAccess": true,
"store": {
"provider": "fs"
},
"templatingEngines": {
"timeout": 10000
}
"extensions": {
"scripts": {
"timeout": 30000
}
}
}
The configuration is in v2 also validated against schema which can be printed using
jsreport help config
We hope you like this release. As always, please use our forum in case of questions or problems.