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 Logic
This table describes logic for triggering syncing of this object.
| Action | Trigger |
|---|---|
| Post | Reports a record when the Behavior Incident has at least one event with a behavior that is mapped to an Ed-Fi Code AND has at least one reportable student associated to it AND is marked as 'Complete'. Do NOT report a record if any of the following exclusions are present:
Local Event Behavior Codes must be mapped to a State Event Code in Behavior > Admin > Event Types > State Event Code (Mapping). The State Event Code must be mapped to an Ed-Fi Code in Resource Preferences. |
| Delete/Post/Put | A DELETE / POST will be performed if the data element being altered is part of the resource's natural key. A PUT will be performed otherwise.
|
| Delete |
|
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 | Student Discipline Incident Associations, Discipline Action |
Scope Year Logic
This table describes scope year logic of this object.
| Logic |
|---|
| Discipline records will only send to the school year they are aligned to. |
| Data will only send for the years that have valid configuration. |
Resource Preferences
| Data Element Label | Mapping Needed |
|---|---|
| Behavior Descriptors | Behavior Event Type |
| Incident Location Descriptors | Behavior Incident Location |
| Weapon Descriptors | Behavior Weapon Weapon Type |
| Reporter Description Descriptors | Behavior Event Referring Party |
Identity Mapping Object Key
| campusObjectType | Object Key Data Source |
|---|---|
| BehaviorIncident | incidentID |
Event Queue Detail
This table describes the Event Queue Detail of this object.
| Campus Table | Ed-Fi Action | Fields |
|---|---|---|
| behaviorIncident | Post/Put/Delete | The primary table for sending data for this resource. |
| behaviorEvent | Put | Referring Party |
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 Rule and Business Requirements | M, C, or O | Data Source GUI Path | Database Field | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| incidentIdentifier | A locally assigned unique identifier (within the school or school district) to identify each specific incident or occurrence. The same identifier should be used to document the entire incident even if it included multiple offenses and multiple offenders Reports the Incident ID | M | Behavior > Behavior Management > Incident ID | Behavior Incident.incidentID | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| schoolReference | A reference to the related School resource. Reports the fields that are part of the Natural Key for the Schools resource.
| M | System Administration > Resources > School > Ed-Fi School ID | School.entityID | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| behaviors | An unordered collection of disciplineIncidentBehaviors. 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. Reports the below data elements in an array:
| M | Behavior > Behavior Management > Event Type | BehaviorType.code BehaviorType.name | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| incidentDate | The month, day, and year on which the incident occurred Reports the Date of Incident. | M | Behavior > Behavior Management > Date of Incident | Behavior Incident.timestamp | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| incidentLocationDescriptor | Identifies where the incident occurred and whether or not it occurred on campus, for example: On campus Administrative offices area Cafeteria area Classroom Hallway or stairs Reports based on the Standard Code of the value selected for Location and Context. Reference the table below to see what value will report for your given combination:
| M | Behavior Management > Location Behavior Management > Context | BehaviorIncident.location BehaviorIncident.context | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| incidentTimingDescriptor | Reports the Ed-Fi Code mapped to the value selected for Context. | M | Behavior Management > Context | BehaviorIncident.context | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
