WI DPI WISEdata Ed-Fi Docs
/grade
Jaidaa Shafaei
Roster is a collection within WISEdata that collects coursework data from schools. Roster data is required for all grade levels except PK, including the /grade endpoint for Pass/Fail. LEAs will receive a validation message in WISEdata Portal when the /grade endpoint is missing for grade levels 9 to 12.
This endpoint is NOT expected from Choice schools.
Ed-Fi Tech Docs: https://techdocs.ed-fi.org/display/EDFICERT/v3+StudentGrade+%3E+Grade
Data Properties:
# | Property Name | Data Type | Public (Required/ Optional/ Conditional) | Choice (Required/ Optional/ Conditional) | Business Definition | Data Element Page |
|---|---|---|---|---|---|---|
1.0 | gradeTypeDescriptor | string | REQ'D | NOT REQ'D | The type of grade reported. 'Final' gradeType is the only allowable gradeTypeDescriptor | |
2.0 | gradingPeriodReference | array | Â | Â | Â | Â |
3.0 | gradingPeriodDescriptor | string | REQ'D | NOT REQ'D | The name of the period for which grades are reported. | https://dpi.wi.gov/wise/data-elements/gradingperioddescriptor |
4.0 | periodSequence | integer | REQ'D | NOT REQ'D | The sequential order of this period relative to other periods. | |
5.0 | schoolId | integer | REQ'D | NOT REQ'D | The identifier assigned to a school. | |
6.0 | schoolYear | integer | REQ'D | NOT REQ'D | The identifier for the grading period school year. | |
7.0 | studentSectionAssociationReference | array | Â | Â | Â | Â |
8.0 | localCourseCode | string | REQ'D | NOT REQ'D | The local code assigned by the School that identifies the course offering provided for the instruction of students.The identifier assigned to a school. | |
9.0 | schoolId | integer | REQ'D | NOT REQ'D | The identifier for the school year. | |
10.0 | schoolYear | integer | REQ'D | NOT REQ'D | The local identifier assigned to a section. | |
11.0 | sectionIdentifier | string | REQ'D | NOT REQ'D | The local identifier assigned to a section. | |
12.0 | sessionName | string | REQ'D | NOT REQ'D | The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer). | |
13.0 | studentUniqueId | string | REQ'D | NOT REQ'D | A unique alphanumeric code assigned to a student. | |
14.0 | letterGradeEarned | string | OPT | NOT REQ'D | A final or interim (grading period) indicator of student performance in a class as submitted by the instructor. | |
15.0 | numericGradeEarned | number | OPT | NOT REQ'D | A final or interim (grading period) indicator of student performance in a class as submitted by the instructor. | |
16.0 | performanceBaseConversionDescriptor | string | CONDITINALLY REQ'D | NOT REQ'D | A conversion of the level to a standard set of performance levels. | https://dpi.wi.gov/wise/data-elements/performance-base-conversion-type |
Use Cases:
# | Use Case Title | Use Case Description | What to Submit/retrieve |
|---|
# | Use Case Title | Use Case Description | What to Submit/retrieve |
|---|---|---|---|
1.0 | Sending grades for a course that a student is enrolled in, which has multiple studentSectionAssociations for the same logical class due to change of begin dates | Only one ‘Final grade’ will be awarded to the student for the logical class irrespective of having multiple studentSectionAssociations with change in Begin Dates. Only one /grades endpoint should be submitted with a reference to one /studentSectionAssociation for the entire logical class. It is expected to receive the most recent studentSectionAssociation with the latest beginDate for the final grade record. Prerequisites:
| POST on /grades: |
2.0 | Sending grades for a course that is taught in a ‘Semester’, but has two final grades at the end of each Quarter | Since ‘Final Grades’ are awarded at the end of each Quarter, the ‘Term’ should be set up as a ‘Quarter’ and not as a ‘Semester’. This will allow one ‘Final grade’ to be submitted for the term set up. | POST on /grades |
3.0 | Sending grades for a course that is taught in a ‘Quarter’, but the ‘Final Grade’ is awarded at the end of two Quarter, i.e a ‘Semester’ | Since ‘Final Grades’ are awarded at the end of the ‘Semester’ , the ‘Term’ should be set up as a ‘Semester’ and not as a ‘Quarter’ . This will allow one ‘Final grade’ to be submitted for the term set up. | POST on /grades |
4.0 | Sending grades for multiple courses taught in the same class (e.g. Math and Science) | This should be reported as two different courses: one with a reference to the Math course, and the other with a reference to the Science course. The /grades endpoint should be submitted separately with the association to each course identifying student’s performance to determine Pass, Fail, or Incomplete. | POST on /grades |
JSON Sample:
{
"gradingPeriodReference": {
"gradingPerioddescriptor": "uri://dpi.wi.gov/GradingPeriodDescriptor#07",
"periodSequence": 1,
"schoolId": 7525,
"schoolYear": 2021
},
"studentSectionAssociationReference": {
"studentUniqueId": "8660232105",
"schoolId": 7525,
"localCourseCode": "LCC-121941",
"sectionIdentifier": "Section-121941",
"schoolYear": 2021,
"sessionName": "Sessions-121941"
},
"gradetypeDescriptor": "uri://dpi.wi.gov/GradeTypeDescriptor#Final",
"performanceBaseConversionDescriptor": "uri://dpi.wi.gov/PerformanceBaseConversionDescriptor#P",
"letterGradeEarned": "A",
"numericGradeEarned": "01"
}Â
Wisconsin Department of Public Instruction