Needs are reported from the State Reporting Enrollment fields, FRAM, Flags, locked IEPs and LEP Services. This resource identifies any needs that a student may need to participate in for a program.
For the 23-24 Configuration year, this resource includes Homeless and Unaccompanied Youth logic.
For the 24-25 Configuration year and future, this resource does NOT include Homeless and Unaccompanied Youth logic. Instead, that logic is included in the Student Homeless Program Associations Resource.
Flags and Programs
The tables below describe the logic for triggering syncing of this object for Flags and Programs only. Expand one of the areas below to see full requirements:
Object Triggering Logic for Flags and Programs
This reports from BOTH Programs and Flags. Districts should choose only ONE method and stay consistent. When a need is created in both areas, two records are sent.
Action | Trigger |
---|---|
Post |
Report a record based on the students enrollment record: Service Type = P.
|
Post |
When a Flag/Program is created and saved for a student that is mapped to a state program code.
|
Post | When a Need is changed on an existing Flag/Program for a student with a need populated. |
Post |
When a new enrollment is created for a student that has an active Flag/Program mapped to a state program code.
|
Delete/Post |
When a start or end date is entered or changed for an existing record.
|
Delete/Post | When an enrollment end date is entered for a student with a valid enrollment end status: W1-W13. |
Delete | Deletes the existing record when a need is changed on an existing flag/program. |
Delete |
Flag/Program is deleted for a student. |
Delete | When a student's enrollment Start Status is changed from a valid code to E: NON-SAIS DISTRICT USE ONLY! and saved. |
Delete | When an existing enrollment is marked as State Exclude or No Show. |
Scope Year Logic for Flags and Programs
Logic |
---|
When a new Flag/Program is created, the record reports in the Scope Year that the record start date overlaps with.
|
When the record is triggered from enrollments, the record sends to the scope year for the school year the enrollment is associated with.
|
Object Data Elements for Flags and Programs
Data Element Label | Business Requirements and Rules | Mandatory, Conditional or Optional | Location |
---|---|---|---|
id | The unique identifier of the resource. | M |
|
Education
Organization Reference |
A reference to the related Education Organization resource.
Report the School Entity ID. |
M | School Information > School Detail > Entity ID
school.entity id |
studentReference |
A reference to the related Student resource.
Reports the student reference.
The Ed-Fi ID reports from the Student State ID field. |
M |
|
studentNeed
Descriptor |
The program descriptor of the student need.
|
M | Flags > Need
programparticipation.need |
studentNeedEntry
Date |
The date the student was identified with the need.
|
M |
Flags > Start Date
programparticipation.StartDate
Enrollment > Start Date
enrollment.startdate |
StudentNeedExit
Date |
The date the student is no longer identified with the need.
|
C |
Flags > End Date
programparticipation.EndDate
Enrollment > End Date
enrollment.enddate
Days Setup |
primaryStudentNeed
Indicator |
Indicates when this is a primary need for the student.
Do not report, not required from Flags. |
O |
|
_etag |
|
O |
|
Types and Descriptors for Flags and Programs
Code | Short Description |
---|---|
8 | Immigrant |
9 | Neglected |
10 | Delinquent |
16 | Refugee |
26 | Chronic Health Problem, A.R.S. § 15-346 |
20 | Evacuee |
Gifted
The tables below describe the logic for triggering syncing of this object for Gifted only. Expand one of the areas below to see full requirements
Object Triggering Logic for Gifted
Action | Trigger |
---|---|
Post |
Report a record based on a Gifted record being saved and overlapping the students enrollment record: Service Type = P
|
Post |
When a Gifted record is created and saved for a student.
|
Delete/Post | When the Gifted Need dropdown is changed on an existing Gifted record for a student. |
Post |
When a new enrollment is created for a student that has an active Gifted record:
|
Post | When a start or end date is entered or changed for an existing record:
|
Delete/Post | When an enrollment end date is entered for a student with a valid enrollment end status: W1-W13. |
Delete | Delete the existing need when a need is changed on an existing Gifted record. |
Delete | Gifted record is deleted for a student. |
Delete | When a student's enrollment Start Status is changed from a valid code to E: NON-SAIS DISTRICT USE ONLY! and saved. |
Delete | When an existing enrollment is marked as State Exclude or No Show. |
Delete/Post | When the enrollment tied to the Gifted record is deleted or made ineligible, and there is another eligible enrollment in the student's record (another overlapping one with perhaps a lower ranked Status value, non-excluded). |
Delete | Gifted record's start date or end date is changed, such that it no longer overlaps an eligible enrollment |
Delete | When there is a delete/edit to the eligible enrollment reporting is based on, such that there are no longer any eligible enrollments. |
Scope Year Logic for Gifted
Logic |
---|
When a new Gifted record is created, the record reports in the Scope Year that the record start date overlaps with.
|
When the record is triggered from enrollments, the record sends to the scope year for the school year the enrollment is associated with.
|
Object Data Elements for Gifted
Data Element Label | Business Requirement and Rules | Mandatory, Conditional, or Optional | Location |
---|---|---|---|
id | The unique identifier of the resource. | M |
|
EducationOrganizationReference |
A reference to the related Education Organization resource.
Report the School Entity ID.
|
M | School Information > School Detail > Entity ID
school.entity id |
studentReference |
A reference to the related Student resource.
Report the student reference.
Note: The Ed-Fi ID reports from the Student State ID field. |
M |
|
studentNeedDescriptor |
The program descriptor of the student need.
Report Codes value from the Gifted Need dropdown. |
M | Gifted > Gifted Need |
studentNeedEntryDate |
The date the student was identified with the need.
|
M |
Gifted > Start Date
gifted.startDate
Enrollment > Start Date
enrollment.startdate |
StudentNeedExitDate |
The date the student is no longer identified with the need.
|
C |
Gifted > End Date
gifted.endDate
Enrollment > End Date
enrollment.enddate
Day Setup |
primaryStudentNeedIndicator |
Indicate when this is a primary need for the student.
Do not report, not required from Gifted record. |
O |
|
_etag |
|
O |
|
Homebound
Object Trigger Logic for Homebound
Action | Trigger |
---|---|
Post |
Reports a record based on the students enrollment record: Service Type = P
|
Post |
When a Homebound record is created and saved for a student:
|
Post | When a new enrollment is created for a student that has an active Homebound record:
|
Post | When a start or end date is entered or changed for an existing record:
|
Delete/Post | When an enrollment end date is entered for a student with a valid enrollment end status: W1-W13. |
Delete | Homebound record is deleted for a student. |
Delete | When a student's enrollment Start Status is changed from a valid code to E: NON-SAIS DISTRICT USE ONLY! and saved. |
Delete |
When an existing enrollment is marked as State Exclude or No Show. |
Delete/Post | When the enrollment tied to the Homebound record is deleted or made ineligible, and there is another eligible enrollment in the student's record (another overlapping one with perhaps a lower ranked Status value, non-excluded) |
Delete | Homebound record's start date or end date is changed, such that it no longer overlaps an eligible enrollment. |
Delete |
When there is a delete/edit to the eligible enrollment reporting is based on, such that there are no longer any eligible enrollments. |
Scope Year Logic for Homebound
Logic |
---|
When a new Homebound record is created, the record reports in the Scope Year that the record start date overlaps with.
|
When the record is triggered from enrollments, the record only sends to the scope year for the school year the enrollment is associated with.
|
Object Data Elements for Homebound
Data Element Label | Business Requirement and Rules | Mandatory, Conditional, or Optional | Location |
---|---|---|---|
id | The unique identifier of the resource. | M |
|
EducationOrganization
Reference |
A reference to the related Education Organization resource.
Reports the School Entity ID. |
M | School Information > School Detail > Entity ID
school.entity id |
studentReference | A reference to the related Student resource.
Reports the student reference.
The Ed-Fi ID reports from the Student State ID field |
M |
|
studentNeedDescriptor | The program descriptor of the student need.
Reports the code '11' for Homebound when a Needs record stems from a Homebound Tab record. |
M | Homebound |
studentNeedEntryDate | The date the student was identified with the need.
|
M |
Homebound > Start Date
Enrollment > Start Date
enrollment.startdate |
StudentNeedExitDate | The date the student is no longer identified with the need.
|
C |
Homebound > End Date
enrollment.enddate
Day Setup |
primaryStudentNeedIndicator | Indicate when this is a primary need for the student.
|
O |
|
_etag |
|
O |
|