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.

The Student Homeless Program Association reports from the Homeless tool.

Action	Trigger
Post	When a new enrollment is saved for a student, and there is a Homeless record saved that overlaps the enrollment record, OR When a new Homeless record is saved that overlaps one or more enrollment records. When a student has two enrollments in the same School, Calendar & Schedule Structure with the same start date, report from the enrollment service type in the following order: P: Primary Enrollment S: Partial/Ancillary N: Special Ed Services When an enrollment with a higher priority is deleted, the enrollment with lower priority will post a new record. When a student has two or more consecutive enrollments tied to the same school, if they overlap, the Homeless program records will be broken into multiple non-overlapping records, with the start date of the record matching the start date of the related enrollment, but the end date of the record calculated as the day before the enrollment start date of the next enrollment record. When a student has two or more consecutive enrollments tied to the different schools, if they overlap, multiple Homeless records will be sent. Do not send records if the Calendar Exclude check box is checked in the calendar the student is enrolled. Do not send records if the School Exclude check box is checked in the calendar the student is enrolled. Do not send a record if the No Show check box is checked. When a new reportable Homeless record is saved for a student, and there is a reportable enrollment record that overlaps the reportable Homeless record. When the reportable Homeless record's Start Date or End Date are updated so that they newly overlap a reportable enrollment record. When the Enrollment record's Start Date or End Date are updated so that they newly longer overlap a reportable Homeless record. When the Homeless Program record's Schools droplist was previously tied to a different school, but the Schools droplist is updated to point to a new school that the student has a reportable enrollment with. Do not send records if the Calendar Grade Level "Exclude from State Reporting" checkbox is selected for the grade level that the student's enrollment is tied to.
Put	When the start date for an enrollment is changed. When an enrollment with a lower priority is changed, data will not send.
Put	When an enrollment is updated for a student. When the Homeless record is updated for a student.
Delete	When an enrollment is deleted. When a student has two enrollments in the same school for the same start date, records with lower priority will not trigger a delete. When the No Show check box is checked. When the reportable Homeless record is deleted. When the reportable Homeless record's Start Date or End Date are updated so that they no longer overlap a reportable enrollment record. When the Enrollment record's Start Date or End Date are updated so that they no longer overlap a reportable Homeless record. When the Homeless Program record's Schools droplist is updated so that it no longer matches any of the schools the student is enrolled in during the program record.

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	If a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
Resync	If a record is in the Ed-Fi Identity Mapping table and not in the ODS, it will be deleted from the Ed-Fi Identity Mapping table.
Resync	If a record is in the ODS and it does not have a matching record in Campus or the Ed-Fi Identity Mapping table, it will be deleted from the ODS.
Resync	If a mapping is changed in Resource Preferences, a resync will need to be done 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: LEA Reference - District Numbers cannot change after data has been sent. If a district number changes, we would expect an Ed-Fi error and this change would not be supported. If an Ed-Fi ID changes, a delete/post will occur with the cascading deletes from the Ed-Fi ID Change triggers. If the Program Name or Program Type Descriptor mapping changes and a resync is completed. If the Start Date of the program record changes.
Delete	Cascading Deletes: N/A - no dependent resources.

Action

Trigger

Post/Delete

Natural Key changes:

LEA Reference - District Numbers cannot change after data has been sent. If a district number changes, we would expect an Ed-Fi error and this change would not be supported.
If an Ed-Fi ID changes, a delete/post will occur with the cascading deletes from the Ed-Fi ID Change triggers.
If the Program Name or Program Type Descriptor mapping changes and a resync is completed.
If the Start Date of the program record changes.

Delete

Cascading Deletes: N/A - no dependent resources.

Scope Year Logic

This table describes scope year logic of this object.

Logic
The record will send to any year the homeless record overlaps with if the student has an enrollment in that year.
Data will only send for the years that have valid configuration.

Resource Preferences

Data Element Label	Mapping Needed
Homeless Primary Nighttime Residence Descriptor	Homeless Primary Night Time Residence
Homeless Unaccompanied Youth	Homeless Unaccompanied Youth

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 Requirement	Logic	M, C or O	Data Source GUI Path	Database Field
id	The unique identifier of the resource.		M
beginDate	The month, day, and year on which the Student first received services.	Report the Start Date from the Homeless record. If the Enrollment Start Date takes place after the Homeless record Start Date, report the Enrollment Start Date.	M	Student Information> Program Participation> Homeless> Start Date	homeless.startDate enrollment. startDate
education Organization Reference	educationOrganizationId The education organization where the student is participating in or receiving the program services.	Report the Ed-Fi School ID. If Ed-Fi School ID is NULL, report: ttddddsssmmm where: tt = district type dddd = district number, left zero filled sss = school number, left zero filled mmm = 000 for all organizations reported in Ed-Fi	M	School & District Settings > Schools > School Information > school record > Ed-Fi School ID tt: School & District Settings > District > District Information > district record > Type dddd: School & District Settings > District > District Information > district record > State District Number SSS: School & District Settings > Schools > School Information > school record > State School Number	School.entityID District.type District.number School.number
program Reference	educationOrganizationId The identifier assigned to an education organization. programName The formal name of the Program of instruction, training, services, or benefits available through federal, state, or local agencies. programTypeDescriptor The type of program.	Report the following values within the program. educationOrganizationId: Report the Ed-Fi District Number, if it exists If Ed-Fi District Number is NULL, report: ttddddsss where: tt = district type dddd = district number, left zero filled sss = 000 programName: 'Alternative Learning Program' programTypeDescriptor: 'Alternative Learning Program'	M	School & District Settings > District > District Information > district record > Ed-Fi District Number tt: School & District Settings > District > District Information > district record > Type dddd: School & District Settings > District > District Information > district record > State District Number	District.entityID District.type District.number
student Reference	A unique alpha-numeric code assigned to a student.	Reports the Natural Key for the Student resource.	M
awaitingFoster Care	State defined definition for awaiting foster care.	This is optional, does not report.	O
endDate	The month, day, and year on which the student exited the program or stopped receiving services.	Report the End Date from the Homeless record, if it exists. If no Homeless record End Date exists, do not report.	C	Student Information > Program Participation > Homeless > End Date	Homeless.endDate
homeless Primary Nighttime Residence Descriptor	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 in the Homeless Resource Preferences for this field. If mapping does not exist, do not report.	O	Student Information> Program Participation> Homeless> Primary Night Time Residence	homeless. primaryNight TimeResidence
homeless Program Services	Indicates the service(s) being provided to the Student by the Homeless Program.	This is optional, does not report.	O
homeless Unaccompanied Youth	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.	If '1' or '2' are selected, report 'true'. Otherwise, do not report.	C	Student Information > Program Participation > Homeless > Unaccompanied Status	homeless. unacommpanied Youth
reasonExited Descriptor	This descriptor defines the reason a student exited a program.	This is optional, does not report.	O
servedOutside Regular Session	Indicates whether the Student received services during the summer session or between sessions.	This is optional, does not report.	O

Arrays

Click here to expand...

Homeless Program Services

Data Element Label	Business Requirement	M, C or O
homelessProgramServiceDescriptor	Indicates the service being provided to the student by the Homeless Program.	M
primaryIndicator	True if service is a primary service.	O
serviceBeginDate	First date the Student was in this option for the current school year.	O
serviceEndDate	Last date the Student was in this option for the current school year.	O

Resource Preferences Continued

The Ed-Fi Configuration tool is used to establish Ed-Fi data resources.

The following describes how to set the resource preferences for the Student Homeless Program Associations resource. If the Configure or Edit buttons do not display, then the resource does not need to be mapped and the toggle button can be used to turn the resource on or off.

If a mapping is changed, a resync must be performed on the resource in order for the new mappings to send correctly. Any item not mapped will not report to Ed-Fi.

Select the appropriate Ed-Fi Code for the Homeless Primary Night Time Residency Descriptors.

Homeless Primary Night Time Residency Descriptors
UI Location	Student Information > Program Participation > Homeless > Primary Night Time Residence
Attribute/Dictionary	System Settings > Custom Data and Links > Core Attribute/Dictionary > Homeless > Primary Night Time Residence

Select all Homeless Unaccompanied Youth options that indicate the student is homeless unaccompanied youth.

The Homeless Unaccompanied Youth mapping only displays if the state uses a droplist for Unaccompanied Youth on the Homeless tool. If a checkbox is used for Unaccompanied Youth on the Homeless tool, then the mapping is not shown.

Homeless Unaccompanied Youth Options
UI Location	Student Information > Program Participation > Homeless > Unaccompanied Youth
Attribute/Dictionary	System Settings > Custom Data and Links > Core Attribute/Dictionary > Homeless > Unaccompanied Youth

Click Save.

MN v3.3 - Student Homeless Program Associations