Michigan Ed-Fi Data v3.1 - Staff School Associations

Tool Search: Ed-Fi

This association indicates the school(s) to which a teacher provides instructional services.

Object Triggering Logic

This table describes logic for triggering syncing of this object.

ActionTrigger
Post

When a District Assignment record is created or changed and saved for a staff member.

Do not report if any of the following scenarios are true:

  • There is not an Ed-FI ID for the staff person.
  • The District Assignment records are not active based on the Scope Year logic listed below.
  • If the record is being triggered from a District Assignment record and it is marked as Exclude.

  • If the record is being triggered from a District Assignment record and the School is marked as Exclude.

  • If data is sent prior to the Exclude check boxes are checked, the data will remain and the user will need to use the Delete Tool to remove data.
Put

When any field not part of the natural key changes:

  • academicSubjects
  • gradeLevels
Delete/Post

If any part of the Natural Key changes:

  • programAssignmentDescriptor
Delete/PostIf there are two District Assignment records that create the same natural Key and 1 is Deleted, the remaining record will be posted.
DeleteWhen a District Assignment record 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 or the  Ed-Fi ID changes, a delete/post will occur with the cascading deletes from the School ID/Ed-Fi ID Change triggers.
  • programAssignmentDescriptor
DeleteCascading Deletes: N/A - there are no dependent resources.


Scope Year Logic

This table describes scope year logic of this object.

Logic

A record will report when a person has a District Assignment or District Employment record that is aligned to a scoped year.

Report when a staff has an active District Assignment or District Employment record that overlaps with the School year Start and End Dates

  • If School Year Start Date is NULL, 7/1/xxxx will be the default start date used.
  • If School Year End Date is NULL, 6/30/xxxx will be the default end date used.
Data will only send for the years that have valid configuration.


Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus TableEd-Fi ActionFields
employmentassignmentPost/Put/DeleteThe primary table used 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 Label

Business Requirement

Business Rules

M, C or O

Data Source GUI Path

Database Field

id  

The unique identifier of the resource.
M


 programAssignment
Descriptor 

The name of the program for which the individual is assigned; for example: Regular education Title I-Academic Title I-Non-Academic Special Education Bilingual/English as a Second Language.

  1. Report 'Regular Education' if the Teacher checkbox is checked.
  2. Report' Special Education' if the Special Ed checkbox is checked.
  3. Else, report 'Other'.
Census>  People > District Assignment

employmentassignment.

teacher


employmentassignment.

specialed


employmentassignment.

behavior


employmentassignment.

health


employmentassignment.

advisor


employmentassignment.

supervisor


employmentassignment.

foodservice


employmentassignment.

counselor

calendarReferenceA reference to the related Calendar Resource.
  1. This is optional, does not report.
O

schoolReferenceA reference to the related Education Organization resource.
  1. Reports the data that is part of the Natural Key for the Schools resource.


M

schoolYearType
Reference
 Identifier for a school year.
  1. Report the calendar End Year (ex: 2017).
O

staffReferenceA reference to the related Staff resource.
  1. Reports the data that is part of the Natural Key for the Staff resource.




academicSubjects

An unordered collection of staffSchoolAssociationAcademicSubjects. This association indicates the school(s) to which a teacher provides instructional services.

  1. See Array section below for logic.
O

gradeLevelsAn unordered collection of staffSchoolAssociationGradeLevels. This association indicates the school(s) to which a teacher provides instructional services.
  1. See Array section below for logic.
O

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

Arrays

Click here to expand...

Academic Subject

Data Element Label

Business Requirement

Business Rules

M, C or O

Data Source GUI Path

Database Field

academicSubjectDescriptor
Key for academicSubject.
  1. Report the Ed-Fi Code from the Primary Teaching Area field.
  2. If Ed-Fi Code is NULL or field is blank, do not report.
M Census> People> District Assignments> Primary Teaching Areaemploymentassignment. primaryTeachingArea

Grade Levels

Data Element Label

Business Requirement

Business Rules

M, C or O

Data Source GUI Path

Database Field

gradeLevelDescriptor
Key for gradeLevels.
  1. Report the Ed-Fi Code from the Grade selected.
  2. If Ed-Fi Code is NULL or field is blank, do not report.
M Census> People> District Assignments> Grade Level employmentassignment.grade