Michigan Ed-Fi Data v3.1 - Discipline Incidents

Tool Search: 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.

ActionTrigger
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 and a Role that is mapped to an Ed-Fi 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.
Put

When a change is found to the following fields:

  • behaviors
  • seriousBodilyInjury
  • sexualAssault
Delete/Post

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

  • If the Event Type is changed and saved.
  • If the Date of Incident 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.
DeleteWhen an incident is deleted.
DeleteWhen the associated student enrollment is 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
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, and Deletes Logic

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

ActionTrigger
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.
Dependent ResourcesStudent Discipline Incident Associations, Discipline Action


Scope Year Logic

This table describes scope year logic of this object.

Logic

Discipline records will only send to the school year they are aligned to.

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


Resource Preferences

Data Element Label

Mapping Needed

Behavior Incident Location of IncidentIncident Location Descriptor
Behavior Event TypeBehavior Descriptor (Info message only) - 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 PartyReporter Description Descriptor

Identity Mapping Object Key

campusObjectType

Object Key Data Source

BehaviorIncidentincidentID

Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus TableEd-Fi ActionFields
behaviorIncidentPost/Put/DeleteThe 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.This field is optional, does not report.O

behaviorsAn 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.

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.

O  
incidentLocationDescriptorIdentifies 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  
reportedToLawEnforcementIndicator of whether the incident was reported to law enforcement.

This is optional, does not report.

O  
reporterDescriptionDescriptorInformation 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 field is optional, does not report.O

reporterNameIdentifies the reporter of the incident by name.
  1. This field is optional, does not report.
O

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  
seriousBodilyInjuryIndicate if when the Incident Type involved physical violence with injury and the injury inflicted meets the definition of Serious Bodily Injury per the United States Code paragragh (3) of subsection (h) of section 1365 of title 18: "(3) the term serious bodily injury means bodily injury which involves (A) a substantial risk of death; (B) extreme physical pain; (C) protracted and obvious disfigurement; or (D) protracted loss or impairment of the function of a bodily member, organ, or mental faculty;" 0=No, 1=Yes.

If Injury = 4: Serious Bodily Injury, report true.

  1. Else do not report this field. 
  2. This field is only reported if Event Name = 60 or 61.


Behavior > Event > Injury
sexualAssaultIndicate if an incident of the Incident Type involved physical violence involved oral, anal, or vaginal penetration forcibly or against the person's will or where the victim is incapable of giving consent. Includes rape, fondling, indecent liberties, child molestation, and sodomy. 0=No, 1=Yes.If Sexual Assault = selected, report true. 
  1. Else do not report this field. 
  2. This field is only reported if Behavior Descriptor = 60 or 61.


Behavior > Event > Sexual Assault
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.
    1. Report the Ed-Fi code value from the state code on the event.
    2. Only unique Ed-Fi Codes report. If more than one event is mapped to the same Ed-Fi Code on an incident, report only one of them (lowest eventID).
MBehavior > Behavior Management > Event Type

behaviorType.code

behaviorType.name

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

Use core logic.

OBehavior > Behavior Management > Incident Detail Informationbehaviorincident. description
disciplineIncidentBehaviorSubTypeDescriptor

(MI EXT) Discipline Incident Behavior SubTypes.

Does not report


O

orderOfBehavior

(MI) Order of the behavior of the referral.

Reports the order of events in the incident based on event record ID. The earliest ID reports 1.

M


Type/Descriptors

Click here to expand...

Incident Location Descriptor

Code ValueDescriptionNamespaceShort Description
Administrative offices areaAdministrative offices areauri://ed-fi.org/IncidentLocationDescriptorAdministrative offices area
Athletic field or playgroundAthletic field or playgrounduri://ed-fi.org/IncidentLocationDescriptorAthletic field or playground
AuditoriumAuditoriumuri://ed-fi.org/IncidentLocationDescriptorAuditorium
Bus stopBus stopuri://ed-fi.org/IncidentLocationDescriptorBus stop
Cafeteria areaCafeteria areauri://ed-fi.org/IncidentLocationDescriptorCafeteria area
ClassroomClassroomuri://ed-fi.org/IncidentLocationDescriptorClassroom
Computer labComputer laburi://ed-fi.org/IncidentLocationDescriptorComputer lab
Hallway or stairsHallway or stairsuri://ed-fi.org/IncidentLocationDescriptorHallway or stairs
Library/media centerLibrary/media centeruri://ed-fi.org/IncidentLocationDescriptorLibrary/media center
Locker room or gym areasLocker room or gym areasuri://ed-fi.org/IncidentLocationDescriptorLocker room or gym areas
Off campusOff campusuri://ed-fi.org/IncidentLocationDescriptorOff campus
Off-campus at a school sponsored activityOff-campus at a school sponsored activityuri://ed-fi.org/IncidentLocationDescriptorOff-campus at a school sponsored activity
Off-campus at another location unrelated to schoolOff-campus at another location unrelated to schooluri://ed-fi.org/IncidentLocationDescriptorOff-campus at another location unrelated to school
Off-campus at other schoolOff-campus at other schooluri://ed-fi.org/IncidentLocationDescriptorOff-campus at other school
Off-campus at other school district facilityOff-campus at other school district facilityuri://ed-fi.org/IncidentLocationDescriptorOff-campus at other school district facility
On campusOn campusuri://ed-fi.org/IncidentLocationDescriptorOn campus
On-campus other inside areaOn-campus other inside areauri://ed-fi.org/IncidentLocationDescriptorOn-campus other inside area
On-campus other outside areaOn-campus other outside areauri://ed-fi.org/IncidentLocationDescriptorOn-campus other outside area
OnlineOnlineuri://ed-fi.org/IncidentLocationDescriptorOnline
Parking lotParking loturi://ed-fi.org/IncidentLocationDescriptorParking lot
RestroomRestroomuri://ed-fi.org/IncidentLocationDescriptorRestroom
School busSchool busuri://ed-fi.org/IncidentLocationDescriptorSchool bus
UnknownUnknownuri://ed-fi.org/IncidentLocationDescriptorUnknown
StadiumStadiumuri://ed-fi.org/IncidentLocationDescriptorStadium
Walking to or from schoolWalking to or from schooluri://ed-fi.org/IncidentLocationDescriptorWalking to or from school

 Behavior descriptors

Code ValueDescriptionNamespaceShort Description
OtherOtheruri://ed-fi.org/BehaviorDescriptorOther
School Code of ConductSchool Code of Conducturi://ed-fi.org/BehaviorDescriptorSchool Code of Conduct
School ViolationSchool Violationuri://ed-fi.org/BehaviorDescriptorSchool Violation
State OffenseState Offenseuri://ed-fi.org/BehaviorDescriptorState Offense

 Reporter Description Descriptors

Code ValueDescriptionNamespaceShort Description
Law enforcement officerLaw enforcement officeruri://ed-fi.org/ReporterDescriptionDescriptorLaw enforcement officer
Non-school personnelNon-school personneluri://ed-fi.org/ReporterDescriptionDescriptorNon-school personnel
OtherOtheruri://ed-fi.org/ReporterDescriptionDescriptorOther
Parent/guardianParent/guardianuri://ed-fi.org/ReporterDescriptionDescriptorParent/guardian
StaffStaffuri://ed-fi.org/ReporterDescriptionDescriptorStaff
StudentStudenturi://ed-fi.org/ReporterDescriptionDescriptorStudent