Page Comparison

...

This endpoint is NOT expected from Choice schools.

Data Properties:

Expand

title	Click here to view all data properties under the /gradingPeriod endpoint:

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Choice (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.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
2.0	🆕 gradingPeriodName	string	REQ'D	NOT REQ'D	The school's descriptive name of the grading period
3.0	periodSequence	integer	OPT	NOT REQ'D	The sequential order of this period relative to other periods.	https://dpi.wi.gov/wise/data-elements/sequenceofcourse
4.0	schoolReference
5.0	schoolId	integer	REQ'D	NOT REQ'D	The identifier assigned to a school.	https://dpi.wi.gov/wise/data-elements/gradingperiodschoolid
6.0	schoolYearTypeReference
7.0	schoolYear	integer	REQ'D	NOT REQ'D	Key for School Year	https://dpi.wi.gov/wise/data-elements/school-year
8.0	beginDate	string	REQ'D	NOT REQ'D	Month, day, and year of the first day of the GradingPeriod.	https://dpi.wi.gov/wise/data-elements/gradingperiodbeginandend
9.0	endDate	string	REQ'D	NOT REQ'D	Month, day, and year of the last day of the GradingPeriod.	https://dpi.wi.gov/wise/data-elements/gradingperiodbeginandend
10.0	totalInstructionalDays	integer	REQ'D	NOT REQ'D	Total days available for educational instruction during the GradingPeriod.	https://dpi.wi.gov/wise/data-elements/gradingperiodtotalinstructionaldays

...

Use Cases:

Expand

title	Click here to view all the use cases pertaining to the /gradingPeriod endpoint:

#

Use Case Title

Use Case Description

What to Submit/retrieve

1.0

Sending the grading period during the school year in which the grade is offered

To set up a student's schedule for a school year, SIS vendors need to submit gradingPeriods for the schedule using gradingPeriodDescriptor values.

To be able to submit the /courseOfferings endpoint, the /gradingPeriods (and the /sessions endpoint) should be submitted.

POST on / gradingPeriod:
schoolReference:
schoolId: 7525
schoolYearTypeReference:
schoolYear: 2021
gradingPeriodDescriptor: uri://dpi.wi.gov/GradingPeriodDescriptor#07
periodSequence: 1
beginDate: 2020-07-03
totalInstructionalDays: 150
endDate: 2021-06-05

...

JSON Sample:

Expand

title	JSON sample for /gradingPeriod:

Code Block

language	json

{
	"schoolReference": {
		"schoolId": 7525
	},
	"schoolYearTypeReference": {
		"schoolYear": 2021
	},
	"gradingPeriodDescriptor": "uri://dpi.wi.gov/GradingPeriodDescriptor#07",
	"periodSequence": 1,
	"beginDate": "2020-07-03",
	"totalInstructionalDays": "150",
	"endDate": "2021-06-05"
}

...

Versions Compared

Old Version 14

New Version Current

Key

Data Properties:

Use Cases:

JSON Sample: