188 lines
7.1 KiB
ReStructuredText
188 lines
7.1 KiB
ReStructuredText
.. _Specialized Problems:
|
|
|
|
Specialized Problems
|
|
====================
|
|
|
|
Specialized problems are advanced problems such as annotations, open
|
|
response assessments, and word clouds. These problems are available
|
|
through the Advanced component in Studio. To add the Advanced component
|
|
to your course, you'll modify your course's advanced settings. The
|
|
Advanced component then appears under **Add New Component** in each
|
|
unit.
|
|
|
|
- :ref:`Annotation` Annotation problems ask students to respond to
|
|
questions about a specific block of text. The question appears above
|
|
the text when the student hovers the mouse over the highlighted text
|
|
so that students can think about the question as they read.
|
|
- :ref:`Open Response Assessment` Open response assessment problems allow students
|
|
to enter short answer or essay responses that students or a computer
|
|
algorithm can then grade.
|
|
|
|
|
|
.. _ Add Advanced Component:
|
|
|
|
**Add the Advanced Component to Your Course**
|
|
|
|
By default, when you create a new component in Studio, you see the
|
|
following options.
|
|
|
|
.. image:: Images/AddNewComponent.gif
|
|
:alt: Image of the Add a New Component panel
|
|
|
|
To create a specialized problem, you must first add the Advanced
|
|
component to your course. To do this, follow these steps.
|
|
|
|
#. On the **Settings** menu, click **Advanced Settings**.
|
|
|
|
#. On the **Advanced Settings** page, locate the **Manual Policy
|
|
Definition** section, and then locate the **advanced_modules**
|
|
policy key (this key is at the top of the list).
|
|
|
|
.. image:: Images/AdvancedModulesEmpty.gif
|
|
:alt: Image of the Manual Policy Definition section of the Advanced Settings page
|
|
|
|
#. Under **Policy Value**, place your cursor between the brackets, and
|
|
then enter the value for the type of problem that you want to create.
|
|
Make sure to include the quotation marks, but not the period.
|
|
|
|
- For annotations, enter **"annotatable"**.
|
|
|
|
- For open response assessments, enter
|
|
**"combinedopenended","peergrading"**. (Include the comma but no
|
|
spaces between the words.)
|
|
|
|
- For word clouds, enter **"word_cloud"**.
|
|
|
|
You can enter more than one problem type at a time. When you do,
|
|
make sure to surround each problem type with quotation marks and
|
|
separate each problem type with a comma, but do not include any
|
|
spaces.
|
|
|
|
For example, if you wanted to add annotations, open response
|
|
assessments, and word cloud problems in your course, you would enter
|
|
the following between the brackets.
|
|
|
|
::
|
|
|
|
"annotatable","combinedopenended","peergrading","word_cloud"
|
|
|
|
.. image:: Images/AdvSettings_Before.gif
|
|
:alt: Image of the Manual Policy Definition section of the Advanced Settings page, with specialized problems added
|
|
|
|
#. At the bottom of the page, click **Save Changes**.
|
|
|
|
The page refreshes automatically. At the top of the page, you see a
|
|
notification that your changes have been saved.
|
|
|
|
The text in the **Policy Value** field now appears as follows.
|
|
|
|
.. image:: Images/AdvSettings_After.gif
|
|
:alt: Image of the Manual Policy Definition section of the Advanced Settings page, with specialized problems added after saving
|
|
|
|
#. Return to the unit where you want to add the specialized problem. The
|
|
list of possible components now contains an Advanced component.
|
|
|
|
.. image:: Images/AdvancedComponent.gif
|
|
:alt: Image of the Add a New Component panel with the Advanced component option
|
|
|
|
When you click the Advanced component, you see the following list.
|
|
|
|
.. image:: Images/SpecProbs_List.gif
|
|
:alt: Image of the Advanced component list
|
|
|
|
You can now create annotations, open response assessments, and word
|
|
clouds in your course. More information about how to create each problem
|
|
is provided in the page for that problem type.
|
|
|
|
.. _Annotation:
|
|
|
|
Annotation
|
|
----------
|
|
|
|
|
|
In an annotation problem, the instructor highlights specific text
|
|
inside a larger text block and then asks questions about that text. The
|
|
questions appear when students hover the mouse over the highlighted
|
|
text. The questions also appear in a section below the text block, along
|
|
with space for students' responses.
|
|
|
|
.. image:: Images/AnnotationExample.gif
|
|
:alt: Image of an annotation problem
|
|
|
|
Create an Annotation Problem
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
To create an annotation problem:
|
|
|
|
Add the Annotation advanced component. To do this, add the "annotatable"
|
|
key value to the **Advanced Settings** page. (For more information, see
|
|
the instructions in :ref:`Specialized Problems`.)
|
|
|
|
Add the **Instructions** and **Guided Discussion** segments of the
|
|
problem.
|
|
|
|
|
|
#. In the unit where you want to create the problem, click **Advanced**
|
|
under **Add New Component**.
|
|
#. In the list of problem types, click **Annotation**.
|
|
#. In the component that appears, click **Edit**.
|
|
#. In the component editor, replace the example code with your own code.
|
|
#. Click **Save**.
|
|
|
|
|
|
Add the **Annotation problem** segment of the problem.
|
|
|
|
|
|
#. Under the Annotation component, create a new blank Advanced Problem
|
|
component.
|
|
#. Paste the following code in the Advanced Problem component, replacing
|
|
placeholders with your own information.
|
|
|
|
|
|
::
|
|
|
|
<problem>
|
|
<annotationresponse>
|
|
<annotationinput>
|
|
<text>PLACEHOLDER: Text of annotation</text>
|
|
<comment>PLACEHOLDER: Text of question</comment>
|
|
<comment_prompt>PLACEHOLDER: Type your response below:</comment_prompt>
|
|
<tag_prompt>PLACEHOLDER: In your response to this question, which tag below
|
|
do you choose?</tag_prompt>
|
|
<options>
|
|
<option choice="incorrect">PLACEHOLDER: Incorrect answer (to make this
|
|
option a correct or partially correct answer, change choice="incorrect"
|
|
to choice="correct" or choice="partially-correct")</option>
|
|
<option choice="correct">PLACEHOLDER: Correct answer (to make this option
|
|
an incorrect or partially correct answer, change choice="correct" to
|
|
choice="incorrect" or choice="partially-correct")</option>
|
|
<option choice="partially-correct">PLACEHOLDER: Partially correct answer
|
|
(to make this option a correct or partially correct answer,
|
|
change choice="partially-correct" to choice="correct" or choice="incorrect")
|
|
</option>
|
|
</options>
|
|
</annotationinput>
|
|
</annotationresponse>
|
|
<solution>
|
|
<p>PLACEHOLDER: Detailed explanation of solution</p>
|
|
</solution>
|
|
</problem>
|
|
|
|
#. Click **Save**.
|
|
|
|
|
|
.. _Open Response Assessment:
|
|
|
|
Open Response Assessment
|
|
------------------------
|
|
|
|
|
|
In open response assessments, tens of thousands of students can receive feedback
|
|
on written responses of varying lengths as well as files, such as computer code or
|
|
images, that the students upload.
|
|
|
|
|
|
Because open response assessments are more complex than most other problem types,
|
|
they have a separate section. For more information about these problems, see
|
|
:ref:`Open Response Assessment Problems`. |