Match question

Schema

A match question:
- must satisfy the base-question schema
- must have a random property
- must have a penalty property
- must have a firstSet property
- must have a secondSet property
- may have a solutions property
The random property:
- must be a boolean
The penalty property:
- must be a number
- must be greater than 0
The firstSet property:
- must be an array
- must contain at least one item
- Each item:
  - must satisfy the content schema
  - must be unique
The secondSet property:
- must be an array
- must contain at least one item
- Each item:
  - must satisfy the content schema
  - must be unique
The solutions property:
- must be an array
- must contain at least one solution
- Each solution:
  - must be unique
  - must have a firstId property
  - must have a secondId property
  - must have a score property
  - may have a feedback property
- The firstId property:
  - must be a string
- The secondId property:
  - must be a string
- The score property:
  - must be a number

Examples

Basic

{
  "id": "1",
  "type": "application/x.match+json",
  "content": "Question ?",
  "random": false,
  "penalty": 0,
  "firstSet": [
    {
      "id": "2",
      "type": "text/plain",
      "data": "Item A"
    },
    {
      "id": "3",
      "type": "text/plain",
      "data": "Item B"
    }
  ],
  "secondSet": [
    {
      "id": "4",
      "type": "text/plain",
      "data": "Item C"
    },
    {
      "id": "5",
      "type": "text/plain",
      "data": "Item D"
    }
  ]
}

Solutions

{
  "id": "1",
  "type": "application/x.match+json",
  "content": "Question ?",
  "random": false,
  "penalty": 0,
  "firstSet": [
    {
      "id": "2",
      "type": "text/plain",
      "data": "Item A"
    },
    {
      "id": "3",
      "type": "text/plain",
      "data": "Item B"
    }
  ],
  "secondSet": [
    {
      "id": "4",
      "type": "text/plain",
      "data": "Item C"
    },
    {
      "id": "5",
      "type": "text/plain",
      "data": "Item D"
    }
  ],
  "solutions": [
    {
      "firstId": "2",
      "secondId": "5",
      "score": 2,
      "feedback": "Lorem ipsum"
    },
    {
      "firstId": "3",
      "secondId": "4",
      "score": 0.5
    }
  ]
}

With solution feedback

{
  "id": "1",
  "type": "application/x.match+json",
  "content": "Question ?",
  "random": false,
  "penalty": 0,
  "firstSet": [
    {
      "id": "2",
      "type": "text/plain",
      "data": "Item A"
    },
    {
      "id": "3",
      "type": "text/plain",
      "data": "Item B"
    }
  ],
  "secondSet": [
    {
      "id": "4",
      "type": "text/plain",
      "data": "Item C"
    },
    {
      "id": "5",
      "type": "text/plain",
      "data": "Item D"
    }
  ],
  "solutions": [
    {
      "firstId": "2",
      "secondId": "5",
      "score": 2,
      "feedback": "Lorem ipsum"
    },
    {
      "firstId": "3",
      "secondId": "4",
      "score": 0.5,
      "feedback": "Dolor sit amet"
    }
  ]
}

Text and images

{
  "id": "1",
  "type": "application/x.match+json",
  "random": false,
  "penalty": 0,
  "meta": {
    "authors": [
      {
        "name": "John Doe",
        "status": "Tutor"
      },
      {
        "name": "Jane Doe",
        "email": "jane@mail.com",
        "status": "Professor"
      }
    ],
    "license": "CC",
    "created": "2014-06-23"
  },
  "content": "Question ?",
  "objects": [
    {
      "id": "1",
      "type": "image/png",
      "url": "http://domain.com/image.png",
      "meta": {
        "title": "Lorem sample"
      }
    }
  ],
  "resources": [
    {
      "id": "2",
      "type": "application/pdf",
      "url": "http://domain.com/syllabus.txt"
    }
  ],
  "firstSet": [
    {
      "id": "3",
      "type": "text/plain",
      "data": "Item A"
    },
    {
      "id": "4",
      "type": "text/plain",
      "data": "Item B"
    }
  ],
  "secondSet": [
    {
      "id": "5",
      "type": "image/png",
      "url": "http://domain.com/image-c.png"
    },
    {
      "id": "6",
      "type": "image/png",
      "url": "http://domain.com/image-d.png"
    }
  ],
  "solutions": [
    {
      "firstId": "3",
      "secondId": "6",
      "score": 1.5
    },
    {
      "firstId": "4",
      "secondId": "5",
      "score": 1
    }
  ],
  "feedback": "Lorem ipsum dolor sit amet."
}