Student Discipline Incident Behavior Associations (Nebraska v3.6)

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.

ActionTrigger
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 a Role that is mapped to an Ed-Fi Value.
  • Posting can occur when a new event is added after 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.
  • Does not send when the student's enrollment is in a calendar marked as Summer School.
Put

When data that is not part of the Natural Key is changed.

  • When the student's role 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.
DeleteWhen an event is deleted.
DeleteWhen 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.

ActionTrigger
NoneWhen a resource is toggled to OFF after data has sent, all sent data remains in the ODS but no new data sends.
ResyncWhen 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.
ResyncWhen 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.
ResyncWhen 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

This table describes the Natural Key Changes/Cascading Updates and Deletes logic of this object.

ActionTrigger
Post/Delete

Natural Key changes:

  • When an Ed-Fi ID changes, this happens with the cascading deletes from the Ed-Fi ID Change trigger.
Delete/PostWhen the Incident is deleted all dependent resources are deleted.
Dependent ResourcesDiscipline Actions

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 only send to the school year that the incident date is aligned to.

  • Data will only send for the years that have valid configuration.

Resource Preferences

Data Element Label

Mapping Needed

Behavior Event RoleStudent Participation Code Descriptor
Behavior Event TypeBehavior Descriptor (Info message only)

Identity Mapping Object Key

Campus Object Type

Object Key Data Source

BehaviorRoleincidentID-eventID-personID

Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus TableEd-Fi ActionFields
behaviorEventPost/Put/DeleteThe 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 LabelBusiness RequirementM, C or O

Data Source GUI Path

Database Field

idThe unique identifier of the resource.M
disciplineIncidentReference A reference to the related Discipline Incident resource.

Reports the fields that are part of the Natural Key for the Discipline Incident resource.
M
studentReferenceA reference to the related Student resource.

Reports the data that is part of the Natural Key for the Student resource.
M
behaviorDescriptorThis descriptor holds the categories of behavior describing a discipline incident.

Reports the Ed-Fi code value from the mapped Behavior Event Type on the Discipline Incident resource preference. When a Behavior Event is not mapped, this does not report.

See the Arrays section below.

MBehavior > Behavior Management > Event Type

behaviorType.code

behaviorType.name

behaviorDetailedDescription
Specifies a more granular level of detail of a behavior involved in the incident.O
disciplineIncidentParticipationCodeAn 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.

Reports the Ed-Fi code value from the mapped Role selected on the Student Discipline Incident Behavior Association resource preferences for the reported student. When a Role is not mapped, this does not report.
OBehavior Management > Participant Details > Role

behaviorEvent.role
etagA unique system-generated value that identifies the version of the resource.O
weaponsAn unordered collection of disciplineIncidentWeapon.

See the Arrays section below.

See the Weapons Descriptor under the Types/Descriptors section below for a list of values.
CBehavior Management > Behavior Event > Weapons
gunFreeSchoolViolationReports as False unless weapons was reported as 02 Handgun, 05 Other Firearm, or 08 Rifle/Shotgun AND incident is considered a Gun Free School Violation.

Reports as 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.


Otherwise, Reports as False.

C

Behavior Management > Behavior Event > Weapons

+

Behavior Management > Behavior Resolution > State Resolution Code


schoolRelatedArrestIndicatorIndicates student was involved in a disciplinary incident that resulted in an arrest.

Reports as True when the checkbox is checked. Reports as False when the checkbox is not checked.

MBehavior Management > Behavior Resolution > Serious Bodily Injury
referralToLawEnforcementIndicates the incident was referred to law enforcement.MBehavior Management > Behavior Resolution > lawEnforcement
seriousBodilyInjuryIndicates an event caused serious bodily injury.

Reports as T when Serious Bodily Injury is selected on the event for participants marked as Offender only.


Reports as F when Serious Bodily Injury is not selected.


Behavior Management > Behavior Resolution > Serious Bodily Injury

Arrays

Click here to expand...

Data Element LabelBusiness RequirementsM, C or O

Data Source GUI Path

Database Field

disciplineIncidentParticipationCodeDescriptor

This descriptor holds the role or type of participation of a student in a discipline incident.


Report the mapped Ed-Fi Code from the Role that is selected for the Student being reported.


When the role is not mapped, does not report.

MBehavior > Behavior Management > Participant details > Role

behaviorevent.role
BehaviorDescriptor

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.

MBehavior > Behavior Management > Event Type

behaviorType.code

behaviorType.name


weaponDescriptorThis 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

Types/Descriptors

Click here to expand...

Behavior Descriptors

Ed-Fi Code ValueEd-Fi Short DescriptionEd-Fi Description
101Drugs, excluding TobaccoDrugs, excluding Tobacco
102Physical AttackPhysical Attack
103Threat of Physical AttackThreat of Physical Attack
104Weapons PossessionWeapons Possession
105Harassment or Bullying - SexHarassment or Bullying - Sex
106Harassment or Bullying - Race, Color, National OriginHarassment or Bullying - Race, Color, National Origin
107Harassment or Bullying - DisabilityHarassment or Bullying - Disability
108Harassment or Bullying - Sexual OrientationHarassment or Bullying - Sexual Orientation
109Harassment or Bullying - ReligionHarassment or Bullying - Religion
110RobberyRobbery
111Rape or Attempted RapeRape or Attempted Rape
112Sexual Assault, other than RapeSexual Assault, other than Rape
113OtherOther
114Property DamageProperty Damage
115TheftTheft
116AlcoholAlcohol
117Public IndecencyPublic Indecency
118Public IndecencyPublic Indecency

Discipline Incident Participation Code Descriptors

Ed-Fi Code ValueEd-Fi Short DescriptionEd-Fi Description

Victim

Victim

Victim

PerpetratorPerpetratorPerpetrator
ReporterReporterReporter
WitnessWitnessWitness

Weapon Descriptors

Ed-Fi Code ValueEd-Fi Short DescriptionEd-Fi Description

02

Handgun

Handgun

03KnifeKnife
04OtherOther
05Other FirearmOther Firearm
08Rifle/ShotgunRifle/Shotgun
10UnknownUnknown
11Pocketknife with blade of less than 2 1/2 inchesPocketknife with blade of less than 2 1/2 inches
12Explosive DeviceExplosive Device