Upload files to AWS S3

This example shows you how to implement a smart action to upload image files to an AWS S3 bucket.

Here we have a companies model that has two fields corresponding to files stored in an AWS S3 bucket:
A certificate of incorporation
A proof of identity
We implemented a smart action to upload the files for each company. 
Requirements
An admin backend running on forest-express-sequelize
An AWS S3 bucket with access credentials
The aws-sdk npm package
The bluebird npm package
The parse-data-uri npm package
How it works
Directory: /models
This directory contains the companies.js file where the companies model is declared. 
companies.js
1
module.exports = (sequelize, DataTypes) => {
2
  const { Sequelize } = sequelize;
3
  const Companies = sequelize.define('companies', {
4
    name: {
5
      type: DataTypes.STRING,
6
    },
7
    industry: {
8
      type: DataTypes.STRING,
9
    },
10
    headquarter: {
11
      type: DataTypes.STRING,
12
    },
13
    status: {
14
      type: DataTypes.STRING,
15
    },
16
    description: {
17
      type: DataTypes.STRING,
18
    },
19
    createdAt: {
20
      type: DataTypes.DATE,
21
    },
22
    updatedAt: {
23
      type: DataTypes.DATE,
24
    },
25
    certificateOfIncorporationId: {
26
      type: DataTypes.UUID,
27
    },
28
    passportId: {
29
      type: DataTypes.UUID,
30
    },
31
  }, {
32
    tableName: 'companies',
33
    underscored: true,
34
    schema: process.env.DATABASE_SCHEMA,
35
  });
36
​
37
  return Companies;
38
};
39
​
40
​
Copied!
Directory: /forest
This directory contains the companies.js file where the smart action Upload Legal Docs is declared. 
You need to specify that the widget file picker is applicable to the input field used to upload the file.
companies.js
1
const { collection } = require('forest-express-sequelize');
2
​
3
collection('companies', {
4
  actions: [
5
    {
6
      name: 'Upload Legal Docs',
7
      type: 'single',
8
      fields: [{
9
        field: 'Certificate of Incorporation',
10
        description: 'The legal document relating to the formation of a company or corporation.',
11
        type: 'File',
12
        isRequired: true,
13
      }, {
14
        field: 'Valid proof of ID',
15
        description: 'ID card or passport if the document has been issued in the EU, EFTA, or EEA / ID card or passport + resident permit or driving licence if the document has been issued outside the EU, EFTA, or EEA of the legal representative of your company',
16
        type: 'File',
17
        isRequired: true,
18
      }],
19
    },
20
  ],
21
  fields: [],
22
  segments: [],
23
});
Copied!
Directory: /services
This directory contains an s3-helper.js file where the methods to upload files to s3 is declared.
You need to configure your AWS credentials inside your app to get access to your bucket. You can read more about it in the AWS documentation here.
1
const P = require('bluebird');
2
const parseDataUri = require('parse-data-uri');
3
const AWS = require('aws-sdk');
4
​
5
function S3Helper() {
6
  this.upload = (rawData, filename) => new P((resolve, reject) => {
7
    // Create the S3 client.
8
    const s3Bucket = new AWS.S3({ params: { Bucket: process.env.S3_BUCKET } });
9
    const parsed = parseDataUri(rawData);
10
​
11
    const data = {
12
      Key: filename,
13
      Body: parsed.data,
14
      ContentDisposition: 'inline',
15
      ContentType: parsed.mimeType,
16
    };
17
    
18
    // Upload the image.
19
    s3Bucket.upload(data, (err, response) => {
20
      if (err) {
21
        return reject(err);
22
      }
23
      return resolve(response);
24
    });
25
  });
26
}
27
​
28
module.exports = S3Helper;
Copied!
Directory: /routes
This directory contains the companies.js file where the logic of the smart action is implemented.
companies.js
1
const express = require('express');
2
const { PermissionMiddlewareCreator } = require('forest-express-sequelize');
3
const { companies } = require('../models');
4
const uuid = require('uuid/v4');
5
const S3Helper = require('../services/s3-helper');
6
const P = require('bluebird');
7
​
8
​
9
const router = express.Router();
10
const permissionMiddlewareCreator = new PermissionMiddlewareCreator('companies');
11
​
12
function uploadLegalDoc(companyId, doc, field) {
13
  const id = uuid();
14
  //upload the files using the helper
15
  return new S3Helper().upload(doc, `livedemo/legal/${id}`)
16
  //once the file is uploaded, update the relevant company field with the file id
17
    .then(() => companies.findByPk(companyId))
18
    .then((company) => {
19
      company[field] = id;
20
      return company.save();
21
    })
22
    .catch((e) => e);
23
}
24
​
25
router.post('/actions/upload-legal-docs', permissionMiddlewareCreator.smartAction(), (req, res) => {
26
  // Get the current company id
27
  const companyId = req.body.data.attributes.ids[0];
28
​
29
  // Get the values of the input fields entered by the admin user.
30
  const attrs = req.body.data.attributes.values;
31
  const certificateOfIncorporation = attrs['Certificate of Incorporation'];
32
  const passportId = attrs['Valid proof of ID'];
33
​
34
  P.all([
35
    uploadLegalDoc(companyId, certificateOfIncorporation, 'certificateOfIncorporationId'),
36
    uploadLegalDoc(companyId, passportId, 'passportId'),
37
  ])
38
    .then(() => {
39
      // Once the upload is finished, send a success message to the admin user in the UI.
40
      return res.send({ success: 'Legal documents are successfully uploaded.' });
41
    });
42
});
43
​
44
module.exports = router;
Copied!

How to's - Previous

Display data in html format

Next - How to's

Display AWS S3 files from signed URLs

Last modified 6mo ago

Copy link

Contents