Item - 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 | |
| exclusiveOption | boolean | This identifies if the item contains an exclusive answer option. This is set to true when an answer option is an exclusive option. | n/a |