Tool Search: Ed-Fi
This event entity represents an occurrence of an infraction ranging from a minor behavioral problem that disrupts the orderly functioning of a school or classroom (such as tardiness) to a criminal act that results in the involvement of a law enforcement official (such as robbery). A single event (e.g., a fight) is one incident regardless of how many perpetrators or victims are involved. Discipline incidents are events classified as warranting discipline action.
Object Triggering
This table describes logic for triggering syncing of this object.
| Action | Trigger |
|---|---|
| Post | Reports when a Behavior Resolution is added to an incident that is marked as Complete and is aligned to a reported Behavior Event.
|
| Put | When data that is not part of the Natural Key is changed.
|
| Delete/Post | When the Incident's status is changed.
|
| Delete | When an event is deleted. |
| Delete | When all non-excluded enrollments in the school and year are deleted. |
Resource Toggle/Resync
Action | Business Rule |
|---|---|
| None | When a resource is toggled to off after data has sent, all sent data remains in the ODS, but no new data sends. |
| Resync | When 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. |
| Resync | When 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. |
| Resync | When a mapping is changed in Resource Preferences, a resync must be done to reflect the changes. |
Natural Key Changes/Cascading Updates, Deletes
Action | Business Rule |
|---|---|
| Post/Delete | Natural Key changes:
|
| Delete/Post | When the Incident is deleted, all dependent resources deletes.
(Note: When a user deletes Student Discipline Incident Associations using the Delete Tool, the associated Discipline Actions are also deleted when Discipline Actions are auto-selected because of the dependency. The user would need to resync the Discipline Actions after this type of deletion.) |
Scope Year
| Business Rules |
|---|
| Discipline records are only sent to the school year they are aligned to. |
| Data is only sent for the years that have valid configurations. |
Resource Preferences
| Data Element Label | Mapping Needed |
|---|---|
| Behavior Event Role | Student Participation Code Descriptor |
Identity Mapping Object Key
| Data Element Label | Mapping Needed |
|---|---|
| BehaviorRole | incidentID-personID |
Event Queue Detail
Campus Table | Ed-Fi Action | Fields |
|---|---|---|
| behaviorEvent | 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 | Description | M, C, or O | Database Location |
|---|---|---|---|
| id | The unique identifier of the resource. | M | |
| behaviorDescriptor | Describes behavior by category. Reports all behavior events that are associated with the incident.
When a code is not mapped, does not report. | M | Behavior Management > Event Details > State Code behaviorType.code behavior type.name |
| disciplineIncidentReference | A reference to the related Discipline Incident resource. Reports the fields that are part of the Natural Key for the Discipline Incident resource.
| M | |
| studentReference | A reference to the related Student resource. Reports the data that is part of the Natural Key for the Student resource.
| M |
Descriptors
