Amazon S3 Data Destination

 

About

The Amazon S3 data destination sends submitted forms to an Amazon S3 bucket.  Create custom file and folder names based on data in the form to logically organize and manage files.

Data destinations automatically back up data collected in the field.  They reduce the need to visit the web portal by making submitted forms available through the services you already use.  Different documents can also be sent to different services with a single form submission.  Read here for more information on data destinations.

amazon-s3-big.gif

Amazon S3 (Simple Storage Service) is an online storage service that allows users to store and retrieve data from anywhere, at any time. "Lifecycle" rules can be set up, making it easy to transfer data to Amazon Glacier for cheaper long-term storage.

[ top ]

 

admin.pngnouser.pngnomobile.png

Basic Set Up

 amazonS3.png

  1. Create the data destination following the instructions here.
  2. Destination Basics: Name the destination.  Optionally choose to auto-link forms and documents to this destination.
  3. Add Filtering:  With a filter set up, form submissions will only be sent through the destination if the filter is met.  Read more here.
  4. Set up the Connection and File Configuration tabs as discussed below.

[ top ]

 

Connection

Bucket Name

Objects in S3 are organized into "Buckets."  Enter the name of an existing bucket.  ProntoForms cannot create new buckets in S3

bucket.png

[ top ]

 

Connection Configuration

Set up an Amazon Web Services Connection or use an existing connection. 

connection.png

[ top ]

 

Custom Header Values

Attach custom metadata to the document sent to S3.   Metadata consists of key: value pairs that belong to files. For example, an invoice  document may have a key:value pair of invoice_id: %r[id] 

metdata.png

 

Amazon S3 Server-Side Encryption (SSE)

Amazon Web Services can handle the encryption and decryption of your S3 objects for you with Server-Side Encryption (SSE); strong multi-factor encryption using 256-bit Advanced Encryption Standard (AES-256) encrypts your data and there is no need to manage your own encryption keys.  Decryption happens automatically when you retrieve data from your S3 bucket.  Read more about SSE here: http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html

Request that your ProntoForms-submitted data is encrypted by adding a request header to your data destination configuration.  Under Custom Header Values, enter x-amz-server-side-encryption as the key and set the value to AES256 .

amazonDDencryption.png

[ top ]

 

File Configuration

Send attachments in separate files, alongside the Data Record Document.

Optionally choose to send attachments (images, signatures, barcodes, etc) as separate files.

 

Folder Expression

This is the folder your documents will be sent to.  If the folder doesn't exist yet, it will be created.

folder.png

  • Single folder: Enter the folder name.  For a folder named "Inspections",  enter "Inspections".
  • Multiple folders:  Use Data Record Expression Language.
    • %f - to sort submissions into folders named after the form.
    • %u - to sort submissions into folders named after the user submitting the form.
    • %a[Question Label] - to sort submissions into folders named with the answer to a chosen question.
    • Optionally add static text for formatting - eg.  "%f -- %a[Customer Name]"

[ top ]

 

Link the Data Destination to Forms

In order for the destination to send any submitted form data, it must first be connected to the form.  This is done in the Data Destinations tab of the form builder.

[ top ]

 

Testing and Troubleshooting Data Destinations

Data destinations should be configured and tested carefully before using them in production. This is key to ensuring that ProntoForms data is received correctly. Please consult the recommendations for testing and troubleshooting data destinations.

[ top ]

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments