Descriptors Interchange - v2.1

Descriptors Interchange - v2.1

Descriptors provide states, districts, vendors, and other users of the Ed-Fi solution with the flexibility to use their own enumerations and code sets without modifying the Ed-Fi core schema.

The Descriptor interchange is used to describe metadata about the descriptors and their structure. It is used to define enumeration vocabularies that are not "fixed" within the XML schema, but are loaded in XML files and linked to their source.

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 XML Design & Implementation Guidelines for more information.

Use Cases

The Descriptors Interchange can be used to:

  1. Exchange state, district, or vendor code sets in a way that Ed-Fi technology implementations can understand the semantics

  2. Exchange code or enumeration values that change over time, but where longitudinal analysis is still important

Model Details

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

Entities

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

Name

Description

Name

Description

AbsenceEventCategoryDescriptor

This descriptor describes the type of absence

AcademicSubjectDescriptor

This descriptor holds the description of the content or subject area (e.g., arts, mathematics, reading, stenography, or a foreign language).

AccommodationDescriptor

This descriptor defines variations used in how an assessment is presented or taken.

AccountCodeDescriptor

This descriptor holds the set of account codes defined for the education accounting system organized by account code type (e.g., fund, function, object).

AchievementCategoryDescriptor

This descriptor defines the category of achievement attributed to the learner.

AdministrativeFundingControlDescriptor

This descriptor holds the type of education institution as classified by its funding source (e.g., public or private).

AssessmentCategoryDescriptor

This descriptor holds the category of an assessment based on format and content.

AssessmentIdentificationSystemDescriptor

This descriptor holds a coding scheme that is used for identification and record-keeping purposes by schools, social services or other agencies to refer to an assessment.

AssessmentPeriodDescriptor

This descriptor holds the period of time window in which an assessment is supposed to be administered (e.g., Beginning of Year, Middle of Year, End of Year).

AssessmentReportingMethodDescriptor

This descriptor defines the method that the instructor of the class uses to report the performance and achievement of all students. It may be a qualitative method such as individualized teacher comments or a quantitative method such as a letter or a numerical grade.

AttendanceEventCategoryDescriptor

This descriptor holds the category of the attendance event (e.g., tardy). The map to known enumeration values is required.

BehaviorDescriptor

This descriptor holds the categories of behavior describing a discipline incident.

CalendarEventDescriptor

This descriptor holds the types of scheduled or unscheduled event for the day (e.g., Instructional day, Teacher only day, Holiday, Make-up day, Weather day, Student late arrival/early dismissal day).

CalendarTypeDescriptor

This descriptor defines the calendar types.

ClassroomPositionDescriptor

This descriptor defines the type of position the staff member holds in a specific class/section.

CompetencyLevelDescriptor

This descriptor defines various levels for assessed competencies.

ContactTypeDescriptor

This descriptor defines the set of contact types.

ContinuationOfServicesReasonDescriptor

In the Migrant Education program, a provision allows continuation of services after a child is no longer considered migratory for certain reasons. This descriptor holds the reasons prescribed in the statute. The mapping of descriptor values to known Ed-Fi enumeration values is required.

CountryDescriptor

This descriptor defines the name and code of the country. It is strongly recommended that entries use only ISO 3166 2-letter country codes.

CourseIdentificationSystemDescriptor

This descriptor defines a standard code that identifies the organization of subject matter and related learning experiences provided for the instruction of students.

CredentialFieldDescriptor

This descriptor defines the fields of certification that the state education agency offers to teachers.

DiagnosisDescriptor

This descriptor defines diagnoses that interventions are intended to target.

DisabilityDescriptor

This descriptor defines a student's impairment.

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.

EducationOrganizationIdentificationSystemDescriptor

This descriptor defines the originating record system and code that is used for record-keeping purposes by education organizations.

EmploymentStatusDescriptor

This descriptor defines the type of employment or contract.

EntryTypeDescriptor

This descriptor defines the process by which a student enters a school during a given academic session.

ExitWithdrawTypeDescriptor

This descriptor defines the circumstances under which the student exited from membership in an educational institution.

GradeLevelDescriptor

This descriptor defines the set of grade levels. The map to known Ed-Fi enumeration values is required.

GradingPeriodDescriptor

This descriptor defines the name of the period for which grades are reported. The mapping of descriptor values to known Ed-Fi enumeration values is required.

GraduationPlanTypeDescriptor

This descriptor defines the set of graduation plan types.

LanguageDescriptor

This descriptor defines the language(s) that are spoken or written. It is strongly recommended that entries use only ISO 639-3 language codes: for CodeValue, use the 3 character code; for ShortDescription and Description use the full language name.

LevelOfEducationDescriptor

This descriptor defines the different levels of education achievable.

LicenseStatusDescriptor

This descriptor defines the license statuses.

LicenseTypeDescriptor

This descriptor defines the type of a license.

LimitedEnglishProficiencyDescriptor

This descriptor defines the indications that the student has been identified as limited English proficient by the Language Proficiency Assessment Committee (LPAC), or English proficient. The mapping of descriptor values to known Ed-Fi enumeration values is required.

PerformanceLevelDescriptor

This descriptor defines various levels or thresholds for performance on the assessment.

ProgramAssignmentDescriptor

This descriptor defines the name of the education program for which a teacher is assigned to a school.

ProgramCharacteristicDescriptor

This descriptor defines important characteristics of the Program, such as categories or particular indications.

ProviderCategoryDescriptor

This descriptor holds the category of the provider.

ProviderProfitabilityDescriptor

This descriptor indicates the profitability status of the provider.

ProviderStatusDescriptor

This descriptor defines the status of the provider.

ReasonExitedDescriptor

This descriptor defines the reason a student exited a program.

ReporterDescriptionDescriptor

This descriptor defines the type of individual who reported an incident.

ResidencyStatusDescriptor

This descriptor defines indications of the location of a person's legal residence relative to (within or outside of) the boundaries of the public school attended and its administrative unit.

ResponsibilityDescriptor

This descriptor defines types of responsibility an education organization may have for a student (e.g., accountability, attendance, funding).

SchoolFoodServicesEligibilityDescriptor

This descriptor defines indications of a student's level of eligibility for breakfast, lunch, snack, supper, and milk programs.

SectionCharacteristicDescriptor

This descriptor defines characteristics of a Section, such as whether attendance is taken and the Section is graded.

SeparationReasonDescriptor

This descriptor defines the reasons for terminating the employment.

ServiceDescriptor

This descriptor defines the services provided by an education organization to populations of students associated with a program.

SpecialEducationSettingDescriptor

This descriptor defines the major instructional setting (more than 50 percent of a student's special education program).

StaffClassificationDescriptor

This descriptor defines an individual's title of employment, official status or rank.

StaffIdentificationSystemDescriptor

This descriptor defines the originating record system and code that is used for record-keeping purposes of the staff.

StudentCharacteristicDescriptor

This descriptor defines the set of important characteristics of the student.

StudentIdentificationSystemDescriptor

This descriptor defines the originating record system and code that is used for record-keeping purposes of the student.

TeachingCredentialDescriptor

This descriptor defines an indication of the category of a legal document giving authorization to perform teaching assignment services.

TermDescriptor

This descriptor defines the term of a session during the school year (e.g., Fall Semester).

WeaponDescriptor

This descriptor defines the types of weapon used during an incident.

Extended References

This interchange contains no external references.

Downloads

The following link is a ZIP archive containing the XSD for the Descriptors Interchange v2.1 along with the Ed-Fi Core XSD and Sample XML Data Files:

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