Single Sourcing: Question Set Editor Integration

This is the proposed engineering implementation to integrate the Question Set Editor inside the Sourcing solution Project Creation workflow, based on this requirements document. (Confluence Document)

Proposed Implementation

1. Create New Project  : Define Scope and Schedule

   • The Program Scope tab (see: "Define Scope and Schedule" in [3] (Google Slide)) is to include the ability to select target collection/questionSet and target content type(s)/question type(s). The contents of the Select Target Collection dropdown are fetched from the collectionCategories array, which must be expanded to include the objects of type questionSet .
     

   // Old Code
    setFrameworkDataToProgram() {
   
   	this.collectionCategories = _.get(this.cacheService.get(this.userService.hashTagId), 'collectionPrimaryCategories'); 
   	
   	const channelCats = _.get(this.cacheService.get(this.userService.hashTagId), 'primaryCategories');
   	
   	this.programScope['targetPrimaryCategories'] = [];
   
   	const channeltargetObjectTypeGroup = _.groupBy(channelCats, 'targetObjectType');
   
   	if (this.enableQuestionSetEditor === 'true') {
   
   	const questionSetCategories = _.get(channeltargetObjectTypeGroup, 'QuestionSet');
   
   	this.programScope['targetPrimaryCategories']  = _.map(questionSetCategories, 'name');
   
   	this.programScope['targetPrimaryObjects'] = questionSetCategories;
   
   	}
   	
   // New Code
    setFrameworkDataToProgram() {
   
   	this.tempCollectionCategories = _.get(this.cacheService.get(this.userService.hashTagId), 'collectionPrimaryCategories'); 
   	
   	const channelCats = _.get(this.cacheService.get(this.userService.hashTagId), 'primaryCategories');
   	
   	this.programScope['targetPrimaryCategories'] = [];
   
   	const channeltargetObjectTypeGroup = _.groupBy(channelCats, 'targetObjectType');
   
   	if (this.enableQuestionSetEditor === 'true') {
   
   	const questionSetCategories = _.get(channeltargetObjectTypeGroup, 'QuestionSet');
   
   	this.programScope['targetPrimaryCategories']  = _.map(questionSetCategories, 'name');
   
   	this.programScope['targetPrimaryObjects'] = questionSetCategories;
   	
   	// Include QuestionSets inside collection categories
   	this.collectionCategories = _.concat(this.tempCollectionCategories || [], this.programScope['targetPrimaryCategories']);
   
   	}
   	

   • Based on a mapping defined via a system-level configuration, the values in the dependent dropdown Select Required Assets will be populated. The mapping may resemble the following:
     
     Mapping Configuration

     [ {
         "identifier": "obj-cat:content-playlist_collection_all",
         "name": "Content Playlist",
         "targetObjectType": "Collection",
         "associatedAssetTypes": ["Content"]
       },  
       {
         "identifier": "obj-cat:demo-practice-question-set_questionset_all",
         "name": "Demo Practice Question Set",
         "targetObjectType": "QuestionSet",
         "associatedAssetTypes": ["Question", "QuestionSet"]
       },
       {
         "identifier": "obj-cat:digital-textbook_collection_all",
         "name": "Digital Textbook",
         "targetObjectType": "Collection",
         "associatedAssetTypes": ["Content"]
       },  
       {
         "identifier": "obj-cat:professional-development-course_collection_all",
         "name": "Professional Development Course",
         "targetObjectType": "Collection",
         "associatedAssetTypes": ["Content"]
       },
       {
         "identifier": "obj-cat:question-paper_collection_all",
         "name": "Question Paper",
         "targetObjectType": "Collection",
         "associatedAssetTypes": ["Content"]
       }  
     ]

   • Based on the selected target collection value ( "Question Paper"or "Demo Practice Question Set" ) and the above mapping, the values in the Select Target Asset dropdown will be updated
     

   • A new variable may be introduced in the program definition, program.targetCollectionType, which may be one of ["Collection", "QuestionSet"] (Detailed at the end)
     

   • The category definition of the selected target collection may be fetched through the getCategoryDefinition function via the following API call:
     POST /content/object/category/definition/v1/read?fields=objectMetadata,forms,name
     

     { "request":
     	{ "objectCategoryDefinition":
     		{ 
     			"objectType": "QuestionSet",
     			"name": "Demo Practice Question Set",
     			"channel": ""
     		}
     	}
     }

2. Create New Project: Select/Create Objects

   • On advancing to the next tab:

     • A draft project will be created via the following API:
       POST content/program/v1/create
       

     { "request":
       {
     	"name": "Test 1",
     	"description": "Descr",
     	"nomination_enddate": null,
     	"shortlisting_enddate": null,
     	"content_submission_enddate": "2021-06-06T18:29:59.000Z",
     	"rewards": null,
     	"target_collection_category": [ "Demo Practice Question Set" ],	
     	"content_types": [], 
     	"targetCollectionType": ["Question Set"],
     	"targetprimarycategories": [
     	  {
     		"identifier": "obj-cat:practice-question-set_content_all",
     		"name": "Practice Question Set",
     		"targetObjectType": "Content"
     	  }
     ],			
       }

   • In the “Search & Add” modal:

     • This will be enabled based on a contentAdditionMode property to be added to the category definition, which will have one of three possible values: search | add | both

     • List of collections of the required target collection category to display in the search will be fetched by making the following API call:
       POST /composite/v1/search(No change)
       

     • { "request":
       	{ "filters":
       		{ 
       			"objectType": ["Collection"],
       			"status":["Draft"],
       			"subject": ["Mathematics"],
       			"medium": ["English"],
       			"gradeLevel": ["Class 4"],
       			"primaryCategory":"Question Paper",
       			"channel":"",
       			"limit": 1000,
       			"not_exists":["programId"]
       		}
       	}
       }

   • In case of editing an already created draft project, this tab opens up on load. In that case, the category definition of the selected target collection (or questionSet) as well as a list of already created objects of that collection/question set category are to be populated. Both may be done via the same process as above, where the only difference is that the selected target collection can be retrieved from this.selectedTargetCollection, and the target collection type may be retrieved from this.programDetails.targetCollectionType
     

3. Create New Project: Add New

   • Display the “Add New” button only if the targetCollectionType === “Question Set” for the draft program

   • Navigate to the Question Set Editor on clicking the "Add New" button [6] (Google Slide)

   • Use the category definition of the selected target question set to modify the behaviour of the question set editor, using maxDepth.

   • A data property hideAddQuestion may be added to the routing config, to disable the "Create New" button on the Question Set Editor in this case
     

     {
       path: 'edit/:programId', component: CreateProgramComponent, canActivate: [ProgramsService, AuthGuard], pathMatch: 'full',
       data: {
        ...
       },
       children: [
         {
           path: 'questionSet', component: QuestionSetEditorComponent, pathMatch: 'full',
           data: {
             hideHeaderNFooter: 'true',     
             hideAddQuestion: true,   
             telemetry: {
              ...
             }
           }
         }

   • The programId will be added to the created questionSet under a programId attribute

   • On "Save", redirect to the draft project creation screen with the created Question Set returned to the parent component and added to the tempQuestionSets array, to display in the selected list [8] (Google Slide)
     

4. Create New Project: Publish

   • On “Publish”, the existing workflow to publish the project will be followed with some modifications for projects with targetCollectionType === ‘Question Set’

     • The question sets added to the program will be saved to the program config object in config.collections

     • The contentAdditionMode will also be saved in the program config

     • The identifiers will be saved in collectionIds

   • POST content/program/v1/update
     

     {
     	"request": {
     		"name": "Test",
     		"description": "1234",
     		"nomination_enddate": null,
     		"shortlisting_enddate": null,
     		"content_submission_enddate": "2021-07-04T18:29:59.000Z",
     		"rewards": null,
     		"target_collection_category": ["Demo Practice Question Set"],
     		"content_types": [],
     		"targetprimarycategories": [{
     			"identifier": "obj-cat:exam-question_content_01309282781705830427",
     			"name": "Exam Question",
     			"targetObjectType": "Content"
     		}],
     		"sourcing_org_name": "NIT",
     		"rootorg_id": "01309282781705830427",
     		"createdby": "5a587cc1-e018-4859-a0a8-e842650b9d64",
     		"createdon": "2021-06-12T07:39:30.060Z",
     		"startdate": "2021-06-12T07:39:30.060Z",
     		"slug": "sunbird",
     		"type": "private",
     		"default_roles": ["CONTRIBUTOR"],
     		"enddate": "2021-08-08T18:29:59.000Z",
     		"guidelines_url": null,
     		"status": "Draft",
     		"program_id": "b7237ab0-cb50-11eb-a18f-2b66ffec9e33",
     		"collectionIds": [],
     		"config": {
     			...
     			"contentAdditionMode": "add",
                 "collections": [
                   {
                     "identifier": "",
                     "children": []
                   }
                 ]

   • POST content/program/v1/publish or POST content/program/v1/unlist/publish
     (depending on whether nominations have been enabled or not)

     { "request":
       {   
         "program_id": "3d5ddd30-bff0-11eb-8aa6-59968608366d",
         "channel":"sunbird"
       }
     }

   • Inside the Program Service, create new functions to handle publishing for programs with contentAdditionMode === 'add'

     • Modify the copyCollections function as follows:

       if(_.get(data, 'config.contentAdditionMode') === 'add') {
         rspObj.contentAdditionMode = 'add';
         rspObj.result = collections;
         cb(null, rsbObj);
         return true;
       }

     • Modify the publishProgram function as follows:

       function publishProgram(req, response) {
         var data = req.body;
          model.program.findByPk(data.request.program_id)
         .then(function (res) {
           const cb = function(errObj, rspObj) {
             if (!errObj && rspObj) {
               res.copiedCollections = [];
               if (rspObj && rspObj.result) {
                 if(rspObj.contentAdditionMode === 'add') {
                   res.copiedCollections = rspObj.result
                 }
                 res.copiedCollections = _.map(rspObj.result, (collection) => {
                 return collection.result.content_id;
                 });
               }
        
         
         }

1. Contribution

   • In case the targetCollectionType of the Project is "QuestionSet", Replace the existing view with the Question Set Editor showing list of Questions added only by current user.

   • Basis the selected targetPrimaryCategories, allow the addition of Question Sets to Question Sets in the Question Set Editor via this (Confluence Document) configuration.
     

2. Review

   • What is the impact on the proposed changes to the contribution flow (contribution and review) objects?

     • Will it support reviewing of individual Question objects? Is the API for this ready?

DB Changes: Program Table