Box User Group Data Source

 

About

The Box User Group Data Source retrieves data from a file in a Box account. For each user in the selected Box user group, the data source pulls the Box User ID, Name, and Box Login (username) into ProntoForms for use in your mobile forms.  This data can then be used to populate the metadata fields of a data record document produced by a Box Data Destination

Data sources are usually set up to fetch data on a specified schedule. This allows teams to maintain and update their data through the external service of their choice, minimizing the need to access the web portal.  

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.

[ top ]

 

admin.pngnouser.pngnomobile.png

Set Up the Data Source

boxuserds.png

  1. Create the data source as described here
  2. Select Box User Group Data Source as the type.  
  3. Name the data source and optionally enter a Description.
  4. Set up the data source using the information below. 

[ top ]

 

Data Retrieval and Format

Push updates to device after a fetch

If turned on, users will get a notification from the ProntoForms app after a fetch. It will prompt users to reconcile (send/receive or refresh).   This setting is recommended if it is important that users have the most up-to-date data.    

  • With "push updates" and an automatic fetch set up, some data sources send a notification for each fetch, whether or not the data source has new data.
  • If the fetch schedule is hourly, users may get notifications hourly even if the data has not changed.
  • Some users may find these notifications annoying or confusing.  Consider the fetch frequency carefully if notifications are enabled.  

retrieval_andformat.png

 [ top ]

 

Fetch Schedule

Automatically fetch new data on a schedule:

  • If checked, data will be retrieved from Box at the Fetch Frequency interval.
    • Make sure that the team has a Problem Contact Email Address.  If a fetch is unsuccessful for any reason, this address will receive an  email with an error message and details.  Without this email, it may not be immediately clear that a fetch has failed.  
  • If unchecked, the data source will not be updated automatically.   To retrieve new data from Box, the data source will need to be manually updated through the "Fetch New Data" button in the web portal.

 

Fetch Frequency: 

Choose Hourly, Daily, Weekly or Monthly.  This is how often the data source will fetch new data from Box.

 

Fetch Timezone: 

This applies to all fetch frequency options except “Hourly.”  Data will be fetched at midnight in the chosen time zone.

[ top ]

 

Box Connection

Connection Configuration

Configure a Box Connection or use an existing connection. 

  • Select the User Group (once the connection is established, a dropdown list of available groups will automatically appear)

[ top ]

 

Fill the Source Data immediately:

fillsource.png

  •  If left unchecked, the data source will wait until the specified time and interval to retrieve data for the first time.
  •  If checked, the first data retrieval will occur immediately after creating the data source.

[ top ]

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

Comments