OneRoster Assessments 1.2 Data Models

OneRoster is a set of specifications established by the 1EdTech Learning Consortium. Campus created our OneRoster API based on these specifications. This article details the assessment endpoints available with OneRoster 1.2.

See the OneRoster API article for more information about OneRoster and the Configuring OneRoster Connections article for instructions on setting up a connection that includes assessment data.

The tables below lay out the OneRoster 1.2 Assessment specification and identify, where applicable, the location in the Campus interface and database where this data populates, with any additional information.

What are 'SourcedIDs'?

The sourceId of a record is a key piece of data used to identify that record. This value is usually the unique identifier for an element, such as the GUID. In the tables below, the sourceId is the first element listed for each endpoint, with examples provided.

LineItem

Returns records for specific assessments.

Data Element Name in OneRoster Assessment Spec
Campus Interface & Database Location
Description & Notes
sourceId

Does not display in the Campus UI


Test.testGUID
A unique identifier for the assessment assigned by the vendor system. (UUID in v4 format)
status
Does not display in the Campus UI.

Test.status
Indicates the status of this assessment. Accepted values are 'active' and 'toBeDeleted.'
dateLastModified
Does not display in the Campus UI.

Test.modifiedDate
The date the assessment was last updated.
title
Assessment > Test Setup > Test > Name

Test.name
The name of the assessment
description
Does not display in the Campus UI.

Test.description
The description of the assessment
resultValueMin
Does not display in the Campus UI.

Test.resultValueMin
The lowest possible score a student could receive on this assessment in a corresponding Result record. Data is stored when received via the API, but there is no functionality associated with this field in Campus.
resultValueMax
Does not display in the Campus UI.

Test.resultValueMax
The highest possible score a student could receive on this assessment in a corresponding Result record. Data is stored when received via the API, but there is no functionality associated with this field in Campus.
learningObjectiveSource
Does not display in the Campus UI.

Test.learningObjectiveSource
Used for standards-based grading. A set of Learning Objectives relevant to this assessment. Data is stored when received via the API, but there is no functionality associated with this field in Campus.
learingObjectiveId
Does not display in the Campus UI.

Test.learningObjectiveId
The identification number of the learning objective source. Data is stored when received via the API, but there is no functionality associated with this field in Campus.
parentSourcedId
Assessment > Test Setup > Parent Test

Test.parentID
The sourcedId of the parent of this assessment (UUID in v4 format). A child assessment must exist for this field to be returned successfully.
parentAssessmentLineItemRef
N/A
N/A

Result

Returns a record for assessment scores received by a specific student.

Data Element Name in OneRoster Assessment Spec
Campus Interface & Database Location
Description & Notes
sourceId
Does not display in the Campus UI.

TestScore.scoreGUID
A unique identifier for the assessment score assigned by the vendor system (UUID in v4 format).
status
Does not display in the Campus UI.

TestScore.status
The status of the assessment for which this result was received. Accepted values are exempt, fully graded, not submitted, partially graded, submitted, late, incomplete, missing, withdrawal, in progress.
dateLastModified
Does not display in the Campus UI.

TestScore.modifiedDate
The date the assessment score was last updated.
score
Student Information > General > Assessment > Raw Score

TestScore.rawScore
The score received on the assessment.
scoreDate
Student Information > General > Assessment > Date

TestScore.date
The date on which the assessment was taken.
scorePercentile
Student Information > General > Assessment > Percentile

TestScore.percentile
The position or rank the student received on the assessment.
scaleScore
Student Informaiton > General > Assessment > Scale Score

TestScore.scaleScore
The scale score of the assessment.
scoreStatus
Does not display in the Campus UI.

TestScore.scoreStatus
The status of the score. Accepted values are 'active' or 'toBeDeleted.'
assessmentLineItem
N/A
N/A
student
N/A
N/A
comment
Student Information > General > Assessment > Comment

TestScore.comment
Any comments entered for the result.
assessmentLiteItemSourcedId
Does not display in the Campus UI.

TestScore.testID
The sourcedId of the assessment associated with this score (UUID in v4 format). The associated assessment must exist already for this field to be returned successfully.
studentSourcedId
Does not display in the Campus UI.

TestScore.personID
The sourcedId of the student who received this score (UUID in v4 format). The associated student must exist already for this field to be returned successfully.