Classic View: System Administration > Ed-Fi

Search Terms: 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". Incident must have at least 1 behavior event associated that is mapped to a State Event code and Role with an Ed-Fi Code value. Posting can occur if a new event is added after Incident is marked as "Complete". Do not send if the student's enrollment is marked as No Show or State Exclude. Do not send if the student is in a calendar marked as Exclude. Do not send if the student's enrollment is in a school marked as Exclude. Do not send if the student's enrollment is in a calendar marked as Summer School.
Delete/Post	When data that is not part of the Natural Key is changed. If the Date of Incident is changed and saved. If the Event Type is changed and saved.
Delete/Post	When the Incident's status is changed. Delete when the status is changed from Completed to In Progress. Post when the status is changed from In Progress to Completed.
Delete	When an incident is deleted.
Delete	When all Events AND Resolutions that are mapped to a state code are removed from the incident either via the UI or the Delete tool.
Delete	When the behavior event State Mapped code is changed to NULL or Not State Reported and there are no other state mapped codes on incident for that student.
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: If an Ed-Fi ID changes, this will happen with the cascading deletes from the Ed-Fi ID Change trigger.
Delete/Post	If the Incident is deleted all dependent resources will delete.
Dependent Resources	Discipline Action

Action

Trigger

Post/Delete

Natural Key changes:

If an Ed-Fi ID changes, this will happen with the cascading deletes from the Ed-Fi ID Change trigger.

Delete/Post

If the Incident is deleted all dependent resources will delete.

Dependent Resources

Discipline Action

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 based on the School Year Start and End dates. If School Year Start Date is NULL, 7/1/xxxx will be the default start date used. If School Year End Date is NULL, 6/30/xxxx will be the default end date used. Data will only send for the years that have valid configuration.

Logic

Discipline records will only send to the school year that the incident date is aligned to based on the School Year Start and End dates.

If School Year Start Date is NULL, 7/1/xxxx will be the default start date used.
If School Year End Date is NULL, 6/30/xxxx will be the default end date used.
Data will only send for the years that have valid configuration.

Resource Preferences

Data Element Label	Mapping Needed
Behavior Event Role	Student Participation Code Descriptor
Behavior Event Type	Behavior Descriptor (Info message only)
Behavior Weapon	Weapon Descriptor

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
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.	See array section below for logic.	O
student Participation Code Descriptor	The role or type of participation of a student in a discipline incident; for example: Victim Perpetrator Witness Reporter.	Report the mapped Ed-Fi Code from the Role that is selected for the Student being reported. If the student has more than 1 role with different Ed-Fi Code values, the last one to sync wins. If the role is not mapped, do not report. For particpants marked as Victims, only report the victim descriptor and demographics data.	M	Behavior > Behavior Management > Participant details > Role	behaviorevent.role
weapons	An unordered collection of disciplineIncidentWeapons.	See array logic below for weapons logic. See Weapons Descriptors linked under the Types/Descriptors section below for a list of valid values.	C	Behavior Management> Behavior Event> Weapons
Gun Free School Violation	Should be False unless Weapons was reported as 02 Handgun, 05 Other Firearm, or 08 Rifle/Shotgun AND incident is considered a Gun Free School Violation.	Report 'True' when student is associated with a Weapon Code that is in 02, 05 or 08 AND has a Resolution with a State Code in 03, 04 or 05. Else, Report 'False'.	C	Behavior Management> Behavior Event> Weapons + Behavior Management> Behavior Resolution> State Resolution Code
School Related Arrest	Indicates if student was involved in a disciplinary incident that resulted in an arrest.	Report True if the checkbox is checked. report False if the checkbox is not checked.	M	Behavior Management> Behavior Resolution> Serious Bodily Injury
Referral To Law Enforcement	Indicates if the incident was referred to law enforcement.		M	Behavior Management> Behavior Resolution> lawEnforcement
seriousBodilyInjury	Indicates whether an event caused serious bodily injury.	Report 'T' if 'Serious Bodily Injury' is selected on the event for participants marked as 'Offender' only. Report 'F' if serious bodily injury is not not selected.		BehaviorManagement> Behavior Event> Injury
etag	A unique system-generated value that identifies the version of the resource.		O

Arrays

Data Element Label	Business Requirement	Business Rules	M, C or O	Data Source GUI Path	Database Field
Behavior Descriptor	This descriptor holds the categories of behavior describing a discipline incident.	Only report behaviors the student being reported is associated with. Report the Ed-Fi code value from the mapped Behavior Event on the Discipline Incident Resource Preferences. If the Behavior Event is not mapped, do not report. If the Behavior Event Type is Harassment, report the value from the Harassment Type field on the Behavior Event.	O	Behavior> Behavior Management> Event Type	behaviorType.code behaviorType.name
Detailed Description	Specifies a more granular level of detail of a behavior involved in the incident.	This is optional, does not report.	O
WeaponDescriptor	This descriptor defines the types of weapon used during an incident.	When reporting from the Weapons field on the Participant(s) Details, report the Ed-Fi code value for each weapon that is aligned to the student. If Ed-Fi Code value is NULL, do not report.	O	Behavior> Behavior Management> Event Details> Weapon or Behavior> Behavior Management> Participant(s) Details> Weapon	behaviorevent.weaponCode

Data Element Label

Business Requirement

Business Rules

M, C or O

Data Source GUI Path

Database Field

Behavior Descriptor

This descriptor holds the categories of behavior describing a discipline incident.

Only report behaviors the student being reported is associated with.
Report the Ed-Fi code value from the mapped Behavior Event on the Discipline Incident Resource Preferences.
- If the Behavior Event is not mapped, do not report.
If the Behavior Event Type is Harassment, report the value from the Harassment Type field on the Behavior Event.

Behavior> Behavior Management> Event Type

behaviorType.code

behaviorType.name

Detailed Description

Specifies a more granular level of detail of a behavior involved in the incident.

This is optional, does not report.

WeaponDescriptor

This descriptor defines the types of weapon used during an incident.

When reporting from the Weapons field on the Participant(s) Details, report the Ed-Fi code value for each weapon that is aligned to the student.

If Ed-Fi Code value is NULL, do not report.

Behavior> Behavior Management> Event Details> Weapon

Behavior> Behavior Management> Participant(s) Details> Weapon

behaviorevent.weaponCode

Type/Descriptors

Behavior Descriptors

Code Value	Short Description	Namespace	Description
114	Property Damage	uri://ed-fi.org/BehaviorDescriptor	Willfully causing or attempting to cause substantial damage to property.
115	Theft	uri://ed-fi.org/BehaviorDescriptor	Stealing or attempting to steal property of substantial value.
116	Alcohol	uri://ed-fi.org/BehaviorDescriptor	Engaging in the unlawful possession, selling, dispensing, or use of an alcoholic liquor as defined in Nebraska Statute 53-103.02; or being under the influence of alcoholic liquor.
117	Public Indecency	uri://ed-fi.org/BehaviorDescriptor	Public indecency as defined in Nebraska Statute 28-806, except that this shall apply only to students at least twelve years of age.
118	Harassment or Bullying – Other	uri://ed-fi.org/BehaviorDescriptor	Harassment or bullying here refers to intimidation or abusive behavior toward a student on a basis that is not those described in other Behavior Descriptors (105, 106, 107, 108, 109). Harassing conduct may take many forms, including verbal acts and name calling, as well as non-verbal behavior, such as graphic and written statements, or conduct that is physically threatening, harmful or humiliating. The conduct can be carried out by school employees, other students, and non-employee third parties.

Student Participation Code Types:

Ed-Fi Short Description	Ed-Fi Description
Victim	Victim
Perpetrator	Perpetrator
Witness	Witness
Reporter	Reporter

Behavior Types:

Code Value	Ed-Fi Short Description	Description
51	Illicit Drug Related	Illicit Drug Related
52	Tobacco Related	Tobacco Related
53	Alcohol Related	Alcohol Related
54	Weapons Possession	Weapons Possession
55	Violent with Serious Bodily Injury	Violent with Serious Bodily Injury
56	Violent With Physical Injury, but not Serious Bodily Injury	Violent With Physical Injury, but not Serious Bodily Injury
57	Violent Without Physical Injury	Violent Without Physical Injury
58	Other	Other
59	Violence, other than harassment or bullying	Violence, other than harassment or bullying
61	School Violation, Not State Reportable	School Violation, Not State Reportable
62	School Code of Conduct, Not State Reportable	School Code of Conduct, Not State Reportable
63	Other Violation, Not State Reportable	Other Violation, Not State Reportable

Weapon Descriptor Types:

Ed-Fi Code Value	Ed-Fi Short Description	Ed-Fi Description
01	Club	Club
02	Handgun	Handgun
03	Knife (except pocketknife with blade of less than 2 ½ inches)	Knife (except pocketknife with blade of less than 2 ½ inches)
04	Other	Other
05	Other Firearm	Other Firearm
06	Other Object	Other Object
07	Other Sharp Objects	Other Sharp Objects
08	Rifle/Shotgun	Rifle/Shotgun
09	Substance Used as Weapon	Substance Used as Weapon
10	Unknown	Unknown
11	Pocketknife with blade of less than 2 ½ inches	Pocketknife with blade of less than 2 ½ inches
12	Explosive Device	Explosive Device

Previous Versions

Nebraska Ed-Fi Data v3.5 - Student Discipline Incidents Associations [.2136 - .2227]

Nebraska Ed-Fi Data v3.5 - Student Discipline Incidents Associations