Student Homeless Program Associations (Georgia v3.6.1)

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	Report a record when a student has a Homeless record that overlaps an enrollment AND the configured school year. Do not report a record if the any of the following exclusions are present: Enrollment State Exclude Enrollment No Show Enrollment Grade Exclude from State Reporting Calendar Exclude School Exclude The Programs record must exist in the ODS prior to sending a Student Homeless Program Associations record. If the Programs record does not already exist in the ODS, the Programs record will be sent prior to the Student Homeless Program Associations record. If there are multiple enrollments, use the following priority list to determine which one should report: Primary > Partial > SPED Earliest Start Date Latest Enrollment ID
Delete/Post/Put	A DELETE/POST is performed if the data element being altered is part of the resource's natural key. A PUT is performed otherwise. When the following information on a Homeless record is changed: Homeless Program ID (New Homeless record) Start Date End Date Primary Night Time Residence When the following information on an Enrollment is changed: Enrollment ID (New Enrollment) Start Date End Date No Show State Exclude
Delete	When the enrollment being reported off of is deleted. When the enrollment is changed to no longer overlap the configured year. When the student is excluded through their enrollment, calendar, grade level, or school. When the Homeless record being reported off of is deleted. When the Homeless record is changed to no longer overlap the configured year.

Action

Trigger

Post

Report a record when a student has a Homeless record that overlaps an enrollment AND the configured school year.

Do not report a record if the any of the following exclusions are present:
- Enrollment State Exclude
- Enrollment No Show
- Enrollment Grade Exclude from State Reporting
- Calendar Exclude
- School Exclude
The Programs record must exist in the ODS prior to sending a Student Homeless Program Associations record.
- If the Programs record does not already exist in the ODS, the Programs record will be sent prior to the Student Homeless Program Associations record.
If there are multiple enrollments, use the following priority list to determine which one should report:
- Primary > Partial > SPED
- Earliest Start Date
- Latest Enrollment ID

Delete/Post/Put

A DELETE/POST is performed if the data element being altered is part of the resource's natural key. A PUT is performed otherwise.

When the following information on a Homeless record is changed:
- Homeless Program ID (New Homeless record)
- Start Date
- End Date
- Primary Night Time Residence
When the following information on an Enrollment is changed:
- Enrollment ID (New Enrollment)
- Start Date
- End Date
- No Show
- State Exclude

Delete

When the enrollment being reported off of is deleted.
When the enrollment is changed to no longer overlap the configured year.
When the student is excluded through their enrollment, calendar, grade level, or school.
When the Homeless record being reported off of is deleted.
When the Homeless record is changed to no longer overlap 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 and Business Rules	Logic	M, C or O	Data Source GUI Path	Database Field
beginDate	The month, day, and year on which the Student first received services. Reports the Start Date	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 fields that are part of the Natural Key for the Schools resource. educationOrganizationId = Ed-Fi School ID	Reports the District Number	M	System Administration > Resources > School > Ed-Fi School ID	School.entityID
programReference	A reference to the Program Resource. Reports the fields that are part of the Natural Key for the Programs resource. educationOrganizationId = Ed-Fi School ID programName = Homeless (Hard-Coded). programTypeDescriptor = Homeless (Hard-Coded).	Reports the Natural Key for the Program	M	System Administration > Resources > School > Ed-Fi School ID	School.entityID
studentReference	A unique alpha-numeric code assigned to a student. Reports the fields that are part of the Natural Key for the Students resource. studentUniqueId = Student State ID	Reports the Natural Key for the Student resource.	M	Census > People > Demographics > Student State ID	Student.stateID
endDate	The month, day, and year on which the student exited the program or stopped receiving services. Reports the End Date.	Reports the end date of the Homeless record being reported.	C	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. Report the Ed-Fi Code mapped to the value selected for Primary Night Time Residence.	Report the Ed-Fi Code mapped to the value selected for 'Homeless Residence' on the Homeless record being sent. Do not report if 'Homeless Residence' on the Homeless record being sent is Blank/NULL.	M	Student Information > Program Participation > Homeless > Primary Night Time Residence	homeless.primaryNightTime Residence

Type/Descriptors

Click here to expand...

programTypeDescriptor

Code Value	Descripion	Namespace	Short Description
Homeless	Homeless	uri://gadoe.org/ProgramTypeDescriptor	Homeless

Homeless Primary Nighttime Residence Descriptor

Code Value	Description	Namespace	Short Description
1	Shelters	uri://gadoe.org/HomelessPrimaryNighttimeResidenceDescriptor	Shelters
2	Doubled-Up	uri://gadoe.org/HomelessPrimaryNighttimeResidenceDescriptor	Doubled-Up
3	Unsheltered	uri://gadoe.org/HomelessPrimaryNighttimeResidenceDescriptor	Unsheltered
4	Hotels/Motels	uri://gadoe.org/HomelessPrimaryNighttimeResidenceDescriptor	Hotels/Motels