Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

(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

...

Expand
titleClick 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 program type programtype and names for CTE & WL below.

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

...

Descriptors:

Expand
titleClick here to view all the descriptors pertaining to the /studentSectionAssociation endpoint:

...

4.0

...

5.0

...

6.0

...

7.0

JSON Sample:

{ "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
Expand
titleJSON sample for studentSectionAssociation:
Code Block
languagejson

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

ACE

Adult/Continuing Education

Adult/Continuing Education

Alt

Alternative Education

Alternative Education

Athl

Athletics

Athletics

B

Bilingual

Bilingual

BS

Bilingual Summer

Bilingual Summer

CTE

Career and Technical Education

Career and Technical Education

Co

Cocurricular Programs

Cocurricular Programs

CP

College Preparatory

College Preparatory

CSP

Community Service Program

Community Service Program

CJC

Community/Junior College Education Program

Community/Junior College Education Program

Comp

Compensatory Services for Disadvantaged Students

Compensatory Services for Disadvantaged Students

Counsel

Counseling Services

Counseling Services

DF GED

District-Funded GED

District-Funded GED

EHS

Early Head Start

Early Head Start

EIS PartC

Early Intervention Services Part C

Early Intervention Services Part C

ESL

English as a Second Language (ESL)

English as a Second Language (ESL)

ES

Even Start

Even Start

Exp

Expelled Education

Expelled Education

ED/CCS

Extended Day/Child Care Services

Extended Day/Child Care Services

Fee

Fee For Service

Fee For Service

GT

Gifted and Talented

Gifted and Talented

Head

Head Start

Head Start

HS

Health Services Program

Health Services Program

HSEP

High School Equivalency Program (HSEP)

High School Equivalency Program (HSEP)

HV

Home Visiting

Home Visiting

IDEA

IDEA

IDEA

Immi

Immigrant Education

Immigrant Education

IS

Independent Study

Independent Study

Ind Ed

Indian Education

Indian Education

IB

International Baccalaureate

International Baccalaureate

KG-Full

Kindergarten - Full Day

Kindergarten - Full Day

KG-Half

Kindergarten - Half Day

Kindergarten - Half Day

KG-Ext

Kindergarten - Extended Day

Kindergarten - Extended Day

LMS

Library/Media Services Program

Library/Media Services Program

Magnet

Magnet/Special Program Emphasis

Magnet/Special Program Emphasis

Migrant

Migrant Education

Migrant Education

ND

Neglected and Delinquent Program

Neglected and Delinquent Program

OFSDP

Optional Flexible School Day Program (OFSDP)

Optional Flexible School Day Program (OFSDP)

O

Other

Other

PK-Full

Prekindergarten - Full Day

Prekindergarten - Full Day

PK-Half

Prekindergarten - Half Day

Prekindergarten - Half Day

PK-Ext

Prekindergarten - Extended Day

Prekindergarten - Extended Day

PSE

Preschool Special Education

Preschool Special Education

PP

Public Preschool

Public Preschool

Reg Ed

Regular Education

Regular Education

Remedial

Remedial Education

Remedial Education

504

Section 504 Placement

Section 504 Placement

SL

Service Learning

Service Learning

SPED

Special Education

Special Education

DOP

Student Retention/Dropout Prevention

Student Retention/Dropout Prevention

SAE

Substance Abuse Education/Prevention

Substance Abuse Education/Prevention

TPD

Teacher Professional Development/Mentoring

Teacher Professional Development/Mentoring

Tech Prep

Technical Preparatory

Technical Preparatory

T1A

Title I Part A

Title I Part A

T1D1

Title I Part D Subpart 1

Title I Part D Subpart 1

T1D2

Title I Part D Subpart 2

Title I Part D Subpart 2

Voc Ed

Vocational Education

Vocational Education

LIEP-Bilingual

Language Instruction Education Program - Bilingual Program

Language Instruction Education Program - Bilingual Program

LIEP-ESL

Language Instruction Education Program - ESL Program

Language Instruction Education Program - ESL Program

Dual

Dual Enrollment Program

Dual Enrollment Program

WL

World Language Program

World Language Program

H

Homeless

Homeless

Certified

Certified Career Education Program

Certified Career Education Program

Non Certified

Non Certified Career Education Program

Non Certified Career Education Program

SFS

School Food Service

School Food Service

LIEP

Language Instruction Education

Language Instruction Education for English learners

Modality

Learning Modality

Learning Modality

LIEP-Other

Language Instruction Education Program - Other

Language Instruction Education Program - Other

Use Cases:

...

titleClick 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 course for endangered and indigenous Asian (Hmong) and North American (Ho-Chunk, Ojibwe, Oneida, Potawatomi, Menominee, and Mahican) Languages

...

The course list has been expanded to include endangered and indigenous Asian (Hmong) and North American (Ho-Chunk, Ojibwe, Oneida, Potawatomi, Menominee, and Mahican) Languages.

SIS vendors should verify their course catalog includes the new languages. These courses will have a courseIdentificationSystemDescriptor as ‘WLL’.

Example 1:

  • Roster Code: 16336

  • Title: Hmong I

  • Subject Area: 24

  • Rigor Level: General or Regular

  • SCED 10: 24989G

Example 2:

  • Roster Code: 16346

  • Title: Ojibwe I

  • Subject Area: 24

  • Rigor Level: General or Regular

  • SCED 10: 24989G

...

Vendors should verify their course catalog includes added languages.

...

2.0

...

Sending the WL program for EL students
Regression Test

...

There are not any WL course codes that specifically should or should not be used for ELs. World Language courses depends on the context in which an EL student is participating in the program. For more information, visit: https://dpi.wi.gov/wise/data-elements/sectionprogram. For more information about the WL definition, see https://docs.google.com/document/d/1zfUmfpKH7GIZhJdl40_Nbu0rYW-AT43jgCnW4TVjQAk/edit?usp=sharing

  • If an EL is participating in a

dual language bilingual program that provides them with instruction in their home language, then that program would be considered their LIEP and they should be reported as an EL rather than as a WL learner. For information on how to report ELs, visit: https://wisconsindpi.atlassian.net/wiki/spaces/widpiedfi/pages/2850857/studentLanguageInstructionProgramAssociation

  • If an EL is participating in

WL programs/classes as WL learners AND have an LIEP. In those cases, then the student should be classified as WL and an EL learner . For example, students who are ELs may be enrolled in one-way or two-way bilingual programs that provides instruction in English and in a target language that is not their home language.

  • If an EL is

participating in a WL course that is in their home language that is designed to build on and expand students’ knowledge of their home language , and the course is part of their LIEP, then they should be classified as WL and EL learners.

...

POST /courseOffering
courseReference:
educationOrganizationId: 48856
courseCode: 16336

POST on /section:
courseOfferingReference:
localCourseCode: LCC-121941
schoolId: 7525
sessionName: Sessions-121941
schoolYear: 2024
sectionIdentifier: Section-121941
instructionLanguageDescriptor: uri://dpi.wi.gov/LanguageDescriptor#hmn
mediumOfInstructionDescriptor: uri://dpi.wi.gov/MediumOfInstructionDescriptor#Int
sequenceOfCourse: 1

POST on /studentsectionAssociation:
programs:
programReference:
educationOrganizationId: 48856
programtypeDescriptor: uri://dpi.wi.gov/ProgramTypeDescriptor#WL
programName: Elementary School World Language Program(ESWL)

...

3.0

...

Sending the WL program for non-EL students
Regression Test

...

Bilingual and dual language programs may serve as world language programs for students enrolled in those programs who are not English Learners (non-ELs).

  • If a student is

not ELs and participating in bilingual or dual language programs, the Wl codes should be used and the student should be classified as WL learners.

For information on how to report formar EL students or native English speakers participating in bilingual and dual language programs, please see use cases 9 and 10.

...

POST on /studentsectionAssociation:
programs:
programReference:
educationOrganizationId: 48856
programtypeDescriptor: uri://dpi.wi.gov/ProgramTypeDescriptor#WL
programName: Two-Way Dual Language Education Program(DLTW-WL)
POST on /studentProgramAssociation:
programTypeDescriptor: uri://dpi.wi.gov/ProgramTypeDescriptor#LIEP-Bilingual
programName: Transitional Bilingual-Late Exit

Certified

Certified Career Education Program
(🚫 For 2024-25 SY and later)

Certified Career Education Program

IRC

Industry Recognized Credentials
🆕 (For 2024-25 SY and later)

Use for courses or work experiences that meet Industry Recognized Credentials

WBL

Work-based Learning
🆕 (For 2024-25 SY and later)

Use for employer-connected experiences

Non Certified

Non Certified Career Education Program
(🚫 For 2024-25 SY and later)

Non Certified Career Education Program

Dual

Dual Enrollment Program

Dual Enrollment Program

WL

World Language Program

World Language Program

...

Use Cases:

Expand
titleClick 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's enrolled in multiple sections and participating in CE program

If a student exits a section and returns to the same section within the same term, the SIS ends the initial student section and creates a new student section with a new start date. In both instances, the student section should be associated with student program participation.

Example: student left the class and joined back in the same section.

student Section A
Section Reference: A
Begin Date: 08/10/2024
End Date: 10/01/2024
Program Name : Simulated Worksite

student Section B
Section Reference: A
Begin Date: 10/10/2024
End Date:
Program Name : Simulated Worksite

POST on /studentSectionAssociations:

  • /studentsectionAssociation A

"beginDate": "2024-08-10",
"endDate": "2024-10-01",
"_ext":
"wi":
"programs":
"programReference": {
"educationOrganizationId": 48856,
"programName": "Simulated Worksite",
"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#WBL"

  • /studentSectionAssociation B

"beginDate": "2024-10-10",
"endDate": " ",
"_ext":
"wi":
"programs":
"programReference": {
"educationOrganizationId": 48856,
"programName": "Simulated Worksite",
"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#WBL"

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

9.0

Sending a student who is participating in Dual Enrollment, Work-Based Learning (WBL), or Industry-Recognized Credential (IRC) Program on a course-level

(For 2023-24 SY and Later)

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 (/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#WBL

...

JSON Sample:

Expand
titleJSON sample for studentSectionAssociation:
Code Block
languagejson
{
	"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/ProgramTypeDescriptor#Dual",
            }
          },
          {
            "programReference": {
              AttemptStatusDescriptor#S",
	"endDate": "2023-06-05",
	"_ext": {
		"wi": {
			"programs": [{
					"programReference": {
						"educationOrganizationId": 48856,
              						"programName": "Internship/Local co-op",
              College Course with WI Tribal College",
						"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#Non CertifiedProgramTypeDescriptor#Dual",
            }
          },
          {
            
					}
				},
				{
					"programReference": {
              						"educationOrganizationId": 48856,
              						"programName": "StateInternship/Local Co-op Ed. Skill Standards - DPI Youth Leadership",
              ",
						"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#Certified",
            }
          },
          {
            ProgramTypeDescriptor#Non Certified"
					}
				},
				{
					"programReference": {
              						"educationOrganizationId": 48856,
              						"programName": "WorldState Language (WL)",
              Co-op Ed. Skill Standards - DPI Youth Leadership",
						"programTypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#WL"
            }
          }
        ]
      }
    },
 ProgramTypeDescriptor#Certified"
					}
				}
			]
		}
	}
}