Student Homeless Program Associations (Kansas v3.6)

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.

ActionTrigger
Post

When a Homeless record overlaps the configured year and the student has an enrollment in the configured year.

  • Does not send a record when an enrollment is in a calendar marked as Exclude.
  • Does not send a record when an enrollment is in a school marked as Exclude.

  • Does not send a record when enrollment is marked as No Show or State Exclude.

Delete/Post

When any field part of the natural key is changed:

  • Start Date
Put

When any field not part of the natural key is changed.

  • End Date
  • Primary Night Time Residence
  • Unaccompanied Youth
Delete

All enrollments are deleted for a student.

DeleteWhen the student's enrollment is marked as No Show or State Exclude.
DeleteWhen the Homeless record is deleted.
DeleteWhen 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.

ActionTrigger
NoneWhen a resource is toggled to OFF after data has sent, all sent data remains in the ODS but no new data is sent.
ResyncWhen 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.
ResyncWhen 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.
ResyncWhen 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.

ActionTrigger
Post/Delete

Natural Key changes:

  • LEA Reference - District Numbers cannot change after data has been sent. When a district number changes, an error is expected and this change would not be supported.
  • When an Ed-Fi ID changes, a delete/post occurs with the cascading deletes from the Ed-Fi ID Change triggers.
  • When the Program Name or Program Type Descriptor mapping changes and a resync is completed.
  • When the Start Date of the program record changes.
DeleteCascading 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
homelessPrimaryNighttimeResidenceDescriptorHomeless Primary Night Time Residence
homelessUnaccompaniedYouthHomeless Unaccompanied YouthThis 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 TableEd-Fi ActionFields
homelessPost/Put/DeleteThe 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 LabelBusiness Requirements and RulesMandatory, Conditional or OptionalLocation
beginDateThe 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.
MHomeless > Start Date
homeless.startDate
Enrollment > General Enrollment Informaiton

Enrollment.startDate

educationOrganizationReferenceThe 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:

  • Reports from Enrollment Override location.
  • When the Override location is NULL, reports State School Number.
M

Enrollments > State Reporting Fields > AYP Override 1


EnrollmentKS.schoolAYP!


School Information > Ed-Fi School ID


School.entityID

programReferenceA reference to the Program Resource.

Reports the Natural Key for the Program.

  • educationOrganizationId = Ed Fi School ID of the Accountability School
    • Reports from Enrollment Override location
    • When the Override location is NULL, reports State School Number
  • programName = Homeless
  • programTypeDescriptor = Descriptor code  Homeless  
M

Enrollments > State Reporting Fields > AYP Override 1


EnrollmentKS.schoolAYP!


School Information > Ed-Fi School ID


School.entityID


studentReferenceA unique alpha-numeric code assigned to a student.

Reports the Natural Key for the Student resource

  • studentUniqueID reports from the Student State ID field.
MHomeless
awaitingFosterCare

State defined definition for awaiting foster care.


This is optional and does not report.

O
endDateDate 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.

CHomeless > Primary Night Time Residence
Homeless.primaryNightTime
Residence
homelessProgramServicesIndicates 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). 

OHomeless > Unaccompanied Youth

Homeless.unacommpanied
Youth
reasonExitedDescriptorThis 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.


This is optional and does not report.

O

Arrays

Click here to expand...

Homeless Program Services

Data Element LabelBusiness RequirementMandatory, Conditional or Optional
homelessProgramServiceDescriptorIndicates the service being provided to the student by the Homeless Program.M
primaryIndicator

True when the 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

Type/Descriptors

Click here to expand...

Homeless Primary Nighttime Residence Descriptor

Code ValueDescriptionNamespaceShort Description
Doubled-upDoubled-upuri://ed-fi.org/HomelessPrimaryNighttimeResidenceDescriptorDoubled-up
Hotels/motelsHotels/motelsuri://ed-fi.org/HomelessPrimaryNighttimeResidenceDescriptorHotels/motels
SheltersSheltersuri://ed-fi.org/HomelessPrimaryNighttimeResidenceDescriptorShelters
UnshelteredUnsheltereduri://ed-fi.org/HomelessPrimaryNighttimeResidenceDescriptorUnsheltered

Program Type Descriptor

Code ValueDescriptionNamespaceShort Description
English as a Second Language (ESL)English as a Second Language (ESL)uri://ed-fi.org/ProgramTypeDescriptorEnglish as a Second Language (ESL)
HomelessHomelessuri://ed-fi.org/ProgramTypeDescriptorHomeless
Student School Food ServiceStudent School Food Serviceuri://ed-fi.org/ProgramTypeDescriptorStudent School Food Service
Title I Part ATitle I Part Auri://ed-fi.org/ProgramTypeDescriptorTitle I Part A
Kansas Parents as Teachers ProgramKansas Parents as Teachers Programuri://ed-fi.org/ProgramTypeDescriptorKansas Parents as Teachers Program
Kansas Pre-K Pilot ProgramKansas Pre-K Pilot Programuri://ed-fi.org/ProgramTypeDescriptorKansas Pre-K Pilot Program