Skip to main content

Digitizing questions

First choose the question type you want and open the template file for that question type. Next, fill in the template in order to create a question with your own content. Don't forget to save the edited file with an other name. The template files contain HTML tags that relate to different components of the questions. The components used are explained below.

General question components:

The components that are present in every question type are discussed in this section.

  • Question text:
    The actual question can consist of text and/or images. These data are inserted between the <text></text> tags in the template.
  • Answer options:
    The answer options that can be defined depend on the question type and are explained below under "Specific components per question type"
  • Correctness of an answer:
    The correctness of an answer is defined by adding correct="1" to correct answer options and correct="0" to incorrect answer options. The tags in which this information is included depends on the question type and can be either <option correct="0/1">, <mapping correct="0/1">, <sequence correct="0/1"> or <range correct="0/1">. By default, all answer options in the template files are set to incorrect (correct="0"), so always check carefully whether you changed the value for the correct answer option to "1".
  • Hints:
    Generic hints are provided after a student submits a wrong answer. The selection of hints that is presented to the student can be dependent on the amount of submission the student already did. The hints are inserted between the <hint></hint> tags in the template and the conditions for presentation are added by adding mintries and maxtries to the tags. For example:
    <hint mintries="2">hint A</hint>
    <hint mintries="1" maxtries="3">hint b</hint>
    Hint A is presented to the student after he submitted the second incorrect answer (his second try) and does not dissapear anymore until the correct answer is submitted.
    Hint B is presented after the student submits the first incorrect answer (first try) and disappears after the third incorrect answer submitted. The amount of tries inly increases when the answer is changed.
  • Feedback:
    Feedback is provided after a student submits any answer. So both correct and incorrect answers can have feedback assigned. The feedback is only presented after submission of the corresponding answer option and thus disappears when an other answer option is submitted. The feedback is inserted between the <feedback></feedback> tags and can consist of text, images and/or links to additional information.The feedback can also be associated to the amount of tries by using the mintries and maxtries attributes discussed in the hints.
  • Prefix / Postfix:
    Using <prefix></prefix> and <postfix></postfix> you can add html directly before or after the question. With these you can for instance add an image next to a question. Make sure to use <![CDATA[ ]]> if your html would result in invalid XML.

Specific question components

Some components are only part of one or more question types. Those components are discussed per question type.

'Option' type

Tag: <question type="OPTION">

  • Answer options:
    Answer options consist of one or more lines of text and can be placed between the <choice></choice> tags.

'Check' type

Tag: <question type="CHECK" inlinefeedback="1">

  • Inlinefeedback: (optional)
    If inlinefeedback="1" then the feedback on an option is shown together with that option instead of in the general feedback area.
  • Answer options:
    Similar to the 'Option' question type, answer options consist of one or more lines of text and can be placed between the <choice></choice> tags.
  • Feedback:
    Since more than one answer option has te be selected to submit a correct answer, different feedback types are defined. The feedback that is given when all correct answer options are selected is placed between the <correct></correct> tags. The feedback that corresponds to specific answers options is divided in feedback that is presented when an answer option is selected and feedback that is provided when an answer option is not selected. These feedback types are placed between the <feedback></feedback> and <feedbackunselected></feedbackunselected> tags.

'Value' type

Tag: <question type="VALUE">

  • Unit of answer:
    The unit is which the answer has to be submitted (e.g. hours or minutes) is indicated between the <unit></unit> tags.
  • Range of answer option:
    Since the answers submitted to a value question types are numbers, ranges can be defined to obtain answer categories. The range is defined in the <minval></minval> and <maxval></maxval> tags.

'Drag and Drop' type

Tag: <question type="dragdrop" width="200" height="200">

  • Width, Height: (optional)
    The suggested width and height of the question. If the image is larger than the suggested size, the size is automatically enlarged. Set the width or height larger than the image to make it possible to position draggables outside of the image area.
  • The image the dragging takes place on:
    The image the dragging takes place on is inserted using <matchImg src="[attachurl:title_of_image.png]">. The image is then attached in the file attachments part. Make sure the name is identical and deselect the list-box. Hotspots are defined in this picture with the <hotspot> tag: <hotspot identifier="name" shape="shape" coords="#" />. The attributes of this identifier assign a name (identifier) to the hotspot, define the shape (possibilities are "circle", "rect" and "poly") and position (coords) of the hotspot . Rect means rectangular and poly is free shaped. With coords the coordinates will be defined. The coordinates have to be determined with another program, we are working on the addition of this feature.
  • The pictures or words that are dragged:
    The pictures or words that are dragged are called draggables. These draggables are defined within the <draggable> tag.
    For images: <draggable identifier="name" src= "picture.jpg" />. The attributes of this tag assign a name (identifier) to the draggable and the location of the picture itself is inserted after src.
    Text is simply placed between the <draggable identifier="name"></draggable> tags.
  • Examining submissions:
    See Answer matching for how to check the student's answer.
  • startstate:
    You can make the question start with the draggables in a certain location by adding a tag <startstate value="...">. The value to fill in at the dots can be found by placing the draggables at the desired position and clicking the submit button. As a question-editor you will see the code for the current state of the draggables.

'Hotspot' type:

Tag: <question type="hotspot" width="200" height="200">

  • Width, Height: (optional)
    The suggested width and height of the question. If the image is larger than the suggested size, the size is automatically enlarged.
  • Image the pointing takes place on:
    The image the pointing takes place on is inserted using <matchImg src="link to the image">. Hotspots are defined in this picture with the <hotspot> tag: <hotspot identifier="name" shape="shape" coords="#" />. The attributes of this identifier assign a name (identifier) to the hotspot, define the shape (possibilities are "circle", "rect" and "poly") and position (coords) of the hotspot . Rect means rectangular and poly is free shaped. With coords the coordinates will be defined. The coordinates have to be determined with another program, we are working on the addition of this feature.
  • Examining submissions:
    See Answer matching for how to check the student's answer.

Fill blanks:

Tag: <question type="fillblanks">

  • Blanks:
    The blanks in the text are defined by hotspots tags: <inlineChoice group="#" identifier="#" />. The group attribute is optional. If it is added, only answer options with the same group attribute are shown in this hotspot.
  • Answer options:
    Answer options are displayed in a dropdown box at the location of the blanks and defined with the <inlineOption group="#" identifier="#"> </inlineOption> tags. The group attribute is optional.
  • Examining submissions:
    See Answer matching for how to check the student's answer.

Select and order:

Tag: <question type="SELECTORDER" duplicates="1" alignment="horizontal" optionheight="2em">

  • Duplicates: (optional)
    Allows a student to use an item multiple times.
  • Alignment: (optional)
    alignment="horizontal" aligns the selectable items horizontally, like words in a sentence. See Select&Order example 3.
  • Optionheight: (optional)
    Fixes the height of the selectable options. This can be needed when the content of different options has different heights and when the alignment is horizontal. Values are according to the W3 CSS specifications. Use em for text content and px for image content.
  • Answer options:
    Answer options consist of one or more lines of text and can be placed between the <choice></choice> tags.
  • Description answer options:
    Descriptions for answer options can be placed between the <description></description> tags. The descriptions are displayed when the user selects an option.
  • Grouped answers:
    Selected answer options can be grouped by users. Creating this possibility occurs by using a numeric option identifier.
  • Examining submissions:
    See Answer matching for how to check the student's answer.
  • startstate:
    You can make the question start with the draggables in a certain location by adding a tag <startstate value="...">. The value to fill in at the dots can be found by placing the draggables at the desired position and clicking the submit button. As a question-editor you will see the code for the current state of the draggables.