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 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." An incident must have at least one behavior event associated with it, and the event must be mapped to an Ed-Fi Value. Posting can occur when a new event is added after the Incident is marked as "Complete." Does not send when the student is in a calendar marked as Exclude. Does not send when the student's enrollment is in a school marked as Exclude.
Put	When data that is not part of the Natural Key is changed. When Submitted By is changed on the Incident. When a new behavior event is added, changed, or removed. When the Incident date is changed. When the Location of Incident is changed.
Delete/Post	When the Incident's status is changed. Deletes when the status is changed from Completed to In Progress. Posts when the status is changed from In Progress to Completed.
Delete	When an incident is deleted.
Delete	When the associated student enrollment is deleted.
Delete	When all Student Discipline Incident Associations are deleted that are associated with this Disciple Incident record.

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	When a resource is toggled to off after data is 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, 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: When the School Number/Ed-Fi School Number changes, a delete/post will occur with the cascading deletes from the School ID Change triggers. When an Ed-Fi ID changes, this happens with the cascading deletes from the Ed-Fi ID Change trigger.
Delete/Post	When the Incident is deleted, all dependent resources are deleted.
Dependent Resources	Student Discipline Incident Associations, Discipline Action

Action

Trigger

Post/Delete

Natural Key changes:

When the School Number/Ed-Fi School Number changes, a delete/post will occur with the cascading deletes from the School ID Change triggers. When an Ed-Fi ID changes, this happens with the cascading deletes from the Ed-Fi ID Change trigger.

Delete/Post

When the Incident is deleted, all dependent resources are deleted.

Dependent Resources

Student Discipline Incident Associations, Discipline Action

Scope Year Logic

This table describes scope year logic of this object.

Logic
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 Type	Behavior Descriptor - Only shows events that overlap the configured year with the ability to view/map inactive events. Shows both events that do not overlap and events that are archived.

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 Requirement	M, C or O	Data Source GUI Path Database Field
id	The unique identifier of the resource.	M
incidentIdentifier	A locally assigned unique identifier (within the school or school district) is used to identify each specific incident or occurrence. The same identifier should be used to document the entire incident even when it included multiple offenses and multiple offenders. Reports the Incident ID.	M	Behavior > Behavior Management > Incident ID BehaviorIncident.incidentID
schoolReference	A reference to the related School resource. Reports the schoolId. Reporting School reports from Reporting School in state reporting fields when populated. When null, looks to Calendar > Calendar Type code = AP: Alternative Program School. When code = AP, all students in the calendar report field 30, Reporting School, from Residing School in Enrollments > State Reporting fields. When the Reporting School field is blank and the Calendar Type is not AP, looks to School Org Type (Resources > School) code = AP: Alternative Program School. All students in the school report field 30, Reporting School, from Residing School in Enrollments > State Reporting fields. When the Reporting School field blank and Calendar Type not AP and School Org Type (Resources > School) is not AP: Alternative Program School, report State School Number.	M
behaviors	An unordered collection of disciplineIncidentBehaviors. Describes behavior by category and provides a detailed description. See the Arrays section below.	M
incidentDate	The month, day, and year on which the incident occurred. Only reports dates for events that have a State Code of A, D, N, O, T, V, or W. Otherwise, does not report.	M	Behavior > Behavior Management > Date of Incident BehaviorIncident.timestamp
weapons	An unordered collection of disciplineIncidentWeapons. Identifies the type of weapon used during an incident. The Federal Gun-Free Schools Act requires states to report the number of students expelled for bringing firearms to school by type of firearm. See the Arrays section below.	O

Arrays

Click here to expand...

Behaviors

Data Element Label	Description	M, C, or O	Database Location
behaviorDescriptor	The ID of the Behavior Descriptor. Reports all behavior events that are associated with the incident. Reports the Ed-Fi code value from the mapping provided for State Code selected on the event. When a code is not mapped, does not report.	M	Behavior > Behavior Management > Event Details > State Code behaviorType.code behaviorType.name

Data Element Label

Description

M, C, or O

Database Location

behaviorDescriptor

The ID of the Behavior Descriptor.

Reports all behavior events that are associated with the incident.

Reports the Ed-Fi code value from the mapping provided for State Code selected on the event.
When a code is not mapped, does not report.

Behavior > Behavior Management > Event Details > State Code

behaviorType.code

behaviorType.name

Weapons

Data Element Label	Description	M, C, or O	Database Location
weaponDescriptor	Identifies the type of weapon used during an incident. The Federal Gun-Free Schools Act requires states to report the number of students expelled for bringing firearms to school by type of firearm. When Event Type = 'W,' reports the associated Behavior Event Weapon code. When the Behavior Event Weapon code = NULL, reports as blank/ When the Offense Type is NOT W, the Weapon Type MUST be N.	M	Behavior > Behavior Management > Event Details > Behavior Event Weapon

Data Element Label

Description

M, C, or O

Database Location

weaponDescriptor

Identifies the type of weapon used during an incident. The Federal Gun-Free Schools Act requires states to report the number of students expelled for bringing firearms to school by type of firearm.

When Event Type = 'W,' reports the associated Behavior Event Weapon code.

When the Behavior Event Weapon code = NULL, reports as blank/

When the Offense Type is NOT W, the Weapon Type MUST be N.

Behavior > Behavior Management > Event Details > Behavior Event Weapon

Descriptors