WI DPI WISEdata Ed-Fi Docs

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

(blue star) This endpoint is NOT expected from Choice schools.

Ed-Fi Tech Docs: https://techdocs.ed-fi.org/display/EDFICERT/v3+Student+Enrollment+%3E+StudentSectionAssociation


Data Properties:

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

Property Name

Data Type

Public (Required/ Optional/ Conditional)

Choice (Required/ Optional/ Conditional)

Business Definition

Data Element Page

beginDate

string

REQ'D

NOT REQ'D

Month, day, and year of the Student's entry or assignment to the Section.

https://dpi.wi.gov/wise/data-elements/ssabeginandenddate

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.

https://dpi.wi.gov/wise/data-elements/localcoursecode

schoolId

integer

REQ'D

NOT REQ'D

The identifier assigned to a school.

https://dpi.wi.gov/wise/data-elements/sessionschoolreference

schoolYear

integer

REQ'D

NOT REQ'D

The identifier for the school year.

https://dpi.wi.gov/wise/data-elements/school-year

sectionIdentifier

string

REQ'D

NOT REQ'D

The local identifier assigned to a section

https://dpi.wi.gov/wise/data-elements/uniquesectioncode

sessionName

string

REQ'D

NOT REQ'D

The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).

https://dpi.wi.gov/wise/data-elements/sessionname

studentUniqueId

string

REQ'D

NOT REQ'D

A unique alphanumeric code assigned to a student.

https://dpi.wi.gov/wise/data-elements/WISEid

attemptStatusDescriptor

string

REQ'D

NOT REQ'D

An indication of the student's completion status for the section.

https://dpi.wi.gov/wise/data-elements/attempt-status-descriptor

endDate

string

REQ'D

NOT REQ'D

Month, day, and year of the withdrawal or exit of the Student from the Section.

https://dpi.wi.gov/wise/data-elements/ssabeginandenddate

educationOrganizationId

integer

REQ'D

NOT REQ'D

The identifier assigned to an education organization.

https://dpi.wi.gov/wise/data-element/edorgid

programName

string

CONDITINALLY REQ'D

NOT REQ'D

The formal name of the Program of instruction, training, services, or benefits available through federal, state, or local agencies.

See programtype and names for CTE below.

https://dpi.wi.gov/wise/data-elements/sectionprogram

programTypeDescriptor

string

CONDITINALLY REQ'D

NOT REQ'D

The type of program.

See programtype and names for CTE below.

https://dpi.wi.gov/wise/data-elements/sectionprogram


Descriptors:

 Click here to view all the descriptors pertaining to the /studentSectionAssociation endpoint:

Namespace

Code Value

Short Description

Description

uri://dpi.wi.gov/AttemptStatusDescriptor

S

Sufficient

Use sufficient as the Attempt Status when the student is enrolled in the section for the minimum amount of time to receive an outcome.

I

Insufficient

Use Insufficient as the Attempt Status when the student is not enrolled in the section for the minimum amount of time to receive an outcome.

uri://dpi.wi.gov/ProgramTypeDescriptor

Certified

Certified Career Education Program

Certified Career Education Program 🚫 (For 2023-24 SY and prior)

Non Certified

Non Certified Career Education Program

Non Certified Career Education Program 🚫 (For 2023-24 SY and prior)

🆕 (For 2024-25 SY and later)

IRC

Industry Recognized Credentials

🆕 (For 2024-25 SY and later)

WBL

Work-based Learning

Dual

Dual Enrollment Program

Dual Enrollment Program

WL

World Language Program

World Language Program


Use Cases:

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

#

Use Case Title

Use Case Description

What to Submit/retrieve

1.0

Sending student section for a section the student is associated to during the school year

Student Section Association connects a student to a section and gathers information about the course in which the student is enrolled.

All primary enrollments of a student should report Roster information to WISEdata. Report Roster data for all periods of time when a student is/was enrolled in your school/district.

POST on /studentSectionAssociation:

sectionReference:
localCourseCode: LCC-121941
schoolId: 1302
schoolYear: 2023
sectionIdentifier: Section-121941
sessionName: Sessions-121941
studentReference:
studentUniqueId: 5281033584
beginDate: 2022-08-02
attemptStatusDescriptor: uri://dpi.wi.gov/AttemptStatusDescriptor#S
endDate: 2023-06-05

2.0

Sending student section for a student taking courses in multiple schools

Students sometimes take multiple courses in multiple schools, such as students enrolled in a middle school taking most classes at the middle school, but also taking a class at the high school.

In this case, the middle school submits a primary primary along with the Roster data. The high school submits a non-primary ‘Coursework’ enrollment and Roster data only for the one or two courses taken at the high school.

Middle School:

POST on /studentSchoolAssociations:
primarySchool: True
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P

POST on /studentSectionAssociation

High School:

POST on /studentSchoolAssociations:
primarySchool: False
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#C

POST on /studentSectionAssociation

3.0

Sending students receiving only Speech and Language Services or only Therapy/Social Interaction

As of 2022-23 SY, at least one course is now available with SCED codes which may be appropriate for such students. DPI encourages review of these new courses such that these student groups may now be reported to the WISEdata Roster collection.

For the course codes, visit https://dpi.wi.gov/wise/data-elements/coursereference

Speech-Workplace Experience
Roster Code: 10408

POST on /courseOffering:

courseReference:
educationOrganizationId: 48856
courseCode: 10408 (Speech-Workplace Experience)
schoolReference:
schoolId: 1302
sessionReference:
schoolId: 1302
schoolYear: 2020
sessionName: Sessions-12194
localCourseCode: LCC-12194

POST on /section
POST on /studentSectionAssociation:

sectionReference:
localCourseCode: LCC-12194
schoolId: 1302,
schoolYear: 2020
sectionIdentifier: Section-121941
sessionName: Sessions-12194
etc.

4.0

Sending students in jails or juvenile detention centers

County jails and juvenile detention centers have schools within them that are operated by the local school district. School districts should treat these schools as any other district-operated school (and report Roster, Attendance, etc...).

For school districts that have students who are attending jail or detention schools outside of their district borders, the LEA housing the school will do all the reporting.

POST on /studentSchoolAssociation

5.0

Sending a high school student taking college courses

High school students are eligible to receive credits from technical colleges, the University of Wisconsin colleges and universities, tribal colleges, and nonprofit institutions of higher education if they successfully complete a course taught by a high school teacher using high school curriculum. Dual enrollment includes a variety of programs through which high school students are enrolled simultaneously in both high school and college to earn both high school and college credit.

Students must be associated with a section, course, and a local (district) teacher. Though it's up to your district which classroom position descriptor to choose for the teacher's role, DPI recommends using ‘Instructor of Record’. In this scenario a monitoring educator from the district may be assigned as the ‘Instructor of Record’. The actual teacher in the post-secondary school or institution is NOT submitted to Roster.

POST on /studentSchoolAssociation

sectionReference:
localCourseCode: LCC-121941
schoolId: 1302
schoolYear: 2023
sectionIdentifier: Section-121941
sessionName: Sessions-121941
studentReference:
studentUniqueId: 5281033584
beginDate: 2022-07-02
attemptStatusDescriptor: uri://dpi.wi.gov/AttemptStatusDescriptor#S
endDate: 2023-06-05
_ext:
wi:
programs:
programReference:
educationOrganizationId: 48856
programName: College Course with WI Tribal College
programTypeDescriptor: uri://dpi.wi.gov/ProgramTypeDescriptor#Dual

6.0

Sending the student attempt status for the section

Generally, the SIS should not send to WISEdata courses for which the student was enrolled with the intent of earning a grade but did NOT earn a grade (i.e. transfer out of school at any time in the term or dropped out). The attempt status is available in case the SIS is sending them and cannot remove the student section association; this should be an exception, not the norm. DPI suggests that the Attempt Status be entred by the LEA, and requests limits on vendor imposed defaults to only exist when the default value is appropriate for nearly all students.

Sending a student who is in the section until end of the term and received a grade/mark

POST on /studentSchoolAssociation:

  • Starting Attempt Status should be either 'Sufficient' or NULL - Grade resource is submitted

  • After a Grade is received, the final Attempt Status will change to ‘Sufficient

  • Performance Base Conversion Type is either 'Pass' or 'Fail'

6.1

Sending a student who is in the section until end of the term, and did NOT receive a grade/mark but grade could have been earned

POST on /studentSchoolAssociation:

  • Starting Attempt Status should be either 'Sufficient' or NULL - Grade resource is submitted

  • After a Grade is received, the final Attempt Status will change to ‘Sufficient

  • Performance Base Conversion Type is 'Not Completed'

6.2

Sending a student who is in the section until end of the term, and did NOT receive a grade/mark but no grade including (pass/fail) may be earned.Note: Auditing a course means a student can take classes but cannot be graded or given credit for a particular course. A student who does not receive a Pass / Fail in the course does NOT count as a participant in that course for CTE or CE reporting purposes.

POST on /studentSchoolAssociation:

  • Starting Attempt Status should be either 'Sufficient' or NULL - Grade resource is submitted

  • After a Grade is received, the final Attempt Status will change to ‘Sufficient

  • Performance Base Conversion Type is 'Not Graded'

6.3

Sending a student who is in the section until end of the term, and did NOT receive a grade/mark becase it is an audited course

POST on /studentSchoolAssociation

LEA can choose to send the Attempt Status as either 'Sufficient' and 'Not Graded' or 'Insufficient'

6.4

Sending a student who withdrew from the section but received a grade

POST on /studentSchoolAssociation:

  • Starting Attempt Status should be either 'Sufficient' or NULL

  • Grade resource is submitted

  • After a Grade is received, change Attempt Status to 'Sufficient

  • Performance Base Conversion Type is either 'Pass' or 'Fail'

6.5

Sending a student who withdrew from the section and did NOT receive a grade
This may also applies to students who dropped the class without receiving a grade, transferred out of the section due to schedule change or similar without receiving a grade, dropped out of school without receiving a grade in the specific course, or transferred out of the school without receiving a grade in the specific course

POST on /studentSchoolAssociation:

  • Starting Attempt Status should be either 'Sufficient' or NULL

  • Do not submit /Grade resource.

  • Attempt status is ‘Insufficient

6.6

Sending a student who dropped out of the section, joined back in the same section within the same term, and received an outcome

There should be two student section association records:

POST on /studentSchoolAssociation (1):

  • For the first student section association record, the LEA ends the student section association and submits attempt status as ‘Insufficient’.

POST on /studentSchoolAssociation (2):

  • When the student joins back, a second student section association with a new begin date is created with attempt status as ‘Sufficient or NULL’.

  • Grade resource is submitted

  • Once the grade is assigned, the attempt status of second record is changed to ‘Sufficient’. The attempt status is linked to whether the student had an accompanying grade earned.

  • Performance Base Conversion Type is sent

6.7

Sending a student who dropped out of the section, joined back in the same section within the same term, and did NOT receive the grade

There should be two student section association records.

POST on /studentSchoolAssociation (1):

  • For the first student section association record, the LEA ends the student section association and submits attempt status as ‘Insufficient’.

POST on /studentSchoolAssociation (2):

  • When the student joins back, a second student section association with a new begin date is created with attempt status as ‘Sufficient or NULL’.

  • Grade resource is NOT submitted

  • Attempt status of second record is changed to ‘Insufficient’. The attempt status is linked to whether the student had an accompanying grade earned.

7.0

Sending a student who is participating in Dual Enrollment, Certified Career Education (CE), or Non-certified Career Education Program on a course-level

🚫 (For 2023-24 SY and Prior)

A course may be offered as part of the career education (CE) program, but not all the students taking this CE course are necessarily participating in this program. For this reason, LEAs/Vendors should send the student participation in a student-level (on /studentSectionAssociation, and not on /sections.

POST on /studentSectionAssociation:

_ext:
wi:
programs:
programReference:
educationOrganizationId: 48856,
programName: Internship/Local Co-op programTypeDescriptor:nuri://dpi.wi.gov/ProgramTypeDescriptor#Non Certified


JSON Sample:

 JSON sample for studentSectionAssociation:
{
	"sectionReference": {
		"localCourseCode": "LCC-121941",
		"schoolId": 1302,
		"schoolYear": 2023,
		"sectionIdentifier": "Section-121941",
		"sessionName": "Sessions-121941"
	},
	"studentReference": {
		"studentUniqueId": "5281033584"
	},
	"beginDate": "2022-07-02",
	"attemptStatusDescriptor": "uri://dpi.wi.gov/AttemptStatusDescriptor#S",
	"endDate": "2023-06-05",
	"_ext": {
		"wi": {
			"programs": [{
					"programReference": {
						"educationOrganizationId": 48856,
						"programName": "College Course with WI Tribal College",
						"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#Dual"
					}
				},
				{
					"programReference": {
						"educationOrganizationId": 48856,
						"programName": "Internship/Local Co-op",
						"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#Non Certified"
					}
				},
				{
					"programReference": {
						"educationOrganizationId": 48856,
						"programName": "State Co-op Ed. Skill Standards - DPI Youth Leadership",
						"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#Certified"
					}
				}
			]
		}
	}
}

  • No labels