8.44. Text Input Problem¶

8.44.3.1. Use the Simple Editor to Create a Text Input Problem¶

To use the simple editor to create a text input problem, follow these steps.

1. In the unit where you want to create the problem, under Add New Component select Problem.
2. Select one of the two text input problem templates.

• From the list of Common Problem Types, select Text Input.

• From the list of Common Problems with Hints and Feedback, select Text Input with Hints and Feedback. For more information, see Use Feedback in a Text Input Problem.

  Studio adds the problem to the unit.

1. Select Edit. The simple editor opens.

2. Replace the sample problem text with your own text.

3. Determine the text that describes the question you want learners to answer, and surround that text with two pairs of angle brackets (>>question<<). This text identifies the question for screen readers, reports, and Insights.

4. Select the text of the problem’s answer, and then select Text Input from the toolbar. An equals signe (=) appears next to the answer.

   You can identfy more than one correct answer. For more information, see Multiple Responses in Text Input Problems.

5. To provide an explanation, select the explanation text and then select Explanation from the toolbar. [explanation] appears before and after the explanation text.

6. Select Settings and provide an identifying Display Name for the problem.

7. Define additional settings for the problem. For more information, see Problem Settings.

8. Select Save.

For the example problem illustrated above, the following text displays in the problem component.

>>What was the first post-secondary school in China to allow both male and
female students?<<

= Nanjing Higher Normal Institute
or= National Central University
or= Nanjing University

[explanation]
Nanjing Higher Normal Institute first admitted female students in 1920.
[explanation]

8.44.3.2. Use the Advanced Editor to Edit a Text Input Problem¶

To use the advanced editor to edit a text input problem, follow these steps.

1. Follow the steps for creating the problem in the simple editor.
2. Select Advanced Editor, and then edit the XML to add the tags and attributes you want. An example follows.

Problem Code:

<problem>
  <p>What was the first post-secondary school in China to allow both male and female students?</p>

  <stringresponse answer="Nanjing Higher Normal Institute" type="ci" >
    <additional_answer>National Central University</additional_answer>
    <additional_answer>Nanjing University</additional_answer>
    <textline label="What was the first post-secondary school in China to
      allow both male and female students?" size="20"/>
  </stringresponse>
  <solution>
    <div class="detailed-solution">
      <p>Explanation</p>
      <p>Nanjing Higher Normal Institute first admitted female students in
      1920.</p>
    </div>
  </solution>
</problem>

8.44.4.1. Configure Feedback in the Simple Editor¶

In the simple editor, you configure answer feedback with the following syntax. When you create a new text input problem, select the template Text Input with Hints and Feedback. This template has example feedback syntax that you can replace.

= Correct Answer {{Feedback for learners who select this answer.}}
not= Incorrect Answer {{Feedback for learners who select this answer.}}

For example, the following problem has feedback for the correct answer and two common incorrect answers.

>>What is the largest state in the U.S. in terms of land area?<<

=Alaska {{Alaska is the largest state in the U.S. in terms of not only land
area, but also total area and water area. Alaska is 576,400 square miles,
more than double the land area of the second largest state, Texas.}}

not=Texas {{While many people think Texas is the largest state in terms of
land area, it is actually the second largest and contains 261,797 square
miles.}}

not=California {{California is the third largest state and contains 155,959
square miles.}}

8.44.4.2. Configure Feedback in the Advanced Editor¶

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

<stringresponse answer="Correct Answer" type="ci" >
  <correcthint>Hint for correct answer.</correcthint>
  <stringequalhint answer="Incorrect Anser">
    Hint for incorrect answer.
  </stringequalhint>
</stringresponse>

For example, the following problem has feedback for the correct answer and two common incorrect answers.

<problem>

  <p>What was the first post-secondary school in China to allow both male and female students?</p>
  <stringresponse answer="Alaska" type="ci" >
    <correcthint>
      Alaska is the largest state in the U.S. in terms of not only land
      area, but also total area and water area. Alaska is 576,400 square
      miles, more than double the land area of the second largest state,
      Texas.
    </correcthint>
    <stringequalhint answer="Texas">
      While many people think Texas is the largest state in terms of land
      area, it is actually the second largest of the 50 U.S. states
      containing 261,797 square miles.
    </stringequalhint>
    <stringequalhint answer="California">
      California is the third largest state in the U.S. in terms of land
      area containing 155,959 square miles.</stringequalhint>
    <textline label="What is the largest state in the U.S. in terms of land
      area?" size="20"/>
  </stringresponse>
</problem>

8.44.4.3. Customize 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.

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

not=Answer {{Label:: Feedback}}

not=Texas {{Close but wrong:: While many people think Texas is the largest
state in terms of land area, it is actually the second largest of the 50 U.S.
states, containing 261,797 square miles.}}

<stringequalhint answer="Incorrect Anser" label="Custom Label">
  Feedback
</stringequalhint>

<stringequalhint answer="Texas" label="Close but wrong">
  While many people think Texas is the largest state in terms of land
  area, it is actually the second largest of the 50 U.S. states containing
  261,797 square miles.
</stringequalhint>

8.44.5.1. Configure Hints in the Simple Editor¶

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

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

For example, the following problem has two hints.

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

8.44.5.2. Configure Hints in the Advanced Editor¶

In the advanced editor, you configure each hint in the <hint> element within the <demandhint> element.

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

For example, the following XML shows two hints.

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

8.44.6.1. Simple Editor¶

To specify additional correct responses in the simple editor, include``or= `` before each additional correct response.

>>What African-American led the United States civil rights movement during
the 1960s?<<
= Dr. Martin Luther King, Jr.
or= Dr. Martin Luther King, Junior
or= Martin Luther King, Jr.
or= Martin Luther King

8.44.6.2. Advanced Editor¶

To specify additional correct responses in the advanced editor, add an <additional_answer> for each correct response inside the opening and closing <stringresponse> tags.

<problem>

<p>What African-American led the United States civil rights movement during the 1960s?</p>

<stringresponse answer="Dr. Martin Luther King, Jr." type="ci" >
  <additional_answer>Dr. Martin Luther King, Junior</additional_answer>
  <additional_answer>Martin Luther King, Jr.</additional_answer>
  <additional_answer>Martin Luther King</additional_answer>
  <textline label="What African-American led the United States civil rights
    movement during the 1960s?" size="20"/>
</stringresponse>
</problem>

8.44.11.1. Template¶

<problem>
    <p>Problem text</p>
    <stringresponse answer="Correct answer 1" type="ci regexp">
        <additional_answer>Correct answer 2</additional_answer>
        <additional_answer>Correct answer 3</additional_answer>
        <textline size="20" label="label text"/>
        <correcthint>Provides feedback when learners submit the correct response.</correcthint>
        <stringequalhint answer="Incorrect answer 1">Provides feedback when learners submit the specified incorrect response.</stringequalhint>
        <stringequalhint answer="Incorrect answer 2">Provides feedback when learners submit the specified incorrect response.</stringequalhint>
        <textline label="Which U.S. state has the largest land area?" size="20"/>
    </stringresponse>

    <demandhint>
      <hint>The first text string to display when learners request a hint.</hint>
      <hint>The second text string to display when learners request a hint.</hint>
    </demandhint>
</problem>

8.44.11.2. Tags¶

• <stringresponse>: Indicates that the problem is a text input problem. The <stringresponse> tag has the following child tags.
  • <textline>: Creates the response field in the LMS where the learner enters a response.
  • <additional_answer> (optional): Specifies an additional correct answer for the problem. A problem can contain an unlimited number of additional answers.
  • <correcthint> (optional): Specifies feedback for the correct answer.
  • <stringequalhint> (optional): Specifies feedback for an incorrect answer.
• <demandhint> (optional): Specifies one or more hints that learners can request to help them arrive at the correct answer. The <demandhint> tag has a child tag of <hint>.

Tag: <stringresponse>

Indicates that the problem is a text input problem.

Attributes

Attribute	Description
answer (required)	Specifies the correct answer. To designate the answer as a regular expression, add “regexp” to the type attribute. If you do not add “regexp” to the type attribute, the learner’s answer must match the value in this attribute exactly.
type (optional)	Specifies whether the problem requires a case sensitive response and if it allows regular expressions. If the <stringresponse> tag includes type="ci", the problem is not case sensitive. If the tag includes type="cs", the problem is case sensitive. If the tag includes type="regexp", the problem allows regular expressions. A type attribute in a <stringresponse> tag can also combine these values. For example, <stringresponse type="regexp cs"> specifies that the prolem allows regular expressions and is case sensitive.

Children

• <textline /> (required)
• <additional_answer> (optional)
• <correcthint> (optional)
• <stringequalhint> (optional)

Tag: <textline />

Creates a response field in the LMS where the learner enters a response.

Attributes

Attribute	Description
label (required)	Contains the text of the problem.
size (optional)	Specifies the size, in characters, of the response field in the LMS.
hidden (optional)	If set to “true”, learners cannot see the response field.
correct_answer (optional)	Lists the correct answer to the problem.
trailing_text	Adds the text that you specify after the response field.

Children

(none)

Tag: <additional_answer>

Specifies an additional correct answer for the problem. A problem can contain an unlimited number of additional answers.

Attributes

(none)

Children

(none)

Tag: <correcthint>

Indicates that the course team has provided hints for certain common incorrect answers.

Attributes

(none)

Children

(none)

Tag: <stringequalhint>

Specifies the feedback for an incorrect answer.

Attributes

Attribute	Description
answer (required)	The text of the incorrect answer.

Children

(none)

Tag: <demandhint>

Specifies one or more hints that learners can request to help them arrive at the correct answer.

Attributes

(none)

Children

Tag: <hint>

Contains the text of a hint. The LMS shows each of the defined hints to the learners in the order that the <hint> tags are included within the <demandhint> tag.