Discipline Incidents (Arizona 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

This table describes logic for triggering syncing of this object.

ActionTrigger
PostReports a behavior incident when the incident's Status is marked and saved as Complete.
  • The incident must have at least one behavior event associated and the event is mapped to an Ed-Fi Value.
  • The incident must be tied to a Behavior Incident that has at least one Behavior Resolution that is mapped to an Ed-Fi Value.
  • Student must be in SPED or 21st CCLC on the date of the reported behavior event, OR the event/resolution must be related to firearms. This is identified by:
    • SPED
      • Student has a locked IEP that overlaps the dates of the reported behavior event.
      • Student has no IEPs and has a flag with a state code of '999' (IEP) that overlaps the dates of the reported behavior event.
    • 21st CCLC
      • A student has an enrollment in a school where the 21CCLC checkbox is marked on the School Resource within the scope year.
    • Firearms
      • The Behavior Event is mapped to one of the following values:
        • Handguns
        • Rifles/shotguns
        • Multiple firearms
        • Other Firearms
  • Posting can occur when a new event is added after Incident is marked as Complete.
  • Do not send when the student is in a calendar marked as Exclude.
  • Do not send when the student is in a School marked as Exclude.
  • Do not send when the student's enrollment is marked as State Exclude.
  • Do not send when the student's grade is marked as State Exclude.
  • Do not send when a student's enrollment is marked as No Show.
PutWhen 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.
Delete/PostWhen 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/PostWhen a student's SPED IEP is changed.
  • Delete when the IEP is unlocked.
  • Post when the IEP is locked.
  • Delete when IEP dates are updated to no longer overlap the behavior incident.
  • Post when IEP dates are updated to now overlap the behavior incident.
Delete/PostWhen student's flag with a state code of 999 (IEP) is changed.
  • Delete when flag dates are updated to no longer overlap the behavior incident.
  • Post when flag dates are updated to now overlap the behavior incident.
  • Delete when a flag with dates that overlaps the behavior incident is deleted.
  • Post when a flag with dates that overlaps the behavior incident has the program updated to 999 (IEP) or a new flag is added with a program state code of 999 (IEP).
Delete/PostWhen the student's 21st CCLC record is changed.
  • Delete when 21st CCLC dates are updated to no longer overlap the school year of the reported behavior event.
  • Post when 21st CCLC dates are updated to now overlap the school year of the reported behavior incident.
  • Delete when the 21st CCLC record with dates that overlap the school year of the reported behavior incident is deleted. 
DeleteWhen an incident is deleted.
DeleteWhen the associated student enrollment is deleted.
Delete When all Student Discipline Incident Associations are deleted that are associated with this Disciple Incident record.

Resource Toggle/Resync

Action

Business Rule

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

Action

Business Rule

Post/Delete

Natural Key changes: 

  • When the School Number/Ed-Fi School Number changes, a delete/post occurs 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/PostWhen the Incident is deleted all dependent resources are deleted.
  • Student Discipline Incident Associations, Discipline Action

Scope Year

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

Identity Mapping Object Key

campusObjectType

Object Key Data Source

BehaviorIncidentincidentID

Event Queue Detail

Campus Table

Ed-Fi Action

Fields

behaviorIncident

Post/Put/Delete

The primary table for sending data for this resource

behaviorEventPutReferring 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 LabelBusiness RequirementBusiness RulesM, C or O

Data Source GUI Path

Database Field
idThe 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 when it includes multiple offenses and multiple offenders.

Reports the Incident ID in the following format: <District Entity ID>-<Incident ID>

MBehavior > Behavior Management > Incident ID

System Administration > Resources > School > District Entity ID

System Administration > Resources > District Information > District Entity ID
Behavior > Behavior Management > Incident Detail Information > Incident ID

BehaviorIncident.incidentID
schoolReference A reference to the related School resource.

Reports the fields that are part of the Natural Key for the Schools resource.

M

staffReferenceA 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:
  1. Staff must have an Ed-Fi ID to send.
  2. Only send when the Staff has a Staff Education Organization Assignment Association in the Identity Mapping table.
OBehavior> Behavior Management> Submitted byBehaviorIncident.
referralPersonID
behaviorsAn unordered collection of discipline Incident Behaviors. 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.

O

caseNumberThe case number assigned to the incident by law enforcement or other organization.

This is optional, does not report.

O

incidentCostThe 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

incidentDateThe month, day, and year on which the incident occurred

Reports the Date of Incident.

MBehavior> Behavior Management> Date of Incident BehaviorIncident.timestamp
incidentDescriptionThe description for an incident.

This is optional, does not report.

NM

incidentLocation
Descriptor
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 the Ed-Fi code mapped to the selection in the Location field on the Incident.

OBehavior Management > LocationBehaviorIncident.location
incidentTimeAn indication of the time of day the incident took place.

This is optional, does not report.

O

reportedToLaw
Enforcement
Indicator of whether the incident was reported to law enforcement.

This is optional, does not report.

O

reporterDescription
Descriptor
Information on the type of individual who reported the incident. When known and/or when 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 .Reports the Ed-Fi code mapped to the Referring Party selected on the Behavior Event:
  1. When there is more than one event on the incident and there are different Referring Party codes selected, the last one to sync reports.
OBehavior> Behavior Management> Event and Participant Details> Referring PartyBehaviorEvent.reporterType
reporterNameIdentifies the reporter of the incident by name.

Reports the First and Last name of the person listed in the Submitted By field.

MBehavior > Behavior Managment > Submitted by
weaponsAn 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

etagA unique system-generated value that identifies the version of the resource.
O

Arrays

Click here to expand...

Behaviors

Data Element LabelBusiness RequirementsBusiness RulesM, C or OData Source GUI PathDatabase Field
behaviorDescriptorThe 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 event code selected on the event

When a code is not mapped, do not report.

MBehavior> Behavior Management> Event Type

BehaviorType.code

BehaviorType.name

 behaviorDetailedDescription Specifies a more granular level of detail of a behavior involved in the incidentReports the Details entered on the Incident when the option in Resource Preferences is set to Yes.
  • Ed-Fi accepts 1024 characters in this field, truncate remaining information from Campus when there are more characters.

Does not report when the Resource Preference is set to No.


When the Resource Preference option is changed, a resync needs to be done to add/remove data from this field.

OBehavior> Behavior Management> Incident Detail InformationBehaviorincident. description