Versions Compared

Key

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

Body

Code Block
languagetextjson
{

 "lineItemSourcedId": integer($int64),  userId "ext_inspera_assessmentRunTitle": string, #  "ext_inspera_maxTotalScore": number($float),
  "ext_inspera_groupName": string,
  "ext_inspera_first_section_metadata": array[metadata] /v1/candidates/results/{testId}/{userId}
  "ext_inspera_candidates": array[Candidate]
}

metadata

Code Block
languagetext
{
  "id": integer($int64),
  "name": string,
  "dataType": string,
  "valueText": array[string]
}

Candidate

Code Block
languagetext
{
  "result": {
    "sourcedId": integer($int64),
    "status": string,
    "dateLastModified": string($date-time),
    "lineItem": TestInfo,
    "student": StudentInfo,
    "score": number($float),
    "resultstatus": string,
    "date": string($date-time),
    "comment": TeacherComment,
    "ext_inspera_candidateId": string,
    "ext_inspera_attendance": boolean,
    "ext_inspera_startTime": string($date-time),
    "ext_inspera_endTime": string($date-time),
    "ext_inspera_extraTimeMins": integer($int32),
    "ext_inspera_incidentTimeMins": integer($int32),
    "ext_inspera_userAssessmentSetupId": integer($int64),
    "ext_inspera_userAssessmentId": integer($int64),
    "ext_inspera_candidateId": string,
    "ext_inspera_candidateExternalIds": array[ExternalId]
    "ext_inspera_finalGrade": string,
    "ext_inspera_finalGradeDate": string($date-time),
    "ext_inspera_autoScore": number($float),
    "ext_inspera_totalScore": number($float),
    "ext_inspera_questions": array[Question],
	"ext_inspera_externalDelivery": ExternalDelivery
  }
}

ExternalId

Code Block
languagetext
{
  "ext_inspera_authType": string,
  "ext_inspera_externalId": string
}

TestInfo

Code Block
languagetext
{
  "href": string,
  "sourcedId": integer($int64),
  "type": string
}

StudentInfo

Code Block
languagetext
{
  "href": string,
  "sourcedId": integer($int64),
  "type": string
}

TeacherComment

Code Block
languagetext
{
  "ext_inspera_comment": string,
  "ext_inspera_evaluatorId": integer($int64),
  "ext_inspera_evaluatorName": string
}

Question

Code Block
languagetext
{
  "ext_inspera_question_type": string,
  "ext_inspera_questionId": integer($int64),
  "ext_inspera_questionNumber": string,
  "ext_inspera_maxQuestionScore": number($float),
  "ext_inspera_durationSeconds": integer($int32),
  "ext_inspera_autoScore": number($float),
  "ext_inspera_manualScores": array[ManualScore],
  "ext_inspera_candidateResponses": array[CandidateResponse]
}

ManualScore

Code Block
languagetext
 {
   "ext_inspera_gradingTeacherId": integer($int64),
   "ext_inspera_gradingTeacherName": string,
   "ext_inspera_manualScore": number($float)
 }

...

Inspera's internal id of the testtaker
    candidateId : string # candidateid
    externalUserIds : * array of ExternalUserId
    assessmentRunId : numeric # the id of the test
	assessmentRunTitle : string # name of the assessmentun
	assessmentRunStartTime : date * startTime format : ISO_8601_DATE_AND_TIME_WITH_SECONDS_UTC
	assessmentRunEndTime : date * endTime format : ISO_8601_DATE_AND_TIME_WITH_SECONDS_UTC
	ext_inspera_sessionId : string * the stored session-id
	taskId : string * the stored task-id
	evaluationRounds : array of EvaulationRound
}

ExternalUserId

Code Block
{
   authType : type of external id 
   externalUserId : id
}

EvaulationRounds

Code Block
languagejson
{
   roundId : numeric #round-number as stored in the database
   automaticQuestionScore : numeric # Total score for autograded questions
   finalGrade : decimal # final gradevalue for this round
   jaggedAnalysisStatus : string # name of the status of this evaluationround
   roundGrades : * array of RoundGrade
   questions : * array of Question
}

RoundGrades

Code Block
languagetext
{
  "ext_inspera_response_identifier": string,
  "ext_inspera_response": string,
  "ext_inspera_interactionValue": string,
  "ext_inspera_interactionLabel": string,
  "ext_inspera_interactionAlternative": string,
  "ext_inspera_fileName": string
  "ext_inspera_fileUpload": string
}

...

evaluatorUserId : the evalutor giving the grade
  totalScore : total score of the round per evaluator
}

Question

Code Block
languagetext
{
  "ext_inspera_externalDeliveryId": integer($int64),
  "ext_inspera_externalDeliveryFileName"questionNumber : string, #  "ext_inspera_externalFileUpload": string
}

Example output

Code Block
{
    "lineItemSourcedId": 123456,
    "ext_inspera_assessmentRunTitle": "Sample test",
    "ext_inspera_maxTotalScore": 120.0,
    "ext_inspera_candidates": [
        {"result":{
            "sourcedId": 7890123,
            "status": "NYI",
            "dateLastModified": "2017-03-31T12:35:50Z",
            "ext_inspera_candidateId": "00001",
            "ext_inspera_attendance": true,
            "ext_inspera_startTime": "2017-03-31T08:30:08Z",
            "ext_inspera_endTime": "2017-03-31T09:44:15Z",
            "ext_inspera_extraTime": 10,
            "ext_inspera_incidentTime": 0,
            "lineItem": {
                "href": "NYI",
                "sourcedId": 565656,
                "type": "lineitem"
            },
            "student": {
                "href": "NYI",
                "sourcedId": 456789,
                "type": "user"
            },
            "score": 79.0,
            "resultstatus": "NYI",
            "date": "2017-03-31T12:35:50Z",
            "comment": {
                "ext_inspera_comment": "Teacher comments on the test.",
                "ext_inspera_evaluatorId": 1209423,
                "ext_inspera_evaluatorName": "Firstname Lastname"
            },
            "ext_inspera_finalGrade": "C",
            "ext_inspera_finalGradeDate": "2017-03-31T12:35:50Z",
            "ext_inspera_autoScore": 79.0,
            "ext_inspera_totalScore": 81.0,
            "ext_inspera_questions": [
                {"ext_inspera_questionId": 123789,
                 "ext_inspera_questionNumber": "1",
                 "ext_inspera_durationSeconds": 30,
                 "ext_inspera_autoScore": 10.0,
                 "ext_inspera_maxQuestionScore": 50.0,
                 "ext_inspera_manualScores": [
                    {
                        "ext_inspera_gradingTeacherId": 1209423,
                        "ext_inspera_gradingTeacherName": "Firstname Lastname",
                        "ext_inspera_manualScore": 12.0
                    }
                 ],
                 "ext_inspera_candidateResponses": [
                     {"ext_inspera_interactionId": "simpleChoice_123456789",
                      "ext_inspera_response": "Option A",
                      "ext_inspera_interactionAlternative": 1.1
                     }
                 ]
                },
                {"ext_inspera_questionId": 123792,
                 "ext_inspera_questionNumber": "2",
                 "ext_inspera_duration": 20,
                 "ext_inspera_autoScore": 49.0,
                 "ext_inspera_maxQuestionScore": 50.0,
                 "ext_inspera_candidateResponses": [
                     {"ext_inspera_interactionId": "simpleChoice_1234544567",
                      "ext_inspera_response": "Option C",
                      "ext_inspera_interactionAlternative": 1.3
                     },
                     {"ext_inspera_interactionId": "simpleChoice_1234544569",
                      "ext_inspera_response": "Option D",
                      "ext_inspera_interactionAlternative": 1.4
                     }
                 ]
                },
                {"ext_inspera_questionId": 123795,
                 "ext_inspera_questionNumber": "3",
                 "ext_inspera_duration": 820,
                 "ext_inspera_autoScore": 0.0,
                 "ext_inspera_maxQuestionScore": 20.0,
                 "ext_inspera_manualScores": [
                    {
                        "ext_inspera_gradingTeacherId": 1209423,
                        "ext_inspera_gradingTeacherName": "Firstname Lastname",
                        "ext_inspera_manualScore": 20.0
                    }
                 ],
                 "ext_inspera_candidateResponses": [
                     {"ext_inspera_interactionId": "response",
                      "ext_inspera_response": "<complete html of the essay question>",
                      "ext_inspera_interactionAlternative": 1.1
                     }
                 ]
                }
            ]
        }},....
    ]
}The position of the question in questionSet
  questionId : numeric # Inspera's internal question-id
  userQuestionId : numeric # 
  questionWeight : numeric # 
  evaluations : array of Evaluation
}

Evaluation

Code Block
languagetext
{
	score : decimal #the score/marks for this quuestion of this round
	evaluatorId : numeric # The stored id of the evaluator that set this score. On round 1 an evaluatorId of -1 indicates automarking 
	scoreDetails : json # criteria
}

Example file:

View file
namemarks_export_-1_871512667_2021-06-01.json