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 the Guardian check box is checked AND one person is a student and one person is not a student. The guardian does NOT have to be a member of the same household as the student to report. Start date must be on or before today's date. End date must be on or after today's date. A record is not sent if the student to which they are associated has an enrollment marked as No Show, State Exclude or the enrollment is in a calendar marked as Exclude.
Put	When the Guardian check box is checked or relationship type is changed.
Delete	When the Guardian check box is unchecked, relationship is end dated or deleted..

Action

Trigger

Post

When the Guardian check box is checked AND one person is a student and one person is not a student.

The guardian does NOT have to be a member of the same household as the student to report.
Start date must be on or before today's date.
End date must be on or after today's date.

A record is not sent if the student to which they are associated has an enrollment marked as No Show, State Exclude or the enrollment is in a calendar marked as Exclude.

Put

When the Guardian check box is checked or relationship type is changed.

Delete

When the Guardian check box is unchecked, relationship is end dated or deleted..

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
A record will report when they are a guardian to a student with an enrollment aligned to a scoped year. The related pair start date must be null or on/before the scope year end date to report. The related pair end date must be null or on/after the scope year end date to report.
Data will only send for the years that have valid configuration.
A resync must be completed on the resource when a new scope year is configured in order for this data to send.
When using data in Campus that have start and end dates, the following logic will be applied to determine the scope year(s) to report the data to. Current Year: The records start date must be on or before today's date and the records end date must be on or after today's date. Previous Years: The record's start date must be on or before the school year's end date and the record's end date must be after the school year's end date defined in the School Years editor. If blank, the default date of 6/30/xxxx is used. Future Years: The record's start date must be on or before the schools year's start date and the record's end date must be on or after the school year's start date defined in the School Years editor. If blank, the default date of 7/01/xxxx is used.

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 droplist. If 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 Requirement	M, C or O	Data Source GUI Path
Id	The unique identifier of the resource.	M
educationOrganization Reference	The education organization where the student is participating in or receiving the program services. Reports District ID and Reports 000 for school number.	M	System Administration > Resources > District information> DistrictID + 000 Example: Millard 280017000
programReference	A reference to the related Program resource. Reports the Natural Key from the Programs resource. For programReference Type, report 'Other'. For programReference Name, report 'Homeless'.	M
studentReference	A unique alpha-numeric code assigned to a student. Reports the Natural Key from the Student resource.	M
beginDate	The month, day, and year on which the Student first received services.	M	Index> Student Info> Program Participation> Homeless> StartDate
endDate	The month, day, and year on which the Student exited the Program or stopped receiving services.	O	Index> Student Info> Program Participation> Homeless> End Date
reasonExitedDescriptor	A unique identifier used as Primary Key, not derived from business logic, when acting as Foreign Key, references the parent table. Optional, do not report.	O
servedOutsideOf RegularSession	Indicates whether the student received services during the summer session or between sessions. Optional, do not report.	O
Primary Night Time Residence	Best describes the student's living situation at the time the student was identified as homeless. Report the Ed-Fi Code from the value selected in the droplist on Homeless. If field is blank, do not report.		Student Information> Program Participation> Homeless Enrollment.homeless
unaccompaniedYouth	Indicates whether or not the student, if homeless, is an unaccompanied youth.		Index> Student Info> Program Participation> Homeless> Unaccompanied Youth
services	An unordered collection of studentProgramAssociationServices. Indicates the services being provided to the student by the program. Optional, do not report.	O

Type/Descriptors

Click here to expand...

Primary Nighttime Residence

Code Value	Short Description	Description
01	Homeless - Shelters	Homeless - Shelters
02	Homeless - Doubled Up	Homeless - Doubled Up
03	Homeless - Unsheltered	Homeless - Unsheltered
05	Homeless - Hotel or Motel	Homeless - Hotel or Motel

Student Homeless Program Associations (Nebraska v3.6)