Discipline Incidents (Texas v4.0)

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

Action	Trigger
Post	Reports a behavior incident when the incident's Status is marked and saved as "Complete". Incident must have at least one behavior event associated and the event is mapped to an Ed-Fi Value. Posting can occur if a new event is added after Incident is marked as "Complete". Does not send if the student is in a calendar marked as Exclude. Does not send if the student is in a School marked as Exclude.
Put	When data that is not part of the Natural Key is changed. 'Submitted By' is changed on the Incident. New behavior event is added, changed, or removed. Incident date is changed. Location of Incident is changed.
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 the associated student enrollment is deleted.
Delete	When all of the Student Discipline Incident Behavior Associations records associated with this Disciple Incident record are deleted.

School Exclude, Calendar Exclude, Resource Toggle and Resync Logic

Action	Trigger
None	If a resource is toggled to 'OFF' after data has sent, all sent data remains in the ODS but no new data sends.
Resync	If 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	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 is deleted from the ODS.
Resync	If a mapping is changed in Resource Preferences, a resync needs to be done to reflect the changes.

Natural Key Changes, Cascading Updates, and Deletes Logic

Action	Trigger
Post/Delete	Natural Key changes: If the School Number/Ed-Fi School Number changes, a delete/post occurs with the cascading deletes from the School ID Change triggers. 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 delete.
Dependent Resources	Student Discipline Incident Associations, Discipline Action

Action

Trigger

Post/Delete

Natural Key changes:

If the School Number/Ed-Fi School Number changes, a delete/post occurs with the cascading deletes from the School ID Change triggers. 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 delete.

Dependent Resources

Student Discipline Incident Associations, Discipline Action

Scope Year Logic

Logic
Discipline records only send to the school year to which they are aligned.
Data only sends for the years that have valid configuration.

Resource Preferences

Data Element Label	Mapping Needed
Behavior Incident Location of Incident	Incident Location Descriptor
Behavior Event Type	Behavior Descriptor (Information: Only show events that overlap the configured year with the ability to view/map inactive events. Show both events that do not overlap and events that are archived.)
Behavior Event Referring Party	Reporter Description Descriptor
Do you want to report the Details on the Incident to populate the Behavior Detailed Descriptor?	Behavior Detailed Description

Identity Mapping Object Key

campusObjectType	Object Key Data Source
BehaviorIncident	incidentID

Event Queue Detail

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.

Click here to expand...

Data Element Label	Business Requirement	Logic	M, C or O	Location
id	The unique identifier of the resource.		M
incidentIdentifier	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
staffReference	A reference to the related Staff resource.	Reports the Natural Key from the Staff Resource when there is a person selected in the 'Submitted By' field. Staff must have an Ed-Fi ID to send. Only sends if the Staff has a Staff Ed Org Assignment Assoc in the Identity Mapping table.	O
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.	This is optional, does not report.	O
caseNumber	The case number assigned to the incident by law enforcement or other organization.	This is optional, does not report.	O
incidentCost	The value of any quantifiable monetary loss directly resulting from the incident. Examples include the value of repairs necessitated by vandalism of a school facility, the value of personnel resources used for repairs or consumed by the incident.	This is optional, does not report.	O
incidentDate	The month, day, and year on which the incident occurred.	Reports the Date of the Incident.	M	Behavior > Behavior Management > Date of Incident Behavior Incident.timestamp
incidentDescription	The description for an incident.	This is optional, does not report.	O
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.	This is optional, does not report.	O
incidentTime	An indication of the time of day the incident took place.	This is optional, does not report.	O
reportedToLawEnforcement	Indicator of whether the incident was reported to law enforcement.	This is optional, does not report.	O
reporterDescriptionDescriptor	Information on the type of individual who reported the incident. When known and/or if useful, use a more specific option code (e.g., ""Counselor"" rather than ""Professional Staff""); for example:Student Parent/guardian Law enforcement officer Nonschool personnel Representative of visiting school.	This is optional, does not report.	O
reporterName	Identifies the reporter of the incident by name.	This is optional, does not report.	O
weapons	An unordered collection of disciplineIncidentWeapons. 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 is optional, does not report.	O
SafeSupportiveSchoolProgramTeamReview	Indicates whether the Safe and Supportive School Program (SSSP) team conducted a threat assessment related to a reported disciplinary incident.	If SSSP Team Review = selected, reports 'True'. Otherwise, does not report.	O	Behavior > Behavior Event
etag	A unique system-generated value that identifies the version of the resource.		O