Arizona Ed-Fi Data v3.5 - Discipline Incidents

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

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 on the date of the reported behavior event that is identified by:
    1. Student has a locked IEP that overlaps the dates of the reported behavior event.
    2. Student has no IEPs and has a flag with a state code of '999' (IEP) that overlaps the dates of the reported behavior event.
  • Posting can occur if a new event is added after Incident is marked as "Complete".
  • Do not send if the student is in a calendar marked as Exclude.
  • Do not send if the student is in a School marked as  Exclude.
  • Do not send if the student's enrollment is marked as State Exclude.
  • Do not send if the student's grade is marked as State Exclude.
  • Do not send if 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 if IEP dates are updated to no longer overlap the behavior incident.
  • Post if 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 if flag dates are updated to no longer overlap the behavior incident.
  • Post if 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).
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

NoneIf a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
ResyncIf 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
ResyncIf 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.
ResyncIf a mapping is changed in Resource Preferences, a resync will need to be done to reflect the changes.

Natural Key Changes/Cascading Updates, Deletes

Action

Business Rule

Post/Delete

Natural Key changes: 

  • If the School Number/Ed-Fi School Number changes, a delete/post will occur 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/PostIf the Incident is deleted all dependent resources will delete.
  • Student Discipline Incident Associations, Discipline Action

Scope Year

Business Rules
Discipline records will only send to the school year they are aligned to
Data will only send 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 if it included multiple offenses and multiple offenders.

Reports the Incident ID.

MBehavior> Behavior Management> Incident IDBehavior 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

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 if 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 Behavior Incident.
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 .

Report 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 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 .Report the Ed-Fi code mapped to the Referring Party selected on the Behavior Event:
  1. If 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.

Report 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.
  1. Report all behavior events that are associated with the incident
    • Report the Ed-Fi code value from the mapping provided for event code selected on the event
  2. If 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 incident
  1. Report 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 if there are more characters
  2. Do not report if the Resource Preference is set to No
  3. If 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