Student Homeless Program Associations (New Mexico v3.5)

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.

  • 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.

  • Do not send a record if enrollment is in a calendar with Summer School checked.

Delete/Post

When any field part of the natural key is changed:

  • Enrollment Start Date
Put

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

When the following information on the Homeless record being reported is changed:

  • End Date
  • Homeless Residence
  • Unaccompanied Youth
Delete

All enrollments are deleted for a student.

DeleteIf the student's enrollment is marked as No Show.
DeleteIf the Homeless record is deleted.
DeleteIf 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
NoneIf a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
ResyncIf 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.
ResyncIf 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.
ResyncIf 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.

ActionTrigger
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.
DeleteCascading 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 DescriptorHomeless Primary Night Time Residence
Homeless Unaccompanied YouthHomeless Unaccompanied Youth

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 RequirementLogicM, 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 of the student's enrollment.

  • If multiple enrollments exist for the student in the current config year, report the Start Date of the earliest enrollment record.
M

Student Information > General > Enrollment > Start Date

enrollment.startDate
education
Organization
Reference
The education organization where the student is participating in or receiving the program services.

Report the Ed-Fi School ID for the education Organization Id.

M

System Administration > Resources > School > Ed-Fi School ID


programReferenceA reference to the Program Resource.

Report the Natural Key from the Programs resource.

  • Report the Ed-Fi District Numbefor educationOrganizationId.
  • Report Homeless for programName.
  • Report Homeless for ProgramTypeDescriptor.
M Student Information > Program Participation > Homeless
studentReferenceA 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.

This is optional, does not report.

O

endDateThe 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.

  1. Report the Ed-Fi Code mapped to the value selected for 'Homeless Residence' on the Homeless record being sent.
  2. Do not report if 'Homeless Residence' on the Homeless record being sent is Blank/NULL.
CStudent Information > Program Participation > Homeless >Homeless Residencehomeless.primaryNightTime
Residence
homelessProgram
Services
Indicates the service(s) being provided to the Student by the Homeless Program.

This is optional, does not report.

O

homeless
UnaccompaniedYouth

Indicates whether or not the student, if homeless, is an unaccompanied youth.

  1. Report True if 'Unaccompanied Youth' on the Homeless record being sent is Yes: Yes.
  2. Report False if 'Unaccompanied Youth' on the Homeless record being sent is No: No.
  3. Do not report if 'Unacoompanied Youth' on the Homeless record being sent is Blank/NULL.
CStudent Information> Program Participation> Homeless> Unaccompanied Youth

homeless.primaryNightTimeResidence

homeless.unaccompaniedYouth


reasonExited
Descriptor
This descriptor defines the reason a student exited a program.

This is optional, does not report.

O

servedOutside
RegularSession

Indicates whether the Student received services during the summer session or between sessions.

This is optional, does not report.

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

NamespaceCodeShort DescriptionDescription
uri://nmped.org/ProgramTypeDescriptorHomelessHomelessAn indication of whether a student is homeless as defined by McKinney Vento.