Overview
This article provides details regarding the API (Application Program Interface) resource used for uploading assessment scores to the School Loop Gradebook.
Assessment scores uploaded via this API are queued in an inbox for each teacher. The teacher can then link the assessment score to a new or existing assignment, and add it to their SL Gradebook (Gradebook version 4 only).
Resource Details
Operations
The Assignment Assessment resource allows applications to upload assessment scores to School Loop. The POST operation is summarized below:
| Operation | HTTP Method | Description | Sample URI |
|
Insert
|
POST |
Add assessment
|
https://myhs.schoolloop.com/api/assessment/assignment |
POSTing Assessments
The add-assessments operation is executed with a simple HTTP POST command. The URI format to POST grades is https://myhs.schoolloop.com/api/assessment/assignment (replace “myhs” with your target school).
Example: If the assessments to be inserted are stored in a file called “assessment.xml,” then a POST to the web service using the cURL utility could be made with the following command:
curl -X POST –data-binary “@assessment.xml” “http://myschool.schoolloop.com/api/assessment”
Service Response
Successful assessment-POST operations return the HTTP status code SC_OK (200) and a one-line text response: SUCCESS. If an operation fails, an error status code and a detailed message describing the failure are returned.
Assignment Assessment XML Schema
The XML schema for importing assessment scores to the gradebook is shown below.
- The TestID field should be unique for a given upload. If another set of assessment scores is imported with the same ID, it overwrites the previous scores. In other words, it can act as an update or correction to previously imported data.
- Scores can be added as PercentCorrect, as shown in the example below, or as raw score using ScaledScore.
<AssessmentExport>
<Assessment TestID=”002″ Name=”Illuminate Assessment Scores” SchoolYear=”2009-2010″ Subject=”Math” AdministrationDate=”2011-04-01T00:00:00″>
<CutRanges>
<CutRange MinScore=”1″ MinScoreCode=”FBB” MinScoreDesc=”Far Below Basic” />
<CutRange MinScore=”2″ MinScoreCode=”BB” MinScoreDesc=”Below Basic” />
<CutRange MinScore=”3″ MinScoreCode=”B” MinScoreDesc=”Basic” />
<CutRange MinScore=”4″ MinScoreCode=”P” MinScoreDesc=”Proficient” />
<CutRange MinScore=”5″ MinScoreCode=”A” MinScoreDesc=”Advanced” />
</CutRanges>
<Students>
<Student LastName=”Rodgers” FirstName=”Rebekah” StudentID=”12086805″ PercentCorrect=”89.90″ TeacherID=”206″ Teacher=”Sanchez, Dave” />
</Students>
</Assessment>
</AssessmentExport>