A Choice Question has the following properties:
Fields...
In some properties you can use fields as (part of the) value. You can use the button Fields... to insert fields into the property value.
Note
This feature is only available when the project containing the Form is configured with ITP/Create Model Package 3.2.19 or up.
Question text
This is the question as it is shown to the user. You can use HTML-instructions to lay out this text.
Read-only (not available in QForms)
Check this box to make the question read-only. When the form is filled out the default answer is shown and the end user cannot change this value.
Answer field
Answers to questions are stored in an answer field. This field can be used in the model document. Select the answer field into which the answer to this particular question will be stored.
Help text
Help text can be added to a question to provide additional information to the user. By default, a question mark will be shown next to the question. If the end user hovers over this question mark the Help text is shown. You can use HTML-instructions to lay out the text.
Display
In the Display section, you can specify how the question is presented to the end user and what kind of choices he may make from the list of possible answers.
If the option "Allow multiple answers to be selected" is not checked, the end user is allowed to select exactly one answer. This is the default choice. In this case the end user will see the list of possible answers as a list box. Check the box "Show answers as radio buttons" to show the list of possible answers as a radio button list instead of a list box.
When the option "Allow multiple answers to be selected" is checked, the end user is allowed to select zero or more answers from the list of possible answers. If you check the option "Allow selected answers to be ordered", the end user can also change the order in which the selected answers will be stored in the answer field.
Note
If you check the option "Allow selected answers to be ordered" it will not be possible to show or hide groups based on this question.
Possible answers
The end user can select an answer from the list of possible answers. There are two options for specifying the possible answers, Fixed and From Field:
- Select the option From Field to indicate that the list of possible answers should be retrieved from a field. The field should contain a comma-separated list of text values that can be selected by the end user.
- Select the option Fixed when there should be a fixed list of possible answers. When this option is selected, the text area to the right of the option Fixed shows the currently configured list of possible answers. To modify the list, click the button Modify. This will open the Possible Answers window:
Fill in the possible answers In this window. The end user can choose from the prepared answers:
- Use New... to add a new answer to the list of answers.
- Use Edit... to change the text of an answer.
- Use Delete to remove an answer from the list of answers.
- Use the buttons with up and down arrows to change the order in which the possible answers will be shown to the end user.
Note
You can also use fields in your answer values. The button Fields... is available when you create a new answer, or edit an existing answer. Answers containing a field cannot be used to show or hide groups.
Default answer
When the Form is presented to the end user, the question's answer will be filled with the default answer defined in this section. To define the default answer, select one of the three options available: Default, Answer(s) or From Field.
Select the option Default to let ITP automatically select the 'default' default answer. This option is available only when the list of possible answers is taken from a field. For questions that require exactly one answer, this option will select the first available answer. For questions that allow multiple answers, no answers are selected by default.
Select the option Answer(s) to select one or more default answers from the list of possible answers. This option is only available when the list of possible answers is fixed.
This option behaves differently depending on the Display settings:
- When you are editing a question that allows only a single answer, you are presented with a list box which contains the list of possible answers. From this list, exactly one answer can be selected as the default.
- When your question allows multiple answers, you can select zero or more answers. In this case, your are presented with two lists; the right-side list contains the currently selected default answers, while the left-side list shows the answers that are not currently selected as default answers. Answers can be transferred from one list to the other using the left-arrow and right-arrow buttons that are shown between the lists. When you have checked the option "Allow selected answers to be ordered", you can order the selected answers using the buttons with the up and down arrows next to the list of selected answers.
Select the option From Field to indicate that the default answers should be taken from a field. For questions that allow multiple answers, the field contains a comma-separated list of values that can be used as the default answers. For questions that allow only a single answer, the field should contain the text of the answer that should be selected by default.
Validation
Forms
When the Validation is checked as "None" the answer to the question is not checked.
When "A non-empty answer is required" is checked the answer to the question needs to be filled in by the end user. Otherwise, an error will occur. You can fill in the Help text in the field Error message text. You can use HTML instructions to layout this text and you can add the value from a Field.
QForms
For QForms the option "A non-empty answer is required" is checked by default to ensure the user fills in an answer. Otherwise, an error will occur for which the message can be specified in the field Error message text. You can use HTML instructions to layout this text and you can add the value from a Field to this Error message text. If it is not desired to validate if the end user has filled in an answer, the option None can be selected.
Note
- The tab Validation is only shown from version 3.2.19 or up of the ITP/Create Model Package.
- The option to select None as validation on questions requires a ITP/Create Model Package 3.5.0c or higher.
Advanced
This feature is for advanced users only. Do not enter or change IDs on this tab if you do not understand the implications.
Every question in a Form is associated with a unique identifier (ID). If Question IDs are not present in a Form, they are automatically generated when a Form is saved. You can change such an ID manually on this tab. For more information, refer to the ITP/Server Manual chapter Integrating, section Form and Question IDs.
Note
The feature Reference is not available for QForms. Refer to Distinctions between Forms and QForms for more information.