Export related data as CSV

This example shows you how to create a Smart Action "Export orders as CSV" that allows a user to download all the orders associated to a customer.
Requirements
The json2CSV npm package
1
$ npm install json2csv
Copied!
How it works
Directory: /models
This directory contains:
the customers.js file where the customers model is declared.
the orders.js file where the orders model is declared 
customers.js
1
module.exports = (sequelize, DataTypes) => {
2
  const { Sequelize } = sequelize;
3
  const Customers = sequelize.define('customers', {
4
    firstname: {
5
      type: DataTypes.STRING,
6
    },
7
    lastname: {
8
      type: DataTypes.STRING,
9
    },
10
    email: {
11
      type: DataTypes.STRING,
12
    },
13
    createdAt: {
14
      type: DataTypes.DATE,
15
    },
16
    updatedAt: {
17
      type: DataTypes.DATE,
18
    },
19
  }, {
20
    tableName: 'customers',
21
    underscored: true,
22
    schema: process.env.DATABASE_SCHEMA,
23
  });
24
​
25
  Customers.associate = (models) => {
26
    Customers.hasMany(models.orders, {
27
      foreignKey: {
28
        name: 'customerIdKey',
29
        field: 'customer_id',
30
      },
31
      as: 'orders',
32
    });
33
  };
34
​
35
  return Customers;
36
};
37
​
Copied!
orders.js
1
module.exports = (sequelize, DataTypes) => {
2
  const { Sequelize } = sequelize;
3
  const Orders = sequelize.define('orders', {
4
    ref: {
5
      type: DataTypes.STRING,
6
      primaryKey: true,
7
      defaultValue: Sequelize.literal('nextval(orders_id_seq::regclass)'),
8
      allowNull: false,
9
    },
10
    shippingStatus: {
11
      type: DataTypes.ENUM(['In transit', 'Shipped', 'Being processed', 'Ready for shipping']),
12
    },
13
    createdAt: {
14
      type: DataTypes.DATE,
15
    },
16
    updatedAt: {
17
      type: DataTypes.DATE,
18
    },
19
    beingProcessedAt: {
20
      type: DataTypes.DATE,
21
    },
22
    readyForShippingAt: {
23
      type: DataTypes.DATE,
24
    },
25
    inTransitAt: {
26
      type: DataTypes.DATE,
27
    },
28
    shippedAt: {
29
      type: DataTypes.DATE,
30
    },
31
  }, {
32
    tableName: 'orders',
33
    underscored: true,
34
    schema: process.env.DATABASE_SCHEMA,
35
  });
36
​
37
  Orders.associate = (models) => {
38
    Orders.belongsTo(models.customers, {
39
      foreignKey: {
40
        name: 'customerIdKey',
41
        field: 'customer_id',
42
      },
43
      as: 'customer',
44
    });
45
  };
46
​
47
  return Orders;
48
};
49
​
Copied!
Directory: /forest
This directory contains the customers.js file where the smart action Export orders as CSV is declared. 
You need to set the attribute download as true to enable a download
customers.js
1
const { collection } = require('forest-express-sequelize');
2
​
3
collection('customers', {
4
  actions: [
5
    {
6
      name: 'Export orders as CSV',
7
      type: 'single',
8
      download: true,
9
    },
10
  ],
11
  fields: [],
12
  segments: [],
13
});
14
​
Copied!
Directory: /utils
This directory contains a csv-exporter.js file where the method to export the orders as CSV is declared.
The json2csv package allows you to format the data exported. It can be useful in particular when you have fields of the type JSON that you may want to unwind. You can take a look at the json2csv documentation here.
csv-exporter.js
1
const { parse } = require('json2csv');
2
​
3
function exportCustomerOrdersAsCSV(response, data) {
4
  // set the response header to tell the browser to expect a csv
5
  response.setHeader('Content-Type', 'text/csv');
6
  response.setHeader('Content-Disposition', `attachment; filename=cust-${data[0].customerIdKey}-orders.csv`);
7
  response.setHeader('Access-Control-Expose-Headers', 'Content-Disposition');
8
  // list the fields of the orders that you want to display as columns of the csv
9
  const fields = [
10
    'ref',
11
    'shippingStatus',
12
    'createdAt',
13
    'UpdatedAt',
14
    'beingProcessedAt',
15
    'readyForShippingAt',
16
    'inTransitAt',
17
    'shippedAt',
18
  ];
19
  // convert the array of records into a csv
20
  try {
21
    const csv = parse(data, { fields });
22
    return response.send(csv);
23
  } catch (err) {
24
    return response.status(500).json({ err });
25
  }
26
}
27
​
28
module.exports = exportCustomerOrdersAsCSV;
Copied!
​
Directory: /routes
This directory contains the customers.js file where the logic of the smart action is implemented.
customers.js
1
const express = require('express');
2
const { PermissionMiddlewareCreator } = require('forest-express-sequelize');
3
const { orders } = require('../models');
4
const exportCustomerOrdersAsCSV = require('../utils/csv-exporter');
5
​
6
​
7
const router = express.Router();
8
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('customers');
9
​
10
router.post('/actions/export-orders-as-csv', permissionMiddlewareCreator.smartAction(), async (req, res) => {
11
  // Get the current record id
12
  const recordId = req.body.data.attributes.ids[0];
13
  // get an array of records that are the orders of the customer and export them
14
  return orders.findAll({ where: { customerIdKey: recordId } })
15
    .then((data) => exportCustomerOrdersAsCSV(res, data));
16
});
17
​
18
module.exports = router;
19
​
Copied!