Answer formats represent the method by which a participant should answer a question. They are used for both question steps and form items (in a form step).
Contents
Text
The text answer format simply allows the participant to enter free text.
| Property | Function | Examples |
|---|---|---|
| Placeholder |
The “watermark” text that should display for the form item before the participant enters an answer. Note: If you also specify a "Default Value", the placeholder text will not show up unless the participant first erases the default text. |
Enter a medication name. |
| Multiple Lines | Whether the text box should allow for multi-line text entry. | Yes/No |
| Default Value | A default value that is already entered for the participant. | Aspirin |
| Maximum Length | Maximum number of characters allowed for the text entry. | 20 |
| Validation Pattern |
A standard regular expression pattern used to determine whether the entered text is valid. For example, to verify a standard telephone format like (123)-555-1234 you might use: \(?[\d]{3}\)*-[\d]{3}-[\d]{4}
Note: If you use this option, you must also specify an "Invalid Pattern Message." |
see function |
| Invalid Pattern Message |
When "Validation Pattern" is specified, this is the message that will be displayed if the participant enters an invalid value. |
Enter a phone number in the form (123)-555-1234. |
| Keyboard Style |
Controls what type of keyboard is presented to the participant. |
Text |
Numeric
The numeric answer format allows the participant to enter a number.
| Property | Function | Examples |
|---|---|---|
| Placeholder | The “watermark” text that should display for the form item before the participant enters an answer. | Enter a number. |
| Style | Whether the number should be an integer (whole number) or decimal. |
Integer |
| Default Value | A default value that is already entered for the participant. | 18 |
| Minimum Value | The minimum value allowed | 0 |
| Maximum Value | The maximum value allowed | 10 |
Text Choice
The text choice answer format allows the participant to choose from a set of options. It has these properties:
| Property | Function | Examples |
|---|---|---|
| Text Choice Style | Whether the participant can select one choice or multiple choices |
Single Choice Multiple Choice |
| Default Value |
A default value that is already selected for the participant. Note: This should match the 'Value' property of the desired default choice. |
0 |
| Text Choice Description Style | Whether the description of each choice is always displayed, or only displayed when the participant expands it. |
Display Always Display When Expanded |
Additionally, it requires setting up one or more choices. Each choice has the following options:
| Property | Function | Examples |
|---|---|---|
| Value | The value of the choice which is not displayed to the participant. This is what will be saved as the answer when the participant submits their response. |
Always, Never, 0, 1 |
| Text | The text of the choice which is displayed to the participant. | All the time, Never |
| Description | A longer description of the text choice. You can configure whether this description is always shown or only shown on demand with the "Text Choice Description Style" option. | Select this if... |
Yes/No Choice
The yes/no choice answer format simply allows the participant to select yes or no in response to a question.
| Property | Function | Examples |
|---|---|---|
| Default Value | A default value that is already selected for the participant. | Yes, No |
Scale (Discrete)
The scale answer format displays a scale to the participant for them to select a value in a range. For instance, it is useful to assess things like pain scores, instead of having to present a text choice to the participant.
The discrete scale only allows the participant to choose a value that is divisible by the step value.
| Property | Function | Examples |
|---|---|---|
| Minimum Value | The lower bound of the scale. | 0 |
| Minimum Value Description | A label to describe the minimum value of the scale. | No pain |
| Maximum Value | The upper bound of the scale. | 10 |
| Maximum Value Description | A label to describe the maximum value of the scale. | Most imaginable pain |
| Step | The size of each discrete offset on the scale. | 1, .1 |
| Default Value | The default value for the scale. | 5 |
| Vertical | Indication of whether the scale should be oriented vertically. | Yes No |
Scale (Continuous)
The scale answer format displays a scale to the participant for them to select a value in a range. For instance, it is useful to assess things like pain scores, instead of having to present a text choice to the participant.
The continuous scale allows the participant to choose any value between the minimum and maximum allowable values.
| Property | Function | Examples |
|---|---|---|
| Minimum Value | The lower bound of the scale. | 0 |
| Minimum Value Description | A label to describe the minimum value of the scale. | No pain |
| Maximum Value | The upper bound of the scale. | 10 |
| Maximum Value Description | A label to describe the maximum value of the scale. | Most imaginable pain |
| Maximum Fraction Digits | The maximum number of fractional digits to display. | 1, 2 |
| Default Value | The default value for the scale. | 5 |
| Vertical | Indication of whether the scale should be oriented vertically. | Yes No |
Date
The date answer format displays a date picker to the participant for them to select a specific date (and, optionally, time).
| Property | Function | Examples |
|---|---|---|
| Style | Whether to capture a date or a date and time. |
Date Date and Time |
| Default Date | The default date for the picker. See below for details. | 1/15/2018 |
| Maximum Date | The maximum date allowed in the picker. See below for details. | 1/30/2018 |
| Minimum Date | The minimum date allowed in the picker. See below for details. | 1/1/2018 |
| Default Value |
May be used in lieu of Default Date if you want to populate the default date with a value from a custom field or event, or if you want to specify the default date and time. Note: You may use either Default Date or Default Value, but not both. |
1/15/2018 4/10/2020 5:22 PM |
For each of the date options (default, minimum, maximum), you can specify:
- None - The option will not be used. For example, if you specify "None" for "Maximum Date", the participant will be able to choose any future date.
- Specific Date - A specific date, e.g. 1/30/2018.
- Relative Date - A date relative to when the participant is filling out the survey. For example, if you choose "7 days in the past" for "Minimum Date" and "7 days in the future" for "Maximum Date", the participant won't be able to choose dates more than a week ago or a week from when they take the survey.
Time of Day
The time of day answer format displays a time picker to the participant for them to select a specific time.
| Property | Function | Examples |
|---|---|---|
| Default Time | The default time for the picker | 3:15pm |
Height
The height answer format displays a “drum” picker that lets the participant choose a height.
| Property | Function | Examples |
|---|---|---|
| Measurement System | The measurement system for the weights. | US Metric |
| Default Value | A default value already entered for the participant. | 65 inches |
Weight
The weight answer format displays a “drum” picker that lets the participant choose a weight.
| Property | Function | Examples |
|---|---|---|
| Measurement System | The measurement system for the weights. |
US |
| Default Value | A default value already entered for the participant. | 160 lbs |
Value Picker
The value picker answer format displays a “drum” picker to the participant for them to select a single option. Can be used in situations where a text choice answer has too many options to display on a reasonable screen, as the value picker will only display 5 options at a time.
Additionally, it requires setting up one or more choices. Each choice has the following options:
| Property | Function | Examples |
|---|---|---|
| Value | The value of the choice which is not displayed to the participant. This is what will be saved as the answer when the participant submits their response. | 0, A |
| Text | The text of the choice which is displayed to the participant. | All the time, Never |
| Default Value |
A default value already entered for the participant. Note: This should match the 'Value' |
A |
Additionally, you can set these properties on the value picker as a whole:
| Property | Function | Examples |
|---|---|---|
| Default Value |
A default value that is already selected for the participant. Note: This should match the 'Value' property of the desired default choice. |
0 |