Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This documentation describes about the generation of the batch wise assessment report within the course. The report should generate with below fields. For more detail refer this PRD.


Code Block
languagejs
themeFadeToGrey
titleReport fields
linenumberstrue
collapsetrue
External ID //  External ID is the state ID provided by state for a teacher
User ID // User Identifier
User Name 
Email ID
Mobile Number
Organisation Name
District Name
School name 
Assessment Name // Name of the assessment/worksheet/content 
Total Score // Total score of the all assessment in a course( Eg: 2/3+3/4+2/3=7/10 )

...

Code Block
languagejs
themeFadeToGrey
titleData product input source table name
linenumberstrue
collapsetrue
 usr_external_identity // To get the user external id information
 user // to get the user information
 course_batch // To get the details about the batch enrolled to course
 user_courses // To get the information about the user enrolled to courses
 user_org // to get the user organisation details
 assessment_historyprofile (new) // Assessment result

...

As per the above diagram, End user will sync the assess events through api, which will update the database with computed values. The assessment data product which read data from the database and will generate the reports per batch and uploads to azure cloud storage.


Assessment update API:


Code Block
languagejs
themeFadeToGrey
titleAPI Request
linenumberstrue
METHOD: POSTPATCH 
URI: /datav1/v3content/coursestate/assessment/telemetryupdate // End point
BODYREQUEST: {
    "idrequest": {
    "api.course.batch.telemetry" ",    "contents": [ ],
        "verassessments": "3.0",
  "ets[
            {
 				"assessmentTs": 15668847145501567591211000, //TimeAssessment stamptime in ms epoch
                "eventsbatchId": []"", // Batch Identifier - required
				"courseId":"", //ONLY Course ASSESSIdentifier Events- required
	  "batch_id			"userId":"",  // BatchUser Identifier - required
	  "course_id			"attemptId":"", // CourseAttempt Identifier - required
	 "user_id 			"contentId": "", // UserContent Identifier - required
         "attempt_id":""       "events": [ ] // Question attempt identifier

}ONLY ASSESS Events - required
            }
        ]
    }
}


Request Structure:

Events related to particular to batchId, courseId, userId, attemptId, contentId should be grouped together while calling this API.

attemptId: Should be generated from Hashing HASH(courseId, userId, contentId, batchId)


Code Block
languagejs
themeFadeToGrey
titleAPI Response
linenumberstrue
{
    "id": "api.coursecontent.batchstate.telemetryupdate",
    "ver": "3.0v1","ets":1566974765224,
    "ts": "2019-09-04 12:47:08:954+0000",
    "params": {
        "resmsgid": null,
        "msgid": "bec2defc-ddca-7b37-6a24-1dcbdfb23d48",
        "err:err},": null,
        "status": "success",
        "errmsg": null
    },
    "responseCode": "OK",
    "result": {
        "<contentId>": "SUCCESS"
    }
}



Disadvantages:

  1. Need to validate and de-dup the the events.

...

Code Block
themeFadeToGrey
titleassessment_profile
linenumberstrue
CREATE TABLE assessment_profileaggregator (
    batch_id text,
    user_id text,
    course_id text,
    worksheetcontent_id text,
    worksheetattempt_nameid text,
    attemptupdated_idon texttimestamp,
    updatedcreated_on timestamp,
    createdlast_attempted_on timestamp,
    total_score int,
    total_max_score int,
    question list<frozen<question>>,
    PRIMARY KEY (worksheetcontent_id, attempt_id, user_id, course_id, batch_id )
)

CREATE INDEX ON assessment_aggregator (last_attempted_on);

CREATE TYPE question(
    id text,
    max_score int,
    score int,
    type text,
    title text,
    pass textresvalues list<map<text,text>>,
    params list<map<text,text>>,
    description text,
    duration:text decimal
);



Challenges:

 

  1. How to capture the attempts? i.e. Number of times the particular user is attempted particular question. 
  2. How to capture the batch-id and course-id

...