Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Select Components can be used for accessing resources and their data from another form.  On the Data tab, select Resource as the Data Source Type, then choose an item from the Resource drop down.  Note that the user interacting with the form will also need read permissions to the Resource to pull data correctly.  In the example below, a Resource named Vendor Details is selected.

The data will load into the list based on whatever submissions in that Resource the user has access to.  

Item Template

The Item Template section is used to control what data in the Resource's submission is available to the Select Component.  To return the entire Submission object, the Item Template should just be set to "item".

As Submissions "data" object is the parent for all user data.  If for example we wanted to only display the email address component from a resource in this list, the item template would reference "item.data.emailAddress".  Be sure to match the components API Key exactly.

Filter Query

A Filter Query is used to control what submission data loads in the list.  You might use a filter query to control a list of approvers based on a selected department for example.  In this scenario, we would have a resource for approvers that included a department and approver email address.  We would add a department field with matching department list values to the form, and when a depart is chosen, only approvers from that department will be available in the list.  The FIlter Query may look like "data.department = {{ data.department }}".  The left side of this statement describes the component in the resource that will be used to filter.  The right side is the data from the form to pass into the filter.  Objects wrapped in handlebars {{ }} will be converted to their actual values in the form at run time.

Automatic Selection

When a select component references a resource and there is only a single value available, the select component will automatically select that value.  When there is a 1 to 1 relation between the user's interaction with a form and  a linked resource, this is a very useful feature to pull in that resource data without have to burden the user with additional selection options.

  • No labels