Item - Multiple Response

Item Resource - Multiple Response

A Multiple Response question type is very similar to a multiple choice question type, the only difference being that with a multiple response question type, more than one answer option can be correct, meaning the candidate will be selecting two or more correct answer options out of the answer options given. We also now allow a specific mark to be set to different combinations of answers rather than just providing the full mark or evenly split partial marks.  This question type is also available to use as a survey item type, all properties remain the same but the "Survey" type is returned as part of the mutual properties.



To build a POST request to the item resource, the body should include any top level property required on the item (further information about these properties can be found on the item resource help page), this would then be followed by the question type collection. The collection required for multiple response questions, including the mandatory minimum properties is as follows:

...
multipleResponseQuestions: [
{
"maxSelections": 1
{
]
...

This collection would include all of the question specific properties required. The table below identifies all of these properties including its name, type, description, default value and if it is mandatory in a request. We have also provided sample requests for the POST and GET/{id} methods in XML and JSON format:

GET/{id} - Item MRQ - JSON Example
GET/{id} - Item MRQ - XML Example
Property Name Type Description Default Value
(POST)
Mandatory for
create (POST)
maxSelections int The maximum number of selections a candidate can make. n/a X
(Draft)
partialMarks boolean This identifies if the candidate needs to select all correct options before getting the mark or if the candidate receives evenly split partial marks for every option selected true
combinations collection If combination marking is selected then the author can define the exact mark a candidate receives when selecting specified answer options. This is an alternative marking method to partial marks as some of the options may be more important than others. null
combinations / id int The unique id of the answer option combination. n/a
combinations / Mark int The mark assigned to the answer option combination. n/a
combinations / Title string The title assigned to the answer option combination. n/a
combinations / Options collection A collection of the answer options included within the combination. n/a
combinations / Options / Id int The id of the answer option within the combination. n/a
combinations / Options / Text string The label of the answer option within the combination. n/a
addLabelsToOptions boolean This identifies if labels will be shown to the candidate on each answer option. false
markType enumeration The type of marking that will be applied to the multiple response question type.
Available values: "Standard", "Weighted" or "Combination".
Standard
randomise boolean This flag determines if the answer options are randomised when the candidate views this in delivery. false
answerWidthRatio enumeration If multiple answer columns are defined then this property identifies the ratio of the columns in the answer options.
Available values: "50/50", "20/80", "80/20".
null
optionList / options collection A collection of answer options that will be displayed to the candidate null
optionList / options / assistiveMedia object Any assistive media that has been assigned to an answer option that is use to provide additional information to the candidate in delivery. null
optionList / options /  assistiveMedia / id int The id of the assistive media in context of the item. n/a
optionList / options /  assistiveMedia / href string The request URL required to return the assistive media file in base 64 encoded format.  n/a
optionList / options / id int The id of the answer options. This can be used in the combination group to identify the answer option. n/a
optionList / options / contentType enumeration The type of content included within the answer option.
Available values: "RichText", "Image", "MathML"
n/a
optionList / options / text HTML The text included in the answer option in HTML format. If multiple columns are used this will only display the first. n/a
optionList / options / htmlText HTML The text included in the answer option in HTML format. Retired property. n/a
optionList / options / mathMl MathML The equation supplied in the answer option in MathML format. If multiple columns are used this will only display the first. n/a
optionList / options / mediaItem object Any media that has been assigned to an answer option. If multiple columns are used this will only display the first. n/a
optionList / options / mediaItem / id int The id of the media included in the answer option from the Media Library.
The ID relates to the Media resource in the Surpass API.
n/a
optionList / options / correct boolean This flag identifies is the option is correct. This is not returned if the "Combination" marking type has been selected. n/a X
(Live)
optionList / options / label string The label that has been assigned to the answer option. n/a
optionList / options / weightedMark int The weighted mark assigned to the answer option. This is only returned when the marking type is "Weighted". This can be a positive or a negative integer. null
optionList / options / rationaleText string The rationale associated with an answer option to explain why it has been included. n/a
optionList / options / answerColumns collection A collection of content used on a particular answer option. This allows the user to define and identify if one single answer option has two types of content i.e. Text, Media, Equation. If only one is defined then only one object will be returned in this collection. n/a
optionList / options / answerColumns / text HTML The text included in the column of the answer option in HTML format. n/a X
(Live)
optionList / options / answerColumns / mathMl MathML The equation included in the column of the answer option in MathML format. n/a
optionList / options / answerColumns / media object The media included in the column of the answer option from the Media Library. n/a
optionList / options / answerColumns / media / id int The id of the media included within the column of the answer option.
The id relates to the Media resource in the Surpass API.
n/a
tableOptionsHtml html The ability to import and export a table in HTML format that allows a candidate to select a specific row as their answer rather than an MRQ option. The correct answer is identified using the above "options > correct" property. This is only available in HTML subjects in item authoring. n/a
rationaleEnabled boolean This identifies whether rationale is enabled for each answer option. false

Feedback and Knowledge Base