Michigan Ed-Fi Data v3.1 - Discipline Actions

Tool Search: Ed-Fi

This event entity represents actions taken by an education organization after a disruptive event that is recorded as a discipline incident.

Object Triggering Logic

This table describes logic for triggering syncing of this object.

ActionTrigger
Post

Reports when a Behavior Resolution is added to an incident that is marked as Complete and is aligned to a reported Behavior Event.

  • Behavior Resolution must have a mapped Ed-Fi Code to State Code and is not null.
  • 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.
  • The Resolution must be mapped to an Ed-Fi value.
Put

A change is found to the following fields:

  • orderOfDiscipline
Delete/Post

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

  • If the resolution date is changed do a delete and post.
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 a resolution is deleted.
DeleteWhen all resolutions are removed from the incident.
DeleteWhen all Behavior Events are removed from the Incident.
DeleteWhen the student's Role changes to a non-mapped dictionary value.
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
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 an Ed-Fi ID changes, this will happen with the cascading deletes from the Ed-Fi ID Change trigger.
  • If the Discipline Date changes.


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 Resolution TypeDiscipline Descriptor
Educational Services After Removal

Received Education Services During Expulsion.

Only show if the attribute is a droplist.  

Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus TableEd-Fi ActionFields
behaviorResolutionPost/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 RequirementBusiness RulesM, C or O

Data Source GUI Path

Database Field
idThe unique identifier of the resource.
M

disciplineActionidentifier Identifier assigned by the education organization to the discipline action.

Reports the Resolution ID.

Behavior> Behavior Management> Resolution> Resolution IDBehaviorResolution.
resolutionID
disciplineDate The month, day, and year of the discipline action.

Reports the Resolution Start Date.

MBehavior> Behavior Management> Resolution> Resolution Start DateBehaviorresolution.
timestamp
disciplines An unordered collection of discipline Action Disciplines.

See array section.

M

studentDisciplineIncident
Associations
Reference to the DisciplineIncident associated with the DisciplineAction.

See array section.

M

assignmentschool
Reference 
A reference to the related School resource.

This is optional, does not report.

O

responsibilityschool
Reference 
A reference to the related School resource.

Reports the fields that are part of the Natural Key for the Schools resource of the school where the incident occurred.

M

studentReference A reference to the related Student resource.

Report the reference from the Student record for the student associated with the Resolution.

M

actualDiscipline
ActionLength
The length of time in school days for the Discipline Action (e.g. removal, detention), if applicable.
  1. Report the value entered in the Duration in School Days field.
  2. If blank, do not report.
OBehavior> Behavior Management> Resolution>Duration in School Days behaviorResolution.
schoolDaysDuration
disciplineActionLength The length of time in school days for the Discipline Action (e.g. removal, detention), if applicable.

This is optional, does not report.

O

disciplineAction
LengthDifference
ReasonDescriptor

Indicates the reason for the difference, if any, between the official and actual lengths of a student s disciplinary assignment.

This is optional, does not report.

O

iepPlacement
MeetingIndicator
An indication as to whether an offense and/or disciplinary action resulted in a meeting of a student’s Individualized Education Program (IEP) team to determine appropriate placement.
  1. Reports True when the IEP Manifestation Determination checkbox is checked.
  2. Otherwise, report false.
O

receivedEducation
Services
DuringExpulsion
An indication of whether the student received educational services when removed from the regular school program for disciplinary reasons.
  1. Report the following:
    • Report True if checkbox is checked.
    • Report False if checkbox is not checked.
OBehavior> Behavior Management> Resolution> Follow Up
behaviorresolution.
serviceProvided
relatedToZero
TolerancePolicy 
An indication of whether or not this disciplinary action taken against a student was imposed as a consequence of state or local zero tolerance policies.

This is optional, does not report.

O

 staffs An unordered collection of disciplineActionStaffs.

See array section.

O

orderOfDisciplineOrder of the administrative decision of the referral assigned by SWIS.Report order of resolution based on the resolution Start Date. 
  1. The earliest resolution found will report 1. Second earliest will report 2. Etc.
  2. Resolution must have a State Code is not null to be considered.

OBehavior > Behavior Resolution
etagA unique system-generated value that identifies the version of the resource.
O

Arrays

Click here to expand...

Disciplines

Data Element LabelBusiness RequirementBusiness RulesM, C or O

Data Source GUI Path

Database Field
disciplineDescriptor

This descriptor defines the type of action or removal from the classroom used to discipline the student involved as a perpetrator in a discipline incident.

  1. Report the Ed-Fi Code value from the mapping for the state resolution code selected.
  2. If the Ed-Fi Code is not mapped to a state code, then do not report.
 OBehavior> Behavior Management> Resolution Details> Resolution Type


Student Discipline Incident Associations

Data Element LabelBusiness RequirementBusiness RulesM,C or OData Source GUI PathDatabase Field
Discipline Incident Reference

A reference to the related Student Discipline Incident resource.

  1. Report the reference from the Discipline Incident record to which the resolution is associated.
O


Staffs

Data Element LabelBusiness RequirementBusiness RuleM, C or OData Source GUI PathDatabase Field
Staff ReferenceA reference to the related Staff resourceReports the reference for the Staff assigned to the Behavior Admin Staff Name.
  1. If the person does not have an Ed-Fi ID, do not report.
  2. If the person does have an Ed-Fi ID, do a get on the Staff resource to verify they exist before sending.
    • If the Staff record is valid, send the Staff reference.
    • If the Staff record is not valid, this field will report blank.
OBehavior Resolution> Behavior Admin Staff Namebehaviorresolution. adminPersonId


Type/Descriptors

Click here to expand...

Discipline Descriptor

Code ValueDescriptionNamespaceShort Description
OtherOtheruri://ed-fi.org/DisciplineDescriptorOther
ExpulsionExpulsionuri://ed-fi.org/DisciplineDescriptorExpulsion
Expulsion with ServicesExpulsion with Servicesuri://ed-fi.org/DisciplineDescriptorExpulsion with Services
No action for incidentNo action for incidenturi://ed-fi.org/DisciplineDescriptorNo action for incident
In School SuspensionIn School Suspensionuri://ed-fi.org/DisciplineDescriptorIn School Suspension
Removal from ClassroomRemoval from Classroomuri://ed-fi.org/DisciplineDescriptorRemoval from Classroom
Community ServiceCommunity Serviceuri://ed-fi.org/DisciplineDescriptorCommunity Service
Out of School SuspensionOut of School Suspensionuri://ed-fi.org/DisciplineDescriptorOut of School Suspension