Skip to content

Exports JSON data to Excel along with Styles, Formatting and Formulas

License

Notifications You must be signed in to change notification settings

hansiemithun/json2xl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Exports JSON data to Excel along with Styles, Formatting and Formulas

This Library depends on [excel4node](https://www.npmjs.com/package/excel4node)
npm install json2xl
A app.js script is provided in the code. Running this will output a message as : "Successfully Excel file generated in path - uploads/1443512953422.xlsx" where the filename is Current Unix Timestamp which can be changed accordingly
node app.js
I am using [rekuire](https://www.npmjs.com/package/rekuire) npm package instead of [require](https://www.npmjs.com/package/require) just to not mess up with paths and its configuration. So dont get confuse
global.rekuire = require("rekuire");
var express = rekuire("express");
var app 	= express();
var json2xl = rekuire('json2xl');
var port    = 8000; 

app.use(express.static(__dirname + '/public'));

app.listen(port, function(err, res){
    if(err){
        throw err;
    }
    else{
        port = process.env.port || port;
        console.log("application running in port " + port);     
    }
});

app.get('/json2xl', function (req, res) {
      var filepath = "uploads/"
      var fileName = Date.now() + '.xlsx';
      
      var wbOpts = {
            jszip:{
                compression:'DEFLATE'
            }
        };

      var wsOpts = {
            margins:{
                left : .75,
                right : .75,
                top : 1.0,
                bottom : 1.0,
                footer : .5,
                header : .5
            },
            printOptions:{
                centerHorizontal : true,
                centerVertical : false
            },
            view:{
                zoom : 100
            },
            outline:{
                summaryBelow : true
            },
            fitToPage:{
                fitToHeight: 100,
                orientation: 'landscape',
          },
        }

      var data = {
              "worksheets" : ['Page-1'],                 
              "filepath": filepath,
              "filename": fileName,                  
                "rows" : [
                             [
                                {   
                                    "value" : "Row-1-Col-1",
                                    "dataType": "string",
                                    "style":[{
                                        "color" : "red",
                                        "backgroundColor" : "green",
                                        "border" : ["thick", "black"]
                                    }]                                       
                                },
                                {   
                                    "value" : "2", 
                                    "dataType": "number",
                                    "style":[{
                                        "color" : "green",
                                        "backgroundColor" : "brown",
                                        "border" : ["thick","blue"]
                                    }]
                                },
                                {   
                                    "value" : "3", 
                                    "dataType": "number",
                                    "style":[{
                                        "color" : "green",
                                        "backgroundColor" : "red"
                                    }]
                                },
                                {   
                                    "value" : 'B1+C1', 
                                    "dataType": "Formula",
                                    "style":[{
                                        "color" : "green",
                                        "backgroundColor" : "red"
                                    }]
                                },
                                {   
                                    "value" : "2015-03-25", 
                                    "dataType": "date",
                                    "style":[{
                                        "color" : "#E6E6E6",
                                        "fontSize" : "58px",
                                        "backgroundColor" : "black"
                                    }]
                                },
                            ],
                            [
                                {   
                                    "value" : "Row-2-Col-1",
                                    "dataType": "string",
                                    "style":[{
                                        "color" : "red"    
                                    }]
                                },
                                {   
                                    "value" : "2", 
                                    "dataType": "number",
                                    "style":[{
                                        "color" : "green",
                                        "backgroundColor" : "red"                                            
                                    }]
                                },
                                {   
                                    "value" : "3", 
                                    "dataType": "number",
                                    "style":[{
                                        "color" : "green",
                                        "backgroundColor" : "red"
                                    }]
                                },
                                {   
                                    "value" : 'B2+C2', 
                                    "dataType": "Formula",
                                    "style":[{
                                        "color" : "green",
                                        "backgroundColor" : "red"
                                    }]
                                },
                                {   
                                   "value" : ["https://www.google.co.in/", "Google"], 
                                    "dataType": "link",
                                    "style":[{
                                        "color" : "#E6E6E6",
                                        "fontSize" : "58px",
                                        "backgroundColor" : "black"
                                    }]
                                },
                            ],
                       ],                    
              "config" : { 
                    "wbOpts" : wbOpts,
                    "wsOpts" : wsOpts,
                    "freezePanes" : {
                        "rows" : [1],
                        "cols" : [3]
                    }
                }
       };

       json2xl.Json2XL(data, function(err, response){
            res.end(response);
       });    
});

** 1. String ** ** 2. Number ** ** 3. Formula ** Ex: "value" : 'B2+C2' // String You can apply any excel formula to the value, this later gets converted to the appropriate value.
** 4. Link ** Ex: "value" : ["https://www.google.co.in/", "Google"] || ["https://www.google.co.in/"] // Array You can send link with title as the second param or just link in the array ** 5. Date **

All the datatypes are optional. If nothing is defined "String" dataType is considered

1. Color
2. BackgroundColor
3. FontSize

"color" & "backgroundColor" can be either in hexadecimal or color names : #F00 or Red "fontSize" should be in pixels : 11px

 1. Pattern: "Solid"
 2. Color: "#000" or "Black"
 3. BackgroundColor: none;
 4. FontSize: 10px 
 5. FontFamily: "Arial" 
 6. FontWeight: "Normal"
 7. Border: "none" 
    Ex: "border" : ["thin", "black"]
        i. thick or thin // Thin is preferred
        ii. border color

### Configurations "config" : { "wbOpts" : wbOpts, "wsOpts" : wsOpts, "freezePanes" : { "rows" : [1], "cols" : [3] } }

  	 var wbOpts = {
        jszip:{
            compression:'DEFLATE'
        }
     };
     This enables deflate compression mode for excel as provided by excel4node 	              package. 
   		var wsOpts = {
          margins:{
              left : .75,
              right : .75,
              top : 1.0,
              bottom : 1.0,
              footer : .5,
              header : .5
          },
          printOptions:{
              centerHorizontal : true,
              centerVertical : false
          },
          view:{
              zoom : 100
          },
          outline:{
              summaryBelow : true
          },
          fitToPage:{
              fitToHeight: 100,
              orientation: 'landscape',
        }
      }

Worksheet settings such as print, outlines and margins, etc. You can refer the excel4node doc for more information.

	"freezePanes" : {
        "rows" : [1], // Array of rows
        "cols" : [3] // Array of columns
    }

The above code freezes row:1 and column: 3

"worksheets" : ['Test'],  
"filepath": "/exceluploads/", 
"filename": 'default_template_' + Date.now() + '.xlsx';
"rows": [['Row1_Col1','Row1_Col2',"Row1_Col3"]]    

**Worksheet: ** Is an array of arguments, but at present it supports only 1 worksheet

**Filepath: ** By default it gets stored in /exceluploads/ directory which is relative path to the project folder. Even if it doesnt exist. It creates, if it fails, please check with project folder permissions

**Filename: ** By default it creates file with 'default_template_'+Date.now()+'.xlsx'

**Rows: ** By default it creates single row with 3 column values

app.get('/json2xlmin', function (req, res) {
	var data = {};
    
	json2xl.Json2XL(data, function(err, response){
            res.end(response);
    });
});

Output

	{
     "status":"success",
     "file":"./exceluploads/default_template_1443873516091.xlsx"
     }

About

Exports JSON data to Excel along with Styles, Formatting and Formulas

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published