This is the main root of the questionnaire. It can contain questions, question groups and events.
The name attribute is the name of the questionnaire.
The id attribute should not be specified. It is a database id that will be filled in when retrieving from the
REST API or web front end.
The on element is used for registering actions for all questions
in the questionnaire. For example:
<on event='answer' answer='quit' nextQuestion='end'/>
<on event='expire' nextQuestion='good_bye'/>
The event attribute permits any string value, which allows
support for further event types in the future.
A question group is a list of 1 or more questions which should be displayed to the user on a single screen.
It is not always possible to do this (for example with some question types and sms) but the system will
always attempt to.
Routing for a group is detemined via the attribute nextQuestionDeterminer. This specifies the name of the
question that will be used for routing.
The id attribute should not be specified. It is a database id that will be filled in when retrieving from the
REST API or web front end.
The name attribute is the user defined name for the group.
The question type holds all the types of question.
The id attribute should not be specified. It is a database id that will be filled in when retrieving from the
REST API or web front end.
The name attribute is the user defined name for the question.
The answerName attribute is a user defineable name for the answer which will be included in responses
from the REST API.
The answerId attribute should not be specified. It is a database id that will be filled in when retrieving from the
REST API.
The free form text question allows the respondent to enter free form text.
The max length attribute is the longest acceptable response from the user.
The numeric question allows the respondent to enter a numeric value.
The max length attribute is the longest acceptable response from the user.
The minValue and maxValue attributes reflect the smallest and largest acceptable value from the respondent.
The rank question allows the respondent to enter a number of numeric values.
The values are to be within the range minValue to maxValue, and the values are
to be non-repeating. The numValues attribute is the number of numeric values
that can be entered. The max length attribute is the longest acceptable
response from the user. Example Question: Rank your favourite three numbers
from one to ten. Example Answer: ' 7 2 8 '
The choose many question presents a list of options to the respondent. The respondent can choose as many or as
few as they like.
The choose one question presents a list of options to the respondent. The respondent must choose one and only one.
The binary question presents the respondent with two options (for example yes and no). The respondent must choose one.
Support for triple-s. Values must add up to the value of attribute sum. See triple-s standard for more information.
Support for triple-s. All options must be returned by the respondent but in any order. See triple-s standard for more information.
The info question is to provide information. No explicit response is expected from the respondent
although the system does register an answer to the question if the respondent has seen it.