EdX Open Learning XML Guide - Alpha Version
  • 1. General Information
    • 1.1. Read Me
    • 1.2. Other edX Resources
    • 1.3. edX Browser Support
    • 1.4. Change Log
  • 2. What is Open Learning XML?
    • 2.1. XML Resources
  • 3. Getting Started with OLX
  • 4. OLX Course Structure
    • 4.1. OLX and Directory File Structures
    • 4.2. Top-level Directory
    • 4.3. XBlock Directories
    • 4.4. edX Platform Directories
  • 5. Policies
    • 5.1. Course Policies
    • 5.2. Grading Policy
    • 5.3. Course Asset Policy
  • 6. Course Assets
  • 7. The Course About Pages
    • 7.1. Course Overview
    • 7.2. Short Description
  • 8. Course Tabs
    • 8.1. Create the Tab File
  • 9. Organizing Courseware
    • 9.1. OLX Course Building Blocks
    • 9.2. The Courseware Structure
  • 10. Course Components (XBlocks)
    • 10.1. HTML Components
    • 10.2. Discussion Components
    • 10.3. Video Components
    • 10.4. Problem Components
  • 11. Exercises, Tools, and Problem Types
    • 11.1. Levels of Support
    • 11.2. Annotation Problem
    • 11.3. Checkbox Problem
    • 11.4. Chemical Equation Problem
    • 11.5. Circuit Schematic Builder Problem
    • 11.6. Completion Tool
    • 11.7. Conditional Module
    • 11.8. Custom JavaScript Display and Grading Problem
    • 11.9. Write-Your-Own-Grader Problem
    • 11.10. Drag and Drop Problem
    • 11.11. Dropdown Problem
    • 11.12. Full Screen Image Tool
    • 11.13. Gene Explorer Tool
    • 11.14. Google Calendar Tool
    • 11.15. Google Drive Files Tool
    • 11.16. Iframe Tool
    • 11.17. Image Mapped Input Problem
    • 11.18. LTI Component
    • 11.19. Math Expression Input Problems
    • 11.20. Using MathJax for Mathematics
    • 11.21. Molecule Editor Tool
    • 11.22. Multiple Choice and Numerical Input Problem
    • 11.23. Multiple Choice Problem
    • 11.24. Numerical Input Problem
    • Open Response Assessments
    • 11.25. Periodic Table Tool
    • 11.26. Poll Tool for OLX
    • 11.27. Poll Tool
    • 11.28. Problem Written in LaTeX
    • 11.29. Problem with Adaptive Hint
    • 11.30. Protex Protein Builder Tool
    • 11.31. Recommender Tool
    • 11.32. Survey Tool
    • 11.33. Symbolic Response
    • 11.34. Text Input Problem
    • 11.35. Word Cloud Tool
    • 11.36. Zooming Image Tool
  • 12. Content Experiments
    • 12.1. Overview of Content Experiments
    • 12.2. Guidelines for Modifying Group Configurations
    • 12.3. Set Up Group Configuration for OLX Courses
    • 12.4. Add a Content Experiment in OLX
    • 12.5. Test Content Experiments
  • 13. Example of an OLX Course
    • 13.1. The Structure of edX-Insider
    • 13.2. The edX-Insider course.xml File
  • 14. Example of OLX for a Studio Course
    • 14.1. The Structure of the Manual Testing Course
  • 15. Open Learning XML Uses
    • 15.1. Use OLX with edX Studio
    • 15.2. Build a Course in OLX and Deploy to the edX LMS
    • 15.3. Convert Content in Other Formats to OLX
  • 16. Draft Course Content
  • 17. Glossary
    • 17.1. A
    • 17.2. C
    • 17.3. D
    • 17.4. E
    • 17.5. F
    • 17.6. G
    • 17.7. H
    • 17.8. I
    • 17.9. K
    • 17.10. L
    • 17.11. M
    • 17.12. N
    • 17.13. O
    • 17.14. P
    • 17.15. Q
    • 17.16. R
    • 17.17. S
    • 17.18. T
    • 17.19. U
    • 17.20. V
    • 17.21. W
    • 17.22. XYZ
 
EdX Open Learning XML Guide - Alpha Version
  • Table of Contents »
  • 11.11. Dropdown Problem
  • Need Help? |Feedback

11.11. Dropdown Problem¶

Note

EdX offers full support for this problem type.

The dropdown problem type is a core problem type that can be added to any course. At a minimum, dropdown problems include a question or prompt and several answer options. By adding hints, feedback, or both, you can give learners guidance and help when they work on a problem.

  • Overview
    • Example Dropdown Problem
    • Analyzing Performance on Dropdown Problems
  • Adding a Dropdown Problem
    • Use the Simple Editor to Add a Dropdown Problem
    • Use the Advanced Editor to Add a Dropdown Problem
  • Adding Feedback to a Dropdown Problem
    • Configuring Feedback in the Simple Editor
    • Configuring Feedback in the Advanced Editor
    • Customizing Feedback Labels
  • Adding Hints to a Dropdown Problem
    • Configure Hints in the Simple Editor
    • Configure Hints in the Advanced Editor
  • Dropdown Problem OLX Reference
    • Template
    • Elements

For more information about the core problem types, see Working with Problem Components.

11.11.1. Overview¶

In dropdown problems, learners select one option from a list of answer options. Unlike multiple choice problems, where the answer choices are always visible directly below the question, the answer options for dropdown problems do not appear until the learner selects the dropdown arrow.

11.11.1.1. Example Dropdown Problem¶

In the LMS, learners select a single answer option to complete a dropdown problem. An example of a completed dropdown problem follows.

A problem component that contains a series of three dropdown problems. The questions have been answered, and two are marked incorrect and one correct.

In this example, a single problem component contains multiple questions, all of them using the dropdown problem type. To add the example illustrated above, you enter the following text and Markdown formatting in the simple editor in Studio. Then, select Settings for the problem to define settings. To specify that each question is worth one point, leave the Problem Weight field empty.

>>What type of data is age?<<
[[Nominal, Discrete, (Continuous)]]
---
>>What type of data is age, when rounded to the nearest year?<<
[[
Nominal
(Discrete)
Continuous
]]
---
>>What type of data is life stage, such as infant, child, or adult?<<
[[(Nominal), Discrete, Continuous]]

Note

You separate multiple questions in a problem component with three hyphen (---) characters. You can separate the answer options with either comma (,) characters or new lines.

The OLX markup for this example problem follows.

<problem>
  <optionresponse>
    <label>What type of data is age?</label>
    <optioninput options="('Nominal','Discrete','Continuous')"
     correct="Continuous"></optioninput>
  </optionresponse>
  <optionresponse>
    <label>What type of data is age, when rounded to the nearest year?</label>
    <optioninput options="('Nominal','Discrete','Continuous')"
     correct="Discrete"></optioninput>
    </optionresponse>
  <optionresponse>
    <label>What type of data is life stage, such as infant, child, or adult?</label>
    <optioninput options="('Nominal','Discrete','Continuous')"
     correct="Nominal"></optioninput>
  </optionresponse>
</problem>

11.11.1.2. Analyzing Performance on Dropdown Problems¶

For the dropdown problems in your course, you can use edX Insights to review aggregated learner performance data and examine submitted answers. For more information, see Using edX Insights.

11.11.2. Adding a Dropdown Problem¶

You add dropdown problems in Studio by selecting the Problem component type and then using either the simple editor or the advanced editor to specify the prompt and the answer options.

  • Use the Simple Editor to Add a Dropdown Problem
  • Use the Advanced Editor to Add a Dropdown Problem

Note

You can begin work on the problem in the simple editor, and then switch to the advanced editor. However, after you save any changes you make in the advanced editor, you cannot switch back to the simple editor.

11.11.2.1. Use the Simple Editor to Add a Dropdown Problem¶

When you add a dropdown problem, you can choose one of these templates.

  • Dropdown
  • Dropdown with Hints and Feedback

These templates include the Markdown formatting that you use in the simple editor to add a problem without, or with, hints and feedback.

To use the simple editor to add a problem, follow these steps.

  1. In the unit where you want to create the problem, under Add New Component select Problem.

  2. From the list of Common Problem Types, select the type of problem you want to add. Studio adds a template for the problem to the unit.

  3. Select Edit. The simple editor opens to a template that shows the Markdown formatting that you use for this problem type.

  4. Replace the guidance provided by the template to add your own text for the question or prompt, answer options, explanation, and so on.

    To format equations, you can use MathJax. For more information, see Using MathJax for Mathematics.

  5. Select Settings to provide an identifying Display Name and define settings for the problem. For more information, see Defining Settings for Problem Components.

  6. Select Save.

11.11.2.2. Use the Advanced Editor to Add a Dropdown Problem¶

You can use the advanced editor to identify the elements of a dropdown problem with OLX. For more information, see Dropdown Problem OLX Reference.

To use the advanced editor to add a problem, follow these steps.

  1. Follow steps 1-3 for creating the problem in the simple editor.

  2. Select Advanced Editor. The advanced editor opens the template and shows the OLX markup that you can use for this problem type.

  3. Replace the guidance provided by the template to add your own text. For example, replace the question or prompt, answer options, and explanation.

    To format equations, you can use MathJax. For more information, see Using MathJax for Mathematics.

  4. Update the OLX to add optional elements and attributes required for your problem.

  5. Select Settings to provide an identifying Display Name and define settings for the problem. For more information, see Defining Settings for Problem Components.

  6. Select Save.

11.11.3. Adding Feedback to a Dropdown Problem¶

For an overview of feedback in problems, see Adding Feedback and Hints to a Problem. You can add feedback for each of the answer options you provide in the problem. Use the following guidelines when providing feedback.

  • Use feedback for the incorrect answers to target common misconceptions and mistakes.
  • Ensure feedback provides some guidance to the learner about how to arrive at the correct answer.
  • Use feedback for the correct answer to reinforce why the answer is correct. Because learners are able to guess, ensure that feedback provides a reason why the answer is correct for learners who might have selected that answer by chance.

You can add feedback in a dropdown problem using the simple editor or the advanced editor.

11.11.3.1. Configuring Feedback in the Simple Editor¶

You can configure feedback in the simple editor. When you add a dropdown problem, select the template Dropdown with Hints and Feedback. This template has example feedback syntax that you can replace.

[[
Wrong Answer {{Feedback for learners who select this answer.}}
Wrong Answer {{Feedback for learners who select this answer.}}
(Correct Answer) {{Feedback for learners who select this answer.}}
]]

Note

When you include feedback, you might find it more convenient to use new lines to separate the answer options.

For example, the following problem has feedback for each possible answer.

>>A/an ________ is an example of a vegetable.<<

[[
  apple {{An apple is the fertilized ovary that comes from an apple tree and
    contains seeds classifying it as a fruit.}}
  pumpkin {{A pumpkin is the fertilized ovary of a squash plant and contains
    seeds classifying it as a fruit.}}
  (potato) {{A potato is an edible part of a plant in tuber form and is
    classified as a vegetable}}
  tomato {{Many people mistakenly think a tomato is a vegetable. However,
    because a tomato is the fertilized ovary of a tomato plant and contains
    seeds it is classified as a fruit.}}
]]

11.11.3.2. Configuring Feedback in the Advanced Editor¶

In the advanced editor, you configure answer feedback with the following syntax.

<option correct="False">Option Label
  <optionhint>Feedback for when a learner selects this incorrect answer.</optionhint>
</option>

For example, the following problem has feedback for each answer.

<problem>
  <optionresponse>
    <label>A/an ________ is an example of a vegetable.</label>
    <optioninput>
      <option correct="False">apple
        <optionhint>An apple is the fertilized ovary that comes from an
         apple tree and contains seeds classifying it as a fruit.</optionhint>
      </option>
      <option correct="False">pumpkin
        <optionhint>A pumpkin is the fertilized ovary of a squash plant and
         contains seeds classifying it as a fruit.</optionhint>
      </option>
      <option correct="True">potato
        <optionhint>A potato is an edible part of a plant in tuber form and
         is classified as a vegetable.</optionhint>
      </option>
      <option correct="False">tomato
        <optionhint>Many people mistakenly think a tomato is a vegetable.
         However, because a tomato is the fertilized ovary of a tomato plant
         and contains seeds it is classified as a fruit.</optionhint>
      </option>
    </optioninput>
  </optionresponse>
</problem>

11.11.3.3. Customizing Feedback Labels¶

By default, the feedback labels shown to learners are Correct and Incorrect. If you do not define feedback labels, learners see these terms when they submit an answer, as in the following example.

Incorrect:
An apple is the fertilized ovary that comes from an apple tree and contains
seeds classifying it as a fruit.

You can configure the problem to override the default labels. For example, you can configure a custom label for a specific wrong answer.

Not Quite:
Many people mistakenly think a tomato is a vegetable. However, because a
tomato is the fertilized ovary of a tomato plant and contains seeds it is
classified as a fruit.

Note

The default labels Correct and Incorrect display in the learner’s requested language. If you provide custom labels, they display as you define them to all learners. They are not translated into different languages.

11.11.3.3.1. Customize Feedback Labels in the Simple Editor¶

In the simple editor, you configure custom feedback labels with the following syntax.

[[
Incorrect Answer {{Label:: Feedback for learners who select this answer.}}
.
.
.
]]

That is, you provide the label text, followed by two colon (:) characters, before the feedback text.

For example, the following feedback is configured to use a custom label.

[[
tomato {{Not Quite:: Many people mistakenly think a tomato is a
vegetable. However, because a tomato is the fertilized ovary of a tomato
plant and contains seeds, it is a fruit.}}
.
.
.
]]

11.11.3.3.2. Customize Feedback Labels in the Advanced Editor¶

In the advanced editor, you configure custom feedback labels with the following syntax.

<option correct="False">Answer
  <optionhint label="Custom Label">Feedback for learners who select this answer.</optionhint>
</option>

For example, the following feedback is configured to use a custom label.

<option correct="False">tomato
  <optionhint label="Not Quite">Many people mistakenly think a tomato is a
   vegetable. However, because a tomato is the fertilized ovary of a tomato
   plant and contains seeds it is classified as a fruit.</optionhint>
</option>

11.11.4. Adding Hints to a Dropdown Problem¶

You can add hints to a dropdown problem using the simple editor or the advanced editor. For an overview of hints in problems, see Adding Feedback and Hints to a Problem.

11.11.4.1. Configure Hints in the Simple Editor¶

In the simple editor, you configure hints with the following syntax.

||Hint 1||
||Hint 2||
||Hint n||

Note

You can configure any number of hints. The learner views one hint at a time and views the next one by selecting Hint again.

For example, the following problem has two hints.

||A fruit is the fertilized ovary from a flower.||
||A fruit contains seeds of the plant.||

11.11.4.2. Configure Hints in the Advanced Editor¶

In the advanced editor, you add the <demandhint> element immediately before the closing </problem> tag, and then configure each hint using the <hint> element.

.
.
.
<demandhint>
  <hint>Hint 1</hint>
  <hint>Hint 2</hint>
  <hint>Hint 3</hint>
</demandhint>
</problem>

For example, the following OLX for a multiple choice problem shows two hints.

.
.
.
</multiplechoiceresponse>
<demandhint>
  <hint>A fruit is the fertilized ovary from a flower.</hint>
  <hint>A fruit contains seeds of the plant.</hint>
</demandhint>
</problem>

11.11.5. Dropdown Problem OLX Reference¶

11.11.5.1. Template¶

<problem>
  <optionresponse>
    <label>Question or prompt text</label>
    <description>Optional information about how to answer the question</description>
    <option correct="False">Option Label
      <optionhint>Feedback for when learner selects this answer.</optionhint>
    </option>
    <option correct="True">Option Label
      <optionhint>Feedback for when learner selects this answer.</optionhint>
    </option>
    <solution>
      <div class="detailed-solution">
        <p>Explanation or Solution Header</p>
        <p>Explanation or solution text</p>
      </div>
    </solution>
  </optionresponse>
  <demandhint>
    <hint>Hint 1</hint>
    <hint>Hint 2</hint>
    <hint>Hint 3</hint>
  </demandhint>
</problem>

11.11.5.2. Elements¶

For dropdown problems, the <problem> element can include this hierarchy of child elements.

<optionresponse>
    <label>
    <description>
    <optioninput>
          <option>
              <optionhint>
    <solution>
<demandhint>
    <hint>

In addition, standard HTML tags can be used to format text.

11.11.5.2.1. <optionresponse>¶

Required. Indicates that the problem is a dropdown problem.

11.11.5.2.1.1. Attributes¶

None.

11.11.5.2.1.2. Children¶
  • <label>
  • <description>
  • <optioninput>
  • <solution>

11.11.5.2.2. <label>¶

Required. Identifies the question or prompt. You can include HTML tags within this element.

11.11.5.2.2.1. Attributes¶

None.

11.11.5.2.2.2. Children¶

None.

11.11.5.2.3. <description>¶

Optional. Provides clarifying information about how to answer the question. You can include HTML tags within this element.

11.11.5.2.3.1. Attributes¶

None.

11.11.5.2.3.2. Children¶

None.

11.11.5.2.4. <optioninput>¶

Required. Designates an answer option.

11.11.5.2.4.1. Attributes¶
Attribute Description
options

Either this attribute or a set of <option> child elements for <optioninput> is required. Accepts a comma separated list of values in the following format.

options="('Answer1','Answer2','Answer3')"

correct Used if the options attribute is set. Required. Indicates which of the answer options is correct.
11.11.5.2.4.2. Children¶
  • <option>
  • <optionhint>

11.11.5.2.5. <option>¶

Designates an answer option. Either a set of <option> child elements or the options attribute for <optioninput> is required.

11.11.5.2.5.1. Attributes¶
Attribute Description
correct Required. Indicates whether the answer option is correct or incorrect. When set to "true", the choice is a correct answer. At least one required. When set to "false", the choice is an incorrect answer.

If the <option> element is used, <optionhint> is a child of <option>.

11.11.5.2.6. <optionhint>¶

Optional. Specifies feedback for the answer.

11.11.5.2.6.1. Attributes¶

None.

11.11.5.2.6.2. Children¶

None.

11.11.5.2.7. <solution>¶

Optional. Identifies the explanation or solution for the problem, or for one of the questions in a problem that contains more than one question.

This element contains an HTML division <div>. The division contains one or more paragraphs <p> of explanatory text.

11.11.5.2.8. <demandhint>¶

Optional. Specifies hints for the learner. For problems that include multiple questions, the hints apply to the entire problem.

11.11.5.2.8.1. Attributes¶

None.

11.11.5.2.8.2. Children¶

<hint>

11.11.5.2.9. <hint>¶

Required. Specifies additional information that learners can access if needed.

11.11.5.2.9.1. Attributes¶

None.

11.11.5.2.9.2. Children¶

None.

Next Previous

Copyright © 2016, edX Inc.
Creative Commons License
These works by edX Inc. are licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.