Looking for information about ProntoForms features and functionality? Visit our Product Documentation Portal.
The Free Text data type is one of the most commonly used data types, as it can collect any type of text character. It's often used with the Text Field question type to collect names or address information in forms.
The Free Text Data Type can be collected with many different Question Types:
|Text Field||Text Area||Dropdown, Radiobutton, Multiselect||Button Group|
|Free Text Data Type||✓||✓||✓||✓|
- Text Field: Enter and view a single line of data. Can also be used with subsequent String Concatenation and Digit Extraction questions.
- Text Area: Enter and view a large amount of text at one time (limited to 4000 characters).
- Dropdown: Select one answer from a list of predefined answers.
- Radio Button: Select one answer from a list of predefined answers.
- Multiselect: Select one or more answers from a list of predefined answers.
- Button Group: Select one option via a 'button' display of predefined answers.
In the Form Builder, the settings related to the Free Text data type can be found in the "Properties" tab when editing the question. Not every setting shown below is relevant to every question type.
Validation checks that your users have entered information correctly.
|Text Field||Text Area||Dropdown, Radiobutton, Multiselect|
|Text Validation is available on:||✓||✓||✓ *|
* Validation on Dropdown/Radiobutton/Multiselect questions is intended for use on the 'Collect a text response with an "Other" option,' but will also validate predetermined answers set up in the form builder.
Pre-Built Validation Types
- Non-accented letters and numbers only, no spaces (e.g. Abc123)
- Non-accented letters only, no spaces (e.g. ABC)
- Canadian Postal Code (e.g. Z1Y 2X7): Checks for a valid A0A0A0 postal code.
- U.S. ZIP Code (e.g. 58008): Standard 5-digit ZIP codes as well as ZIP+4 format are both acceptable.
Custom Validation uses a Regular Expression (regex) to validate the text your users provide. This allows you the flexibility to check almost any kind of data against certain criteria, for example, checking the number of characters entered. Note: ProntoForms Support cannot help with testing your RegEx. Ensuring the expression is correct may be done using a RegEx Tester such as Regex101 (External Link).
Many Data Destinations (such as Salesforce) have character limits on fields that can be filled by ProntoForms. Custom validation can ensure that your mobile users enter the right data. For example, a Project Name may be limited to 20 characters. This can be set up in the form builder like so:
The Validation Error Message is what your mobile users see when they enter data that doesn't fit the validation. Using our example above on a device:
The default value will appear as an initial value when mobile users open the form. You can save your mobile users some time by entering the most common value for a question; they only have to edit it if it varies from the norm. There are some question type specific properties:
- Use mobile user's username as the default value: this will put the mobile user's ProntoForms username as an answer to the question. This only applies to the Text Field question type.
Note: If a question is Required but has a default answer, it is considered Answered in the app. This means that mobile users can skip answering the question themselves.
This setting allows you to choose different keyboard Input Types based on what kind of information your mobile users will be entering. For example, it is easier to enter a URL on a keyboard that has the / and . characters easily accessible.
Below are screenshots of the various keyboard types on an Android device: