Student Homeless Program Associations (Michigan v3.1)

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 Do not send a record if enrollment is in a calendar marked as Exclude. Do not send a record if enrollment is in a school marked as Exclude. Do not send a record if enrollment is marked as No Show or State Exclude.
Delete/Post	When any field part of the natural key is changed. When the following information on a Homeless record is changed: Start Date
Put	When any field not part of the natural key is changed When the following information on a Homeless record is changed: End Date Primary Night Time Residence Unaccompanied Youth
Delete	All enrollments are deleted for a student.
Delete	If the student's enrollment is marked as No Show or State Exclude.
Delete	If the Homeless record is deleted.
Delete	If 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	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.	Reports the start date of the Homeless record being reported.	M	Student Information > Program Participation > Homeless > Start Date	homeless.startDate
education Organization Reference	The education organization where the student is participating in or receiving the program services.	Reports the District Number	M
programReference	A reference to the Program Resource.	Reports the Natural Key for the Program	M
studentReference	A unique alpha-numeric code assigned to a student.	Reports the Natural Key for the Student resource.	M
awaitingFosterCare	State defined definition for awaiting foster care.	Do not report, this is optional.	O
endDate	The month, day, and year on which the student exited the program or stopped receiving services.	Reports the end date of the Homeless record being reported.	O	Student Information> Program Participation> Homeless> End Date	homeless.enddate
homelessPrimary Nighttime ResidenceDescriptor	Best describes the student's living situation at the time the student was 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.	C	Student Information > Program Participation > Homeless > Homeless Residence	homeless.primaryNightTime Residence
homelessProgram Services	Indicates the service(s) being provided to the Student by the Homeless Program.	Do not report, this is optional.	O
homeless UnaccompaniedYouth	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 Unaccompanied Youth = Y, report true. Else report false.	O	Student Information > Program Participation > Homeless > Unaccompanied Youth
reasonExited Descriptor	This descriptor defines the reason a student exited a program.	Do not report, this is optional.	O
servedOutside RegularSession	Indicates whether the Student received services during the summer session or between sessions.	Do not report, this is optional.	O

Type/Descriptors

Click here to expand...

Homeless Primary Nighttime Residence Descriptor

Code/Value	Description	Namespace	Short Description
Hotels/motels	Hotels/motels	uri://ed-fi.org/HomelessPrimaryNighttimeResidenceDescriptor	Hotels/motels
Shelters	Shelters	uri://ed-fi.org/HomelessPrimaryNighttimeResidenceDescriptor	Shelters
Unsheltered	Unsheltered	uri://ed-fi.org/HomelessPrimaryNighttimeResidenceDescriptor	Unsheltered

Homeless Program Service Descriptor

Code/Value	Description	Namespace	Short Description
Emergency Assistance	Emergency Assistance	uri://ed-fi.org/HomelessProgramServiceDescriptor	Emergency Assistance
Expedited Evaluations	Expedited Evaluations	uri://ed-fi.org/HomelessProgramServiceDescriptor	Expedited Evaluations
External Instructional Services	External Instructional Services	uri://ed-fi.org/HomelessProgramServiceDescriptor	External Instructional Services
Instructional Services	Instructional Services	uri://ed-fi.org/HomelessProgramServiceDescriptor	Instructional Services
Medical Referrals	Medical Referrals	uri://ed-fi.org/HomelessProgramServiceDescriptor	Medical Referrals
Specialized Instructional Support Services	Specialized Instructional Support Services	uri://ed-fi.org/HomelessProgramServiceDescriptor	Specialized Instructional Support Services
Transportation Services	Transportation Services	uri://ed-fi.org/HomelessProgramServiceDescriptor	Transportation Services

Arrays

Homeless Program Services

Data Element Label	Business Rules and Business Requirements	M, C, or O
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