WI DPI WISEdata Ed-Fi Docs
/studentSchoolAttendanceEvents
- Jaidaa Shafaei
This endpoint denotes the recording of a student's attendance status for a school day. SIS/LEAs should exclusively report negative attendance for students marked as "Excused Absence", "Excused Absence", etc. Negative attendance refers to the practice where students are assumed to be present, and only those who are absent or tardy are marked as such in attendance records.
Ed-Fi Tech Docs: https://schema.ed-fi.org/datahandbook-v400/index.html#/StudentSchoolAttendanceEvent593
Data Properties:
# | Property Name | Data Type | Public (Required/ Optional/ Conditional) | Choice (Required/ Optional/ Conditional) | Business Definition |
1.0 | attendanceEventCategoryDescriptor | string | Required | Required | A code describing the attendance event, for example: Present Unexcused absence Excused absence Tardy. |
2.0 | eventDate | string | Required | Required | Date for this attendance event |
3.0 | schoolReference | integer | Required | Required | The identifier assigned to a school. |
4.0 | sessionReference | array |
|
|
|
5.0 | schoolId | integer | Required | Required | The identifier assigned to a school. |
6.0 | schoolYear | integer | Required | Required | The identifier for the school year. |
7.0 | sessionName | string | Required | Required | The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer). |
8.0 | studentReference |
|
|
|
|
9.0 | studentUniqueId | string | Required | Required | A unique alphanumeric code assigned to a student. |
10.0 | attendanceEventReason | string | Optional | Optional | The reported reason for a student's absence. |
12.0 | eventDuration | number | Optional | Optional | The amount of time for the event as recognized by the school: 1 day = 1, or 1/2 day = 0.5 |
13.0 | schoolAttendanceDuration | integer | Optional | Optional | The duration in minutes of the school attendance event. |
Descriptors:
Namespace | Code Value | Short Description | Long Description |
|---|
Namespace | Code Value | Short Description | Long Description |
|---|---|---|---|
uri://ed-fi.org/AttendanceEventCategoryDescriptor | Excused Absence | Excused Absence | Excused Absence |
Unexcused Absence | Unexcused Absence | Unexcused Absence | |
In Attendance | In Attendance | In Attendance | |
Tardy | Tardy | Tardy | |
Partial | Partial | Partial | |
Early departure | Early departure | Early departure |
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 a student absent for partial or a full-school day | The studentSchoolAttendanceEvent endpoint represents the recording of attendance taken by a teacher for a section. SIS/LEAs should only report negative attendance for students marked "Excused Absence", "Excused Absence", etc. A separate studentSchoolAttendanceEvent record is submitted for each student, each school of enrollment, and each date on which the student was absent for all or part of the day. Assumptions:
Note: "positive" attendance is not captured, and only the exceptions to being in attendance are captured ("Excused Absence", "Excused Absence", etc.) | POST on /studentSchoolAttendanceEvent: POST on /studentSchoolAssociation: POST /session: |
2.0 | Modifying student absence dates for a previously submitted record | At times, the LEA may not mark absences as excused until the approval for homebound status is granted. This delay impacts the student's attendance record, but once the approval is received, the LEA can retroactively designate the absences as excused. To update a student's attendance, follow these two steps: 1) Delete the inaccurate record, and 2) Create a new record with the correct date. | DELETE on /studentSchoolAttendanceEvent using the Ed-Fi ID (GUID). THEN POST on /studentSchoolAttendanceEvent |
3.0 | Sending attendance for a student who has multiple enrollments with in the same LEA but only one enrollment cover the count date. Test case for public school only | If a student has multiple enrollment records within the same district, and attendance before and after the count date in the district, the countDateReceivingServiceDescriptor should be reported as Present or Absent. Example:
In this specific case, if the student is reported as ‘Not Receiving Services’, a warning will be displayed in WISEdata Portal so that LEAs can review this student and verify the data is accurate in the SIS. LEAs should be able to override the student's countDateReceivingServiceDescriptor to be 'A - Absent'. | POST on /studentSchoolAssociation: -- School A and student was present at least before the count date POST on /studentSchoolAssociation: -- School B and student was absent all days including the count date POST on /studentSchoolAssociation: -- School C and student was present at least after the count date |
4.0 | Sending a attendance for a student who has a 'Membership' enrollment type Test case for public school only | Students who are outside of the age requirement that must be met for grade levels are reported with a 'membership' enrollment type. These students will have one of the following residency statuses: R-OUTSIDEAGE, or NR-OUTSIDEAGE.
| POST on /studentSchoolAttendanceEvent: POST on /studentSchoolAssociation: POST /session: |
5.0 | Sending attendance for a student enrolled part-time in a public school with a 'coursework' enrollment type. Test case for public school only | Students who are primarily homeschooled or enrolled in a private school but taking classes in a public school should have an attendance event. These students will have one of the following residency statuses: R-HOME, R-PRIVATE, and NR-HOME.
| POST on /studentSchoolAttendanceEvent: POST on /studentSchoolAssociation:
POST /session: |
6.0 | Sending a student enrollment record for a student who’s attending a private choice school, and receiving special education services in a public school district | In this specific case, the Choice school submits a primary (P) enrollment, and the Public school submits a Parent Placed Private (PPP) enrollment.
| Informational |
7.0 | Sending a student enrollment record for a student who’s taking coursework in multiple public schools |
| Informational |
JSON Sample:
Wisconsin Department of Public Instruction