Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

There are four non-normative classifications: Standard, Orthodox, Flexible, and and Local.

Classification

Definition

Examples

Standard

The community usage is generally  highly standardized (but not perfectly standardized), sometimes due to strong standards like EDFacts reporting. There is reason to believe that with sufficient governance a set of values that can work for a large majority of use cases is possible.

SchoolFoodServiceProgramService

Orthodox

The community

is 

is mostly standardized, but exceptions and localization are not infrequent. Ed-Fi's sample descriptor values will include a list that mirrors the standardization seen in the community.

GradeLevel

Flexible

The community

is 

is somewhat standardized, or there is one or more common, broadly-adopted vernacular classifications

 around

 around the concept. Local usage may be completely at odds with the vernacular, and that is to be expected in some cases. Ed-Fi's sample descriptor values will generally include a "starter" set of values that mirror the most common vernacular.

InternetAccess

Local

The option set values

are 

are highly localized in nearly all cases. Ed-Fi's sample values will generally only illustrate possible values, or not provide any Ed-Fi defined values at all.

GradingPeriod

Most Commonly-Used Descriptors

...

A good first list to pay attention to are the descriptors that are required in an Ed-Fi API certification, as these must be implemented by compliant systems. By API, those descriptors are:

Core Student API for Suite 4

(covered by Ed-Fi Student Information Systems API for Suite 4 Certification)

AcademicSubjectDescriptor
AddressTypeDescriptor
AttendanceEventCategoryDescriptor
BehaviorDescriptor

BirthCountryDescriptor
CalendarEventDescriptor
CalendarTypeDescriptor
CareerPathwayDescriptor
ClassroomPositionDescriptor
CohortScopeDescriptor
CohortTypeDescriptor
CountryDescriptor
CourseAttemptResultDescriptor
CourseIdentificationSystemDescriptor
CourseLevelCharacteristicDescriptor

CteProgramServiceDescriptor
DisciplineDescriptor

EducationalEnvironmentDescriptor
EducationOrganizationCategoryDescriptor
ElectronicMailTypeDescriptor

EntryGradeLevelDescriptor
EntryTypeDescriptor
ExitWithdrawTypeDescriptor

GradeLevelDescriptor
GradePointAverageTypeDescriptor
GradingPeriodDescriptor
GraduationPlanTypeDescriptor

GradeTypeDescriptor

HighestCompletedLevelOfEducationDescriptor
HomelessPrimaryNighttimeResidenceDescriptor
IncidentLocationDescriptor
LanguageDescriptor
LanguageInstructionProgramServiceDescriptor
LanguageUseDescriptor
LevelOfEducationDescriptor
LimitedEnglishProficiencyDescriptor
MonitoredDescriptor
NeglectedOrDelinquentProgramDescriptor
NeglectedOrDelinquentProgramServiceDescriptor
ParticipationDescriptor
ProficiencyDescriptor
ProgramAssignmentDescriptor

ProgramTypeDescriptor
RaceDescriptor
RelationDescriptor
ReporterDescriptionDescriptor
ResidencyStatusDescriptor
SchoolFoodServiceProgramServiceDescriptor
SexDescriptor
SpecialEducationSettingDescriptor
StaffClassificationDescriptor
StateAbbreviationDescriptor
StudentCharacteristicDescriptor
StudentIdentificationSystemDescriptor
StudentParticipationCodeDescriptor

TechnicalSkillsAssessmentDescriptor
TelephoneNumberTypeDescriptor
TermDescriptor
TitleIPartAParticipantDescriptor

Assessment Outcomes API

(covered by Ed-Fi Assessment Outcomes API for Suite 4 Certification)

AcademicSubjectDescriptor
AssessmentReportingMethodDescriptor
ResultDatatypeTypeDescriptor