Knowledge Base/Documentation/Data Destinations

Box Data Destination

Sinan Serifov
posted this on December 2, 2011, 15:40

Available in: Pro Tier

 

About

The Box data destination sends submitted forms to a folder in a Box account.  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.

carlo_damico-box.png

Box is a popular cloud-based storage service.  Box users can access, manage and share their content from various devices and locations.  This makes Box an ideal service for storing data from mobile forms.   Looking for two-way integration?  Read more about the ways ProntoForms can connect to Box.

Watch the video below for an overview of integrating Box with ProntoForms.

[ top ]

 

admin.pngnouser.pngnomobile.png

Basic Set Up

 boxdd.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. Connection: Set up a Box Connection or choose an existing connection.
  5. Set up the File Configuration tab as discussed below.

[ top ]

 

File Configuration

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

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

 

Folder

This is the Box 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 ]

 

Custom Metadata

Attach custom metadata to the document sent to Box.   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

Note: Metadata is in Beta in Box. Contact Box to enable metadata in order to use this feature.  In the future, Metadata values will be indexed by the Box search engine. If you perform a search, it will treat metadata values similarly to how file titles or file text are currently treated.

[ 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 ]