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.
This resource is only available in Ed-Fi versions 3.5.2 and higher.
Object Triggering Logic
This table describes logic for triggering syncing of this object.
| Action | Trigger |
|---|---|
| Post | Reports a behavior incident when the incident Status is marked and saved as "Complete" and the following criteria is met:
|
| Put | When data that is not part of the Natural Key is changed.
|
| Delete | When the student's enrollment is no longer reportable; marked:
|
| Delete | When the participants are removed or Role is changed so there is no longer a perpetrator. |
| Delete | If the Discipline Action that triggered the Incident is deleted or modified so it is no longer eligible to report. |
| Delete | When all Student Discipline Incident Associations are deleted that are associated with this Discipline Incident record. |
| Delete | When the student's Student School Association is deleted. |
| Delete/Post | When the Incident's status is changed.
|
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:
|
| Delete/Post | If the Incident is deleted all dependent resources will delete. |
| Dependent Resources | Discipline Action (Note: When a user deletes Student Discipline Incident Behavior Associations using the Delete Tool, the associated Discipline Actions are also deleted when Discipline Actions are auto selected because of the dependency. The user needs to resync the Discipline Actions after this type of delete.) |
Scope Year Logic
This table describes scope year logic of this object.
| Logic |
|---|
Discipline records will only send to the school year that the incident date is aligned to.
|
Resource Preferences
Data Element Label | Mapping Needed |
|---|---|
| Behavior Event Role | Student Participation Code Descriptor |
| Removal Reason | Behavior Descriptor |
Identity Mapping Object Key
Campus Object Type | Object Key Data Source |
|---|---|
| BehaviorRole | incidentID-eventID-personID |
Event Queue Detail
This table describes the Event Queue Detail of this object.
| 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 | Business Requirement | Business Rules | M, C or O | Data Source GUI Path | Database Field |
|---|---|---|---|---|---|
| id | The unique identifier of the resource. | M | |||
| discipline Incident Reference | 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 | ||
| behaviorDescriptor | Describes behavior by category. | Report the Ed-Fi code value from the mapped Behavior Descriptor on the Student Discipline Incident Behavior Associations Resource Preferences for the Removal Reason:
| M | Behavior Management > Incident > Event > Participant > Resolution > Removal Reason | |
| behaviorDetailed Description
| Specifies a more granular level of detail of a behavior involved in the incident. |
| M | Behavior Management > Incident > Event > Participant > Resolution > Details > Firearms Comment | |
| disciplineIncident ParticipationCode | The role or type of participation of a student in a discipline incident. Valid values is: Perpetrator. | Report the mapped Ed-Fi Code from the Role that is selected for the Student being reported
| O | Behavior> Behavior Management> Participant details> Role | behaviorevent.role |
| seriousBodilyInjury (studentDisciplineIncident AssociationExtension) | Incident resulted in serious bodily injury. Serious Bodily Injury involves a substantial risk of death; extreme physical pain; protracted and obvious disfigurement; or protracted loss or impairment of the function of a bodily member, organ, or faculty (18 USC Section 1365 (3)(h)). |
| C | Behavior Management > Incident > Event > Participant > Injury | |
| etag | A unique system-generated value that identifies the version of the resource. | O |
