Tool Search: Ed-Fi
This association represents the McKinney-Vento Homeless Program program(s) that a student participates in or from which the Student receives services.
Object Triggering Logic
This table describes logic for triggering syncing of this object.
| Action | Trigger |
|---|---|
| Post | When a Homeless record overlaps the configured year and the student has an enrollment in the configured year.
|
| Delete/Post | When any field part of the natural key is changed:
|
| Put | When any field not part of the natural key is changed.
|
| Delete | All enrollments are deleted for a student. |
| Delete | When the student's enrollment is marked as No Show or State Exclude. |
| Delete | When the Homeless record is deleted. |
| Delete | When the start/end dates on the Homeless record are updated so the record no longer overlaps the configured year. |
School Exclude, Calendar Exclude, Resource Toggle and Resync Logic
This table describes the School Exclude, Calendar Exclude, Resource Toggle and Resync logic of this object.
| Action | Trigger |
|---|---|
| None | When a resource is toggled to OFF after data has sent, all sent data remains in the ODS but no new data is sent. |
| Resync | When a record is in the Ed-Fi Identity Mapping table and not in the ODS, it is deleted from the Ed-Fi Identity Mapping table. |
| Resync | When a record is in the ODS and it does not have a matching record in Campus or the Ed-Fi Identity Mapping table, it is deleted from the ODS. |
| Resync | When a mapping is changed in Resource Preferences, a resync is needed to reflect the changes. |
Natural Key Changes, Cascading Updates, and Deletes Logic
This table describes the Natural Key Changes/Cascading Updates and Deletes logic of this object.
| Action | Trigger |
|---|---|
| Post/Delete | Natural Key changes:
|
| Delete | Cascading Deletes: N/A - no dependent resources. |
Scope Year Logic
This table describes scope year logic of this object.
| Logic |
|---|
The record sends to any year the homeless record overlaps with when the student has an enrollment in that year. |
| Data only sends for the years that have a valid configuration. |
Resource Preferences
Data Element Label | Mapping Needed | Comments |
|---|---|---|
| homelessPrimaryNighttimeResidenceDescriptor | Homeless Primary Night Time Residence | |
| homelessUnaccompaniedYouth | Homeless Unaccompanied Youth | This mapping only shows in states where the Unaccompanied Youth field is a dropdown list. When it is a checkbox, the mapping does not show. |
| Select the Program Type Descriptor associated with this Program. | Program Type Descriptor |
Event Queue Detail
This table describes the Event Queue Detail of this object.
| Campus Table | Ed-Fi Action | Fields |
|---|---|---|
| homeless | Post/Put/Delete | The primary table for sending data for this resource. |
Object Data Elements
Data Element Labels in bold are part of the Natural Key and are required data elements for Data to send to Ed-Fi.
| Data Element Label | Business Requirements and Rules | Mandatory, Conditional or Optional | Location |
|---|---|---|---|
| beginDate | The month, day, and year on which the Student first received services. Reports the latest of the Homeless record's Start Date and the student's active (Primary) Enrollment Start Date in the configuration year. When multiple enrollments exist for the student in the current configuration year, reporst the Start Date of the active (Primary) enrollment record. | M | Homeless > Start Date homeless.startDate Enrollment > General Enrollment Informaiton Enrollment.startDate |
| educationOrganizationReference | The education organization where the student is participating in or receiving the program services. Reports the Ed-Fi School ID of the Accountability School for the educationOrganizationId Logic for determining Accountability School:
| M | Enrollments > State Reporting Fields > AYP Override 1 EnrollmentKS.schoolAYP! School Information > Ed-Fi School ID School.entityID |
| programReference | A reference to the Program Resource. Reports the Natural Key for the Program.
| M | Enrollments > State Reporting Fields > AYP Override 1 EnrollmentKS.schoolAYP! School Information > Ed-Fi School ID School.entityID |
| studentReference | A unique alpha-numeric code assigned to a student. Reports the Natural Key for the Student resource
| M | Homeless |
| awaitingFosterCare | State defined definition for awaiting foster care. This is optional and does not report. | O | |
| endDate | Date on which the student exited the program or stopped receiving services. Reports the end date of the Homeless record. When blank, does not report. | C | Homeless > End Date Homeless.enddate |
| homelessPrimaryNighttime ResidenceDescriptor | The primary nighttime residence of the student at the time the student is identified as homeless. Reports the Ed-Fi Code from the mapped value selected for Primary Nighttime Residence on the Homeless record being reported. When not mapped, does not send. | C | Homeless > Primary Night Time Residence Homeless.primaryNightTime Residence |
| homelessProgramServices | Indicates the service(s) being provided to the Student by the Homeless Program. This is optional and does not report. | O | |
| homelessUnaccompaniedYouth | A homeless unaccompanied youth is a youth who is not in the physical custody of a parent or guardian and who fits the McKinney-Vento definition of homeless. Students must be both unaccompanied and homeless to be included as an unaccompanied homeless youth. When the Unaccompanied Youth fields is set to No and Primary Night Time Residence code is 1, 2, 3 or 4, reports a value of 1. Then Otherwise, reports a value of zero (0). | O | Homeless > Unaccompanied Youth Homeless.unacommpanied Youth |
| reasonExitedDescriptor | This descriptor defines the reason a student exited a program. This is optional and does not report. | O | |
| servedOutsideRegularSession | Indicates whether the Student received services during the summer session or between sessions.
| O |
