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's Status is marked and saved as "Complete".
|
| 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. |
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 |
| Behavior Event Type | Behavior Descriptor (Info message only) |
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. |
| M | Behavior> Behavior Management> Event Type | behaviorType.code behaviorType.name |
| behaviorDetailed Description
| Specifies a more granular level of detail of a behavior involved in the incident. | This is optional, does not report. | O | ||
| disciplineIncident ParticipationCode | An unordered collection of student Discipline Incident Behavior Association Discipline Incident Participation Codes. The role or type of participation of a student in a discipline incident. | See array section below for logic. | O | ||
| etag | A unique system-generated value that identifies the version of the resource. | O |
