Extended Matching Item Resource

Item Resource - Extended Matching

An Extended Matching question type uses two columns of boxes in the answer options. Candidates are required to make the correct links between the relevant boxes.

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 extended matching questions, including any mandatory minimum properties is as follows:

{
"subject":{
                "reference": "BTLSF"
},
"name": "EM API Test",
  "extendedMatchingQuestions": [
{
"linkingType": "oneToOne",
      "leftBoxes": [
        {
          "text": "Left Box 1"
        },
      {
          "text": "Left Box 2"
        }
      ],
      "rightBoxes": [
        {
          "text": "Right Box 1"
        },
                {
          "text": "Right Box 2"
        }
      ]
    }
  ]
}

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 GET/{id} methods in XML and JSON format:

GET/{id} - Item Extended Matching - JSON Example

GET/{id} - Item Extended Matching - XML Example


Property Name Type Description Default Value
(POST)
Mandatory for
create (POST)
linkingType enumeration The candidate selection type for the extended matching question. Available values: "oneToOne", "oneToMany", “manyToOne” and “manyToMany”. oneToOne X
weightedMarking boolean The marking type assigned to answer options. This identifies if weighted marking has been enabled. false
leftBoxes / id int The id of the left box answer option component. n/a
leftBoxes / id / text HTML The answer option text supplied in HTML format. This will only ever return the first answer option column. null X
rightBoxes / id int The id of the left box answer option component. n/a
rightBoxes / id / text HTML The answer option text supplied in HTML format. This will only ever return the second answer option column. null X
correctLinks / leftBoxId int The id of the left box answer option component. This must map to the left box ID. n/a
correctLinks / leftBoxId / rightBoxId int The id of the left box answer option component. This must map to the right box ID. n/a
correctLinks / leftBoxId / rightBoxId / mark int The mark to attribute to the link made between the boxes. 1
enableManyToManyMarking boolean This identifies the type of weighted marking that has been enabled. false

Feedback and Knowledge Base