Introduction 

This document describes the design approach for enhancing the inQuiry editor and player to support the creation and consumption of the FTB question.

JIRA Issue: IQ-245, IQ-273

Background 

As we are deprecating the ECML Question creation inside the Interactive content editor. So inQuiry would need to have a suitable substitute for all its used capabilities in the (New) Question set editor and Player.

Here’s a list of features currently available and supported by the Interactive Content Editor for FTB Question.  

1. There should be at least one blank 

2. Blanks can be created by using square brackets [[ ]] to indicate words to be made blank in a sentence 

3. Multiple blanks are supported 

4. Keyboard type: 

   1. System (Android / OS) 

   2. English (A-Z, not QWERTY) 

   3. Numbers only 

   4. 26 keys configurable 

5. Partial scoring 

6. Unordered evaluation 

7. Add Image and Audio to Question or Option 

8. Add Math & Scientific Text (Formulae & Equation) to Question or Option 

Problem Statement 

Currently, the QuestionSet editor/Player does not support FTB Question creation and consumption workflow.  How can inQuiry enable the same capabilities in the new QuestionSet Editor and Player with the same features supported by the existing Interactive editor and player?

• The creator should be able to create the Fill In The Blank question with multiple blanks.

• The creator should be able to add the image and Math & Scientific Text (Formulae & Equation) to the Question

• The creator should be able to define scoring and configure the evaluation unordered configuration.

• The consumer should be able to consume the FTB question created by the creator.

Design

In this design approach, inQuiry will cover the creation and consumption workflow changes along with the FTB Data model as per QuML spec.

Creation workflow:

• For creating the question, inQuiry will use the same question component used for other question types.

• The creator can create the blanks using square brackets [[ ]] to indicate words to be made blank in a sentence.

  • The words between [[ ]] will appear as blanks in a player. 
    Example: 'The tree is [[tall]] and [[strong]].'
    The question will be created as: 'The tree is _______ and _______.'
    The correct answers will be tall and strong. 

• The editor will throw a validation error if the question does not contain any answers.

• When a blank is inserted, Answers will be extracted from the question using the regular expression (Ex. /(?:^|)\[\[(.*?(?:\]\]|$)/g )

  • We will refer to the existing code to extract the answers from the questions. Here’s the link: ​https://github.com/Sunbird-Knowlg/sunbird-content-plugins/blob/c7c385c7c3848f4fdeabd4f889a46675ef608cf3/org.ekstep.questionunit.ftb-1.1/editor/controllers/ftb-controller.js#L124

• The current QuestionSet editor has the capability to add the image and Math & Scientific Text to the question. So We will use the same question component for adding the same.

• Question with multiple answers will have Scoring Logic = PARTIAL by default. Thus,

  • All responses entered as correct will get equal marks. The total marks of the question will be divided equally amongst all responses

• Partial scoring and unordered evaluation configuration will be stored as part of the question metadata as below:

  1{ 2 .... 3 "evalUnordered": false, 4 "partialScore": true 5}

  • These configurations required changes in the question schema file.

• All media images will be stored the way we are storing the images for the others question type. For example:

  1// Question HTML 2<figure class="image"> 3 <img src="/assets/public/content/assets/do_2136875639892623361238/download-1.jpg" alt="download (1)" 4 data-asset-variable="do_2136875639892623361238"> 5</figure> 6<p>Who is this ?</p>   7 8// Media body of question 9"media": [{  10"id": "do_2136875639892623361238",  11"type": "image",  12"src": "/assets/public/content/assets/do_2136875639892623361238/download-1.jpg",  13"baseUrl": "https://dev.inquiry.sunbird.org"  14}]  

  (Note: The audio workflow will be not enabled in the new FTB workflow as the new question set editor and QuML Player does not have any audio feature support)
  
  

Consumption workflow:

When rendering the question on the player, consider the following:

• The QuML Player will read the question properties and replace all blanks with a <input> tag as per the QuML spec format. Here’s a sample example:

  1The tree is <input type="text" data-text-interaction data-response-variable="response1"/> and <input type="text" data-text-interaction data-response-variable="response2" />

• Ignoring of white-space and case sensitive will be considered by default at the player level.

By default, The below points will be considered during the evaluation:

1. All user answers will be converted to lowercase and compared against each of the answer variations after converting them also to lowercase.

2. Consider removing white spaces from the user answer and the expected answer variations (trim and also remove embedded white spaces)

Partial scoring

A Scoring Logic can have the following values:

• ALL

  • Full marks are assigned only when all the correct answers are entered.

• PARTIAL

  • Partial scores are assigned of any one or more correct answers entered. The total marks of the question will be divided equally amongst all responses.

The default value of Scoring Logic will be PARTIAL

Unordered evaluation

An Unordered evaluation Logic can have the following values:

• TRUE

  • Answers entered in an unordered sequence will be considered correct answers.

• FALSE

  • Answers entered in an unordered sequence will be not considered correct answers.

The default value of Unordered evaluation will be FALSE

FTB Data Model

The editorState will have two properties called options and question to support storing the multiple values for each blank. This entire block is for the editor’s use. These values are saved as they are entered by the creator.
The question content is obtained from CKEditor will contain the HTML markup of the question text.

For example, <p>capital of india is [[New Delhi]]. and capital of USA is [[New York]]</p>

interactions are the pre-processed data for the player’s use. All the values are converted to lowercase and removed white spaces depending on the evaluation needed on the player side.

responseDeclaration is contain the expected matching indices when comparing the user answers against the expected answers array.

Here’s the new schema structure for the FTB which is as per QuML compliance.

Solution 1 (Recommended) :

1{ 2 "editorState": { 3 "options": [ 4 { 5 "answer": true, 6 "value": { 7 "body": "New Delhi", 8 "value": 0 9 } 10 }, 11 { 12 "answer": true, 13 "value": { 14 "body": "New York", 15 "value": 1 16 } 17 } 18 ], 19 "question": "<p>capital of india is [[New Delhi]]. and capital of USA is [[New York]]</p>" 20 }, 21 "body": "<p>capital of india is [[New Delhi]]. and capital of USA is [[New York]]</p>", 22 "responseDeclaration": { 23 "response1": { 24 "cardinality": "single", 25 "type": "string", 26 "correctResponse": { 27 "value": ["New Delhi", "New York"] 28 }, 29 "mapping": [ 30 { 31 "response": "New Delhi", 32 "outcomes": { 33 "score": 0.5 34 } 35 }, 36 { 37 "response": "New York", 38 "outcomes": { 39 "score": 0.5 40 } 41 } 42 ] 43 } 44 }, 45 "outcomeDeclaration": { 46 "maxScore": 1 47 }, 48 "interactionTypes": [ 49 "text" 50 ], 51 "media": [ 52 { 53 "id": "do_2136875567564144641233", 54 "type": "image", 55 "src": "/assets/public/content/assets/do_2136875567564144641233/download.jpg", 56 "baseUrl": "https://dev.inquiry.sunbird.org" 57 } 58 ], 59 "name": "Fill In The Blanks", 60 "mimeType": "application/vnd.sunbird.question", 61 "objectType": "Question", 62 "primaryCategory": "FTB Question", 63 "qType": "FTB" 64}

In QuML spec ​

the mapping definition does not allow storing of value as string, it’s value type is defined as number

We need to update the spec to support this schema structure.

Pros:

• This approach requires minimal effort to implement.

• Creating the views for both editor and player becomes easier with this structure.

• No need to store the interaction properties as we are storing values as it is.

• Reduce the payload size compare to solution 1 and solution 2.

• Players can easily evaluate the question by comparing the user answers against the expected correctResponse array.

Cons:

• The proposed structure is different from the current structure supported by the QuML spec.

Solution 2:

1{ 2 "editorState": { 3 "options": [{ 4 "answer": true, 5 "value": { 6 "body": "New Delhi", 7 "value": 0 8 } 9 }, 10 { 11 "answer": true, 12 "value": { 13 "body": "New York", 14 "value": 1 15 } 16 }], 17 "question": "<figure class="image"><img src="/assets/public/content/assets/do_2136875567564144641233/download.jpg" alt="download" data-asset-variable="do_2136875567564144641233"></figure><figure class="image"><img src="/assets/public/content/assets/do_2136875567564144641233/download.jpg" alt="download" data-asset-variable="do_2136875567564144641233"></figure> 18 <p>capital of india is [[New Delhi]]. and capital of USA is [[New York]]</p>" 19 }, 20 "body": "<figure class="image"><img src="/assets/public/content/assets/do_2136875567564144641233/download.jpg" alt="download" data-asset-variable="do_2136875567564144641233"></figure> 21 <p>capital of india is [[New Delhi]]. and capital of USA is [[New York]]</p>", 22 "interactions": { 23 "response1": { 24 "type": "text", 25 "options": [{ 26 "label": "New Delhi", 27 "value": 0 28 }, 29 { 30 "label": "New York", 31 "value": 1 32 } 33 ] 34 }, 35 "validation": { 36 "required": "Yes" 37 } 38 }, 39 "responseDeclaration": { 40 "response1": { 41 "cardinality": "multiple", 42 "type": "string", 43 "correctResponse": { 44 "value": [ 45 "0", 46 "1" 47 ] 48 }, 49 "mapping": [ 50 { 51 "response": 0, 52 "outcomes": { 53 "score": 0.5 54 } 55 }, 56 { 57 "response": 1, 58 "outcomes": { 59 "score": 0.5 60 } 61 } 62 ] 63 } 64 }, 65 "outcomeDeclaration": { 66 "maxScore": 1 67 }, 68 "interactionTypes": [ 69 "text" 70 ], 71 "media": [{ 72 "id": "do_2136875567564144641233", 73 "type": "image", 74 "src": "/assets/public/content/assets/do_2136875567564144641233/download.jpg", 75 "baseUrl": "https://dev.inquiry.sunbird.org" 76 }], 77 "name": "Fill In The Blanks", 78 "mimeType": "application/vnd.sunbird.question", 79 "objectType": "Question", 80 "primaryCategory": "FTB Question", 81 "qType": "FTB", 82 "keyboardConfig": { 83 "type": "Device", 84 "customKeys": "" 85 } 86}

Pros:

• This structure is similar to the existing MCQ question structure.

Cons:

• The player needs to perform more operations to evaluate the question as we are storing the value as an index under responseDeclaration.

• Interactions for FTB will only be used for getting the matching indices when comparing the user answers against the expected answers array.

Solution 3:

1{ 2 "editorState": { 3 "options": [ 4 { 5 "answer": true, 6 "value": { 7 "body": "New Delhi", 8 "value": 0 9 } 10 }, 11 { 12 "answer": true, 13 "value": { 14 "body": "New York", 15 "value": 1 16 } 17 } 18 ], 19 "question": "<p>capital of india is [[New Delhi]]. and capital of USA is [[New York]]</p>" 20 }, 21 "body": "<p>capital of india is [[New Delhi]]. and capital of USA is [[New York]]</p>", 22 "interactions": { 23 "response1": { 24 "type": "text", 25 "options": [ 26 { 27 "label": "New Delhi", 28 "value": 0 29 } 30 ] 31 }, 32 "response2": { 33 "type": "text", 34 "options": [ 35 { 36 "label": "New York", 37 "value": 1 38 } 39 ] 40 }, 41 "validation": { 42 "required": "Yes" 43 } 44 }, 45 "responseDeclaration": { 46 "response1": { 47 "cardinality": "single", 48 "type": "string", 49 "correctResponse": { 50 "value": "0" 51 }, 52 "mapping": [ 53 { 54 "response": "0", 55 "outcomes": { 56 "score": 0.5 57 } 58 } 59 ] 60 }, 61 "response2": { 62 "cardinality": "single", 63 "type": "string", 64 "correctResponse": { 65 "value": "1" 66 }, 67 "mapping": [ 68 { 69 "response": "1", 70 "outcomes": { 71 "score": 0.5 72 } 73 } 74 ] 75 } 76 }, 77 "outcomeDeclaration": { 78 "maxScore": 1 79 }, 80 "interactionTypes": [ 81 "text" 82 ], 83 "media": [ 84 { 85 "id": "do_2136875567564144641233", 86 "type": "image", 87 "src": "/assets/public/content/assets/do_2136875567564144641233/download.jpg", 88 "baseUrl": "https://dev.inquiry.sunbird.org" 89 } 90 ], 91 "name": "Fill In The Blanks", 92 "mimeType": "application/vnd.sunbird.question", 93 "objectType": "Question", 94 "primaryCategory": "FTB Question", 95 "qType": "FTB", 96 "keyboardConfig": { 97 "type": "Device", 98 "customKeys": "" 99 } 100}

Pros:

• This structure can define separate behavior for each response.

• Support multiple data types for each response.

Cons:

• Increase the player complexity to evaluate the question.

• Increase the question payload size as we are storing each answer in a separate response for multiple properties.
  For example, response1 and response2 have similar structures. As the number of responseVariables increases this structure will repeat multiple times and each will be storing the same data such as cardinality, type