Note: This object is only available in Classic/Default Template surveys.
Single Questions that require multiple fields (controls) can be created using the Multi-Control Question Object. Multi-control questions are different than standard Illume questions in that with standard questions, you build how the question will look using the question editor, and doing so automatically creates the columns in the database into which the responses will be stored. In contrast, with multi-control objects, you must follow a two step process:
1. Define how the question will look using the Multi-Control Question Editor
2. Define the variables into which the data from that question will be saved. These variables are Preload/Hidden variables.
Both steps must be completed for the multi-control to work.
Types of Single Multi-Control Questions:
- Multiple Text Fields
- Multiple Poplists
- Multiple Individual Check Boxes
- Any combination of the above
Steps to create a Text Field Multi-Control Question
The following steps will describe how to create the following example Question:
Steps:
- From the Add menu select Multi-Control Question
- In the General Tab Enter the Unique name of the object.
- This “Unique Name” will not appear in the Data Dictionary as it is just a label for the object itself. Later in the design process you will define the variables that go into the data dictionary.
- Enter a Description if desired
- Optional –Select Anchor this item when randomized – If this object is in a Collection that is set to randomize its contents, checking this box will hold this item’s position constant.
- Click on the Configure Tab
- Click the Add Row Button
- Click in the Cell that was just created in the Table Layout
- In Cell Controls, Click the Add Button
- The Control type allows for the following selections:
-
- Prompt
- Text Field
- Pop List
- Check Box
- Select Prompt
- Type or paste the Prompt in the Prompt field
- To place the field underneath the prompt, click the Add Row button. If you would like the field to the right of the prompt click the Add Column button
- Click in the Cell that was just created in the Table Layout
- Click the Add Button
- Enter the Survey Variable Name for this field – As stated previously, this will require the addition of a Preload/Hidden Variable in the survey with the same name. Do not use spaces. Write down this name so that you’ll remember it when you create the Preload/Hidden Variable of the same name.
- If a Label is needed, add it in either the Label Before or Label After field
- Enter any appropriate CSS style information if used
- Click on the Display Properties Tab
- Check the box and enter the desired size of the Text Field
NOTE: If the box is not checked and no size is specified the browser will create a default size field. This only sets the actual size of the visible field. The number of allowed characters will be set in the Validation tab.
- Click the Validation tab. You will NOT select a data type here in the question editor. Rather the data type you wish to capture in this field will be defined in the Preload/Hidden variable editor.
- If a response is required, click the Require a Response checkbox
- To enforce the character length, enter the Minimum and/or Maximum number of characters that can be entered in the field
- To enforce a numeric range, a Numeric Minimum and Maximum can be entered
- It is also possible to use Regular Expressions matches to enforce very specific text field entry
- Add a Custom Error Message if desired
- Click again in the cell that currently has the Feet variable, and follow the steps from 9-26 again to add the next field Inches.
- After both of the cells are added Select the Run-If tab to apply logic to this object, if the object should only be shown under certain conditions
- Click OK when finished
- From the Survey menu select Preload/Hidden Variables
- Create a preload variable called HFEET, and another called HINCHES. Each one should be of Whole Number data type, as that is the type of data you want to capture.
- Preview the Question
Steps to create a Poplist Multi-Control Question
These steps will be used to create the following question:
Steps:
- From the menu select Survey/Add Runtime Content…
- Select Multi-Control Question…
- In the General Tab Enter the Unique name of the object. This name will not appear in the Dataset or the Data Dictionary.
- Enter a Description if desired
- Optional – Select Anchor this item when randomized – If this object is in a Collection that is set to randomize its contents, checking this box will hold this item’s position constant.
- Click on the Configure Tab
- Click the Add Row Button
- Click in the Cell that was just created in the Table Layout
- In Cell Controls, Click the Add Button
- The Control type allows for the following selections:
-
- Prompt
- Text Field
- Pop List
- Check Box
- Select Prompt
- Enter the Prompt in the Prompt field
- To place the poplist underneath the prompt, click the Add Row button. If you would like the poplist to the right of the prompt click the Add Column button.
- Click in the Cell that was just created in the Table Layout
- Click the Add Button
- Select the appropriate Control Type for the first variable field – In this example select Poplist
- (OPTIONAL) Checking the – Define local response options will activate the Response Options tab. This is used to filter the list of response options that exist in the Hidden Variable.
- Enter the Survey Variable Name for this field – As stated previously, this will require the addition of a Hidden Variable in the survey with the same name. Do not use spaces
- If a Label is needed, add it in either the Label Before or Label After field
- Enter any appropriate CSS style information if used
- Click the Validation tab
- Check the Require a Response box to make this a required variable
- Enter a Custom error message if desired
- Click Add Column for the next Poplist and repeat the steps as many times as needed for each field
- After all of the cells are added, select the Run-If tab to apply logic to this object
- Click OK when finished
- Create the appropriate Hidden Variables
- Preview the Question
Steps to create a Check Box in a Multi-Control Question
While a single check box type question can be added as a Multi-Control type object, they are easily created as one of the Standard Question types.
To add a Check Box to a question follow these steps:
- In any Multi-Control Question
- Click the Add Column Button
- Click in the Cell to add the Checkbox
- Click the Add Button
- Select the appropriate Control Type for the first variable field – In this example select Check Box
- Enter the Survey Variable Name for this field – As stated previously, this will require the addition of a Hidden Variable in the survey with the same name. Do not use spaces
- If a Label is needed, add it in either the Label Before or Label After field
- Enter any appropriate CSS style information if used
- Click the Validation tab
- Check the Require a Response box to make this a required variable
- Enter a Custom error message if desired
- Click OK when finished
Multi-Control Questions with Different Variable Types
A Multi-Control Question can be any combination of the three control types (Text Field, Pop List, Check Box). Create a Multi-Control Object then follow the steps for each type in the cell you are working with.
Cell Column Spanning
To achieve a smooth looking prompt it is possible to Span the prompt across multiple Cells.
To achieve this, follow these steps:
- In the Configure tab of a Multi-Control Question
- Click on the cell that the Prompt is in
- Set Cell Column Span to the desired length. NOTE: The Cell Column Span will only be a large as the number of empty columns to the right of the selected cell
- When finished click OK