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 | 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. |
