Setting a Question’s Response Options

Response options appear on the Response Options tab of the Question Editor. This is where a question’s list of available responses are defined. The options available on this tab vary, depending on the type of question. For Text Field and Commentary questions, the only item on the response options tab will be the Data Type list.

This section focuses on configuring response options for ‘Select One’ and ‘Check all that apply’ type questions.

To set response options:

1. Choose a data type. A data type can only be chosen if the question uses the ‘”Select One’ or ‘Text Field’ display type.

2. If a numeric data type is chosen, add scale values, as described below. If the Yes/No data type is chosen, define the Yes/No values, as described below.

3. If the response options for this question are to be ordered randomly for each participant, check Randomize Display Order.

Choosing a Data Type

The type of data chosen here is the type of data that will end up in the data set for this particular question. Generally, whole numbers are used for Select One type questions.

Illume Next  recognizes the following data types:

 

Setting a Default Value

A default value can be set for a question by typing the value into the Default field. Default values are optional. The value entered in the default field will be pre-selected the first time the participant sees this question on the survey. The participant is free to change or accept the default selection. Use one of the following two methods to set the default value:

See “Piping Data” for general information about piping, or “Setting Dynamic Defaults and Bounds” for more specific issues to consider when piping data into a question’s default value of response guides.

 

Adding/Editing Scale Values

Scale values are the options from which participants may choose when responding to a question. To add numeric scale values, follow these steps:

1. Type the value in the small text box to the left of the equal sign.

2. Press the Tab key to move the cursor into the display text field, then type the text the participants should see for this option.

3. Press the Enter key. This adds the value to the list of scale values below, and returns the cursor to the value text box.

4. Repeat steps 1-3 until all of the options wanted for this question have been added.

Note that for each response option, the value is what will be stored with the data set, while the display text is what participants will see when they are reading through the question’s available answers.

If a user does not want to type a value for each individual response option, and it is known that the values will be in sequential order, check the box labeled “Generate values automatically”, and indicate the number at which the values should begin. Then response options can be added by typing them into the display text field and pressing Enter.

 

Response Options for Check All That Apply Questions

For each checkbox in a “Check all that apply question,” a name must be supplied for the checkbox as well as the text that should appear next to the checkbox.

Choose a name for each checkbox that will be helpful during data analysis, so the data analyst can see instantly what the participant was saying yes to when they checked the box.

 

Mutually Exclusive Response Options for Check All That Apply Questions

A Check All That Apply question can include one or more mutually exclusive check box responses. Mutually exclusive check boxes allow survey designers to specify “Does not apply” or “Refuse to answer” type responses in Check All That Apply questions. When one of these responses is checked no other responses can be checked.

To make a response option mutually exclusive, click the Response Options tab in the question editor and then click the checkbox in the Exclusive column for the desired response option.

When JavaScript is enabled, the client web browser prevents having a mutually exclusive check box being checked when other check boxes are checked. If JavaScript is not enabled both types of check boxes (exclusive and non-exclusive) are able to be checked at the same time and this condition will be caught on the server and an error message will be displayed. The error message can be edited by clicking Edit Preferences and the Error Messages tab. In the drop-down menu select the error for: A mutually exclusive check box is checked when other check boxes are checked.

When a mutually exclusive checkbox is selected, the response guide for minimum # of responses is ignored if set to a value greater than 1.

 

Setting Show-if Conditions on Responses

A user may want to display response options only under certain conditions. To set show-if conditions on a response option:

1. Click on the option in the list at the bottom of the Response Options tab.

2. Click on the Show-if… button to get to the show-if editor.

In this image above, the circle to the left of the first option is yellow because this option includes a show-if condition. Once the Show-if button is clicked, the process is the same as setting a show-if condition for a question, which is described in detail in “Setting Show-if Conditions”.

Once a show-if condition is set for a response option, the Survey Designer displays a yellow control-type image next to the question to indicate that some response options have display conditions attached. In the image below, the question FREQ includes response options that display conditionally. For the other questions, all response options always appear.

Attaching a Text Field to a Scale Value

A text field may be attached to a scale value question to allow participants to explain their responses. For example, if one of the response options is “Other (please specify)”, participants should be given a place to specify what they mean by “other.” If the response option has not yet been added to the list, create the option as described above then check the “Attach text field” box and click the Add button to add the option to the list. In the list of response options, notice that when an item has an attached text field, the Text Field box next to that item is checked. To add a text field to an item that is already in the list of response options, simply check the “Text Field” box next to the item in the list. To delete the text field, uncheck the box.

 

Setting Properties for Attached Text Fields

After attaching a text field to a response option, the user may want to set some properties for the text field. To do so, follow these steps:

1. In the list of available response options, click once on the option whose text field is to be configured.

2. Click on the Text Field Properties button.

3. Set the desired properties (described below).
4. Click OK .

 

The General Tab of the Scale Text Question Editor enables you to configure the following properties:

 

The Response Guides tab of the Scale Text Question Editor enables the following properties to be configured:

 

Attached Text Field Properties in Multilingual Surveys

If a survey includes multiple translations, the user will want to separate translations for any labels and error messages belonging to attached text fields. Generally, this is done by creating a Translation Package, but in some cases, these items may need to be edited individually.

To set the label, description, and error message for an attached text in a specific language:

1. Open the question to which the text field is attached in the Question Editor.

2. Click the Response Options tab.

3. Choose the translation to work with from the list at the bottom of the Question Editor.

4. Click on the scale value whose attached text field is being edited.

5. Click Text Field Properties.

6. Edit the label, description, and/or error message in the Scale Text Question Editor.

7. Click OK to close the Scale Text Question Editor.

8. Click OK in the Question Editor to save changes.

The changes made to attached text field properties affect only the language that was selected when the Scale Text Question Editor was opened.

Randomizing Display Order and Anchoring Options

By default, Illume Next presents response options to participants in the same order they appear in the Question Editor. If the Randomize Display Order box is checked, Illume Next will present the options in random order. Even when response options are presented in random order, a user may want to fix the location of certain options. For example, if a question includes an “Other” or “I choose not to answer” option, it may be appropriate for this option to always appear last. To ensure an option appears in a particular place within a randomized list, check the option’s Anchored box. In the screenshot above, the 4th option, “Other,” is anchored as the last item on the list. While the other three options are shuffled around, “Other” will always appear as the last option. Checking the Anchored box caused the corresponding option to appear on the survey in the same position in which it appears in the Question Editor. Thus, clicking the Anchored box next to the second option in the list, “I work part time,” would cause “I work part time” to always be displayed as the second option. Similarly, dragging “Other” to the top of the list of options, and leaving the Anchored box checked would cause “Other” to always be displayed as the first response option.

Editing an Existing Response Option

To edit an existing response option:

1. In the list of existing response options, click once on the text of the option being edited.

2. The option’s text and value will be loaded into the editable fields above the list. Edit these as necessary.

3. (Optional) Check Attach text field to attach a text field.

4. Click the Replace button. The old option details will be replaced by the new option details in the list of existing options.

Deleting a Response Option

To delete a response option:

1. In the list of existing response options, click once on the text of the option to be deleted. The option should be highlighted after it has been clicked on.
2. Click the Remove button.

Configuring Yes/No Response Options

The only available data type for Yes/No questions is Yes/No. Unless these values are redefined, “No” answers are stored as zero (0) and “Yes” answers are stored as one (1) in the survey results.

If desired, this can be changed by assigning scale values as described below. In some cases, a user may want the value 1 to represent No. For example, if there is a calculated variable that adds up all the No answers, you’ll need to set No to 1, or the calculated variable will just keep adding up zeros, which doesn’t do any good.

The text typed next to the No option (i.e. next to the zero) will not be displayed in the survey . It will appear in the data dictionary to describe what it means when a participant did not check the checkbox for this question.

The text typed next to the Yes option (i.e. next to the one) will appear next to the checkbox in the participant’s survey.

Setting the default state for a Yes/No item to “None” or to “0” leaves the checkbox unchecked by default. Setting the default to “1” leaves the box checked by default.

Date and Time Data

Text questions can be of virtually any data type, including Date, Time, and Date/Time. Illume Next uses Microsoft’s .NET DateTime object to store dates and times. The .NET DateTime object can represent dates between 12:00 a.m. January 1, 0001 CE and 11:59:59 p.m. on December 31, 9999. Illume Next considers dates outside of this range to be invalid. The range can be narrowed by setting minimum and/or maximum dates in a question’s Response Guides. Non-existent dates are also invalid. For example, February 29, 2005 is invalid because 2005 is not a leap year. A participant must enter dates or times in a format that .NET recognizes. In general, for the United States locale, dates in the following formats are valid:

Other date formats will also work in the US. It is best, however, to suggest a format that will work in either the question prompt or in the question label. For example, a prompt that suggests a valid format would be: Please enter your date of birth (mm/dd/yyyy).

Illume and .NET recognize both 12- and 24-hour time format, though Illume may ignore the seconds. The following time formats are valid in the US locale:

.NET uses the same standard set of date and time formats that other Microsoft products use. This means that any Date, Time, or Date/Time format produced by an application like Microsoft Excel, Access, or SQL Server will work in Illume Next. Use the Date data type only for variables that must include a day, month, and year. If a variable requires only one of these values (day or month or year), choose the whole number or text data type. Choose Date/Time data type only for variables that require a day, month, and year value with an optional time value.

Dates, Times, and Localization

Illume Next and .NET use the locale settings of the Illume Next server to determine dates and times. This can cause some confusion if a survey is not designed correctly. For example, if a survey is being administered to participants in both the US and the UK, be aware that the two locales use different date formats. A US participant entering 06/12/2006 will mean June 12, 2006, while a British participant entering the same thing will mean December 6, 2006. If the survey is running on a server whose locale is set to EN-US (English, United States), the date will always be interpreted as June 12. If the server’s locale is set to EN-GB (English, Great Britain), the date will always be interpreted as December 6. This will be a problem if the question includes a minimum and/or maximum date. The British user or the US user may not be able to get past the date question simply because the participant and the server do not agree on what the date means.

One way to avoid date/time problems caused by local differences is to break dates and times into separate questions, each of which is of type whole number. For example, instead of asking for a participant’s birth date, ask for his or her year of birth, then month of birth, then day of birth.

Display of Date and Date/Time Datatype Questions

Questions of Date datatype automatically display to the participant with a calendar icon for easy selection of dates and times.  The rendering of this calendar will appear differently depending on the type of device utilized to launch the survey.

Desktop rendering:

Mobile rendering: