Skip to end of metadata
Go to start of metadata


This interchange defines staff information. It can be used to define employment, assignment, and teaching associations, as well as staff positions and staff leave events.

Like all standard Ed-Fi interchanges, this schema references the Ed-Fi Core XSD and can be extended using the Ed-Fi Extensions Framework. See the Ed-Fi Data Standard: Developers' Guide for more information.

Use Cases

The Staff Association Interchange can be used to:

  1. Exchange staff demographics and contact information.

  2. Exchange staff experience and credential information.

  3. Exchange staff employment and assignment associations to education organizations.

  4. Exchange teacher assignments to sections.

  5. Exchange staff leave events.

  6. Exchange current or historical information on filling open staff positions.

Model Details

The following figure shows a logical view of the Staff Association Interchange schema:



The following table describes the primary entities of which the Staff Association Interchange is composed. 


This entity represents an individual who performs specified activities for any public or private education institution or agency that provides instructional and/or support services to students or staff at the early childhood level through high school completion. For example, this includes:

  • An "employee" who performs services under the direction of the employing institution or agency is compensated for such services by the employer and is eligible for employee benefits and wage or salary tax withholdings.
  • A "contractor" or "consultant" who performs services for an agreed upon fee or an employee of a management service contracted to work on site.
  • A "volunteer" who performs services on a voluntary and uncompensated basis.
  • An in-kind service provider.
  • An independent contractor or businessperson working at a school site.
StaffEducationOrganizationEmploymentAssociationThis association indicates the EducationOrganization an employee, contractor, volunteer, or other service provider is formally associated with typically indicated by which organization the staff member has a services contract with or receives compensation from.
StaffEducationOrganizationAssignmentAssociationThis association indicates the education organization to which a staff member provides services; also known as school of service.
StaffSchoolAssociationThis association indicates the School(s) to which a staff member provides instructional services.
StaffSectionAssociationThis association indicates the class sections to which a staff member is assigned.
LeaveEventThis event entity represents the recording of the dates of staff leave (e.g., sick leave, personal time, vacation).
OpenStaffPositionThis entity represents an open staff position that the education organization is seeking to fill.
StaffProgramAssociationThis association indicates the Staff associated with a program.

Extended References

This interchange includes the following Extended References. 

Extended Reference NameDescription

Required. Pertains to the following:

  • The EducationOrganization with the OpenStaffPosition.
  • The EducationOrganization to which the Staff member provides services.
  • The EducationOrganization with which the staff is employed.
ProgramReferenceRequired. The Program associated to the Staff.
SchoolReferenceRequired.The School where the Staff member provides services.
SectionReferenceOptional. The Section the Staff member is assigned to.

Descriptor Dependencies

This interchange references the following Ed-Fi Descriptors, thus requiring them to have been defined using the Descriptors interchange prior to this interchange. For more information on the Ed-Fi Descriptor Pattern, see the Ed-Fi Data Standard - Developers' Guide.

Descriptor NameDescription
AcademicSubjectDescriptorRequired. The teaching field taught by an individual, for example English/Language Arts, Reading, Mathematics, Science, Social Sciences, etc. This mapping of descriptor values to known Ed-Fi enumeration values is required. (Optional for OpenStaffPosition.)
ClassroomPositionDescriptorRequired. The type of position the Staff member holds in the specific class/section; for example: Teacher of Record, Assistant Teacher, Support Teacher, Substitute Teacher
CountryDescriptorOptional. Country of origin of the citizenship document.

Optional. The field of certification for the certificate (e.g., Mathematics, Music).

GradeLevelDescriptorOptional. The set of grade levels for which the assignment is responsible. This mapping of descriptor values to known Ed-Fi enumeration values is required.
EducationOrganizationIdentificationSystemDescriptorOptional. This descriptor identifies the school system, state, or agency assigning the identification code.

Required. Reflects the type of employment or contract; for example: Probationary, Contractual, Substitute/temporary, Tenured or permanent, Volunteer/no contract

LanguageDescriptorOptional. The language(s) the individual uses to communicate.
LevelDescriptorOptional. The grade level(s) certified for teaching.
LevelOfEducationDescriptorOptional. The extent of formal instruction an individual has received (e.g., the highest grade in school completed or its equivalent or the highest degree received).

Required. 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. (Optional for OpenStaffPosition.)

SeparationReasonDescriptorOptional. Reason for terminating the employment; for example: Employment in education, Employment outside of education, Retirement, Family/personal relocation, Change of assignment.
StaffClassificationDescriptorRequired. The titles of employment, official status, or rank of education staff.
StaffIdentificationSystemDescriptorOptional. A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a staff member.
TeachingCredentialDescriptorOptional. An indication of the category of a legal document giving authorization to perform teaching assignment services.

The following link is a ZIP archive containing the XSD for the Staff Association Interchange v2.0 along with the Ed-Fi Core XSD and a Sample XML Data File:

A ZIP archive containing all v2.0 Ed-Fi Standard Interchange Schema can be found in the Download Directory.


  • No labels