This version of the Ed-Fi Data Standard is no longer supported. See the Ed-Fi Technology Version Index for a link to the latest version.

 

What's New - Data Model Changes

Owned by Ian Christopher
Apr 21, 2015
4 min read

Data Model Changes by Domain

This section describes changes made to the Ed-Fi Data Standard from v1.2 to v2.0, along with a rationale for the changes. Information and additional context for the changes can be found in the Ed-Fi Issue Tracker (https://tracker.ed-fi.org/browse/DATASTD) by viewing the associated issue number(s) in the "Change" column below. 

This summary of important type and element changes is included here for reference. A more detailed list can be found in the Ed-Fi Data Standard v1.2 to v2.0 XSD Change Log.

Global

Change

Rationale

Lookup Types created as part of reference Types and identity Types paired to uniquely identifiable elements (DATASTD-523, DATASTD-598)

Better identification while preserving lookup capability

Descriptor enhancements:

  • CodeValue now required.
  • Namespace is moved to element status.
  • References contain only CodeValue and (optional) Namespace
  • Separate named Types for each Descriptor

Less ambiguity and stronger types

Country and CountryCode converted to CountryDescriptor

Allows for flexibility and updating new values

Annotations cleaned up correcting spelling, spacing, punctuation, and missing values (DATASTD-540, DATASTD-541, DATASTD-548, DATASTD-550, DATASTD-552, DATASTD-555, DATASTD-568)

Clarity, consistency

IdentificationSystem attributes changed to elements that references Descriptor Types

Added flexibility

Assessment Domain

ChangeRationale

Assessment.AssessmentItem reference moved to AssessmentItem

Allows for changes to an item without affecting the entire Assessment

StudentAssessmentItem.StudentAssessment reference moved to StudentAssessment

Structural consistency

Assessment.ObjectiveAssessment reference moved to ObjectiveAssessment

Structural consistency

StudentObjectiveAssessment.StudentAssessment reference moved to StudentAssessment

Structural consistency

Namespace element added to Assessment (optional), AssessmentFamily (required), LearningObjective (required), LearningStandard (required) (DATASTD-600, DATASTD-745)

Authorization and identification

Renamed elements:

  • Assessment.GradeLevelAssessed to AssessedGradeLevel
  • Assessment.LowestGradeLevelAssessed to LowestAssessedGradeLevel
  • AssessmentFamily.AssessmentFamilyReference to ParentAssessmentFamilyReference
  • AssessmentItem.ItemCategory to AssessmentItemCategory
  • StudentAssessment.GradeLevelWhenAssessed to WhenAssessedGradeLevel
  • StudentAssessment.PerformanceLevels to PerformanceLevel
  • StudentAssessment.ScoreResults to ScoreResult

Naming consistency

Formerly optional elements now required:

  • Assessment.AcademicSubject
  • Assessment.AssessedGradeLevel
  • Assessment.Version (DATASTD-547)

Uniqueness and Identification

Added AssessmentReportingMethod to StudentAssessment.ScoreResult

Enhancement

Bell Schedule Domain

Change

Rationale

Renamed elements:

  • BellSchedule.GradeLevels to GradeLevel
  • Section.AvailableCredit to AvailableCredits
  • Section.SectionCharacteristics to SectionCharacteristic

Naming consistency

BellSchedule.CalendarDateReference no longer unbounded

More precise definition of BellSchedule

BellSchedule.GradeLevel no longer unbounded

More precise definition of BellSchedule

BellSchedule.EducationOrganizationReference converted to a SchoolReference

More precise reference

Section.LocationReference now required

Needed to uniquely identify the Section

Section.SessionReference removed

Elements of SessionReference (Term, SchoolYear) already included in CourseOfferingReference

Discipline Domain

ChangeRationale

DisciplineAction.EducationalOrganizationReference to SchoolReference

More precise reference

Renamed DisciplineIncident elements:

  • Behaviors to Behavior
  • Weapons to Weapon

Naming consistency

DisciplineIncident.EducationalOrganizationReference to SchoolReference

More precise reference

Education Organization Domain

ChangeRationale

Added enumerations “AA”, “AE”, “AP”,”AS”, “FM”, “MH”,   “MP”, “PW”, “VI” to Address.StateAbbreviation (DATASTD-514):

  • EducationOrganizationNetwork
  • EducationServiceCenter
  • LocalEducationAgency
  • School
  • StateEducationAgency

CEDS alignment

Added enumeration “None” to School.InternetAccess (DATASTD-576)

Enhancement

Added fundamental new association: EducationOrganizationPeerAssociation

Enhancement

Added new domain entity AccountabilityRating split out from individual Education Organization entities:

  • EducationServiceCenter
  • LocalEducationAgency
  • School
  • StateEducationAgency

Enhancement

New Elements:

  • EducationServiceCenter.EducationServiceCenterId
  • LocalEducationAgency.LocalEductaionAgencyId
  • StateEducationAgency.StateEducationAgencyId

Required for unique identification

Moved School.ClassPeriodReference to ClassPeriod

Model normalization

Moved School.LocationReference to Location (DATASTD-533)

Model normalization

New ComplexType InternationalAddress added to:

  • EducationServiceCenter
  • LocalEducationAgency
  • School
  • StateEducationAgency

Enhancement

Renamed element FeederSchoolAssociation.ReceivingSchoolReferent to SchoolReference (DATASTD-561):

  • LocalEducationAgency.ParentLocalEducationAgencyReference
  • LocalEducationAgency.StateEducationAgencyReference
  • School.LocalEducationAgencyReference
  • School.SchoolCategories to School.SchoolCategory (DATASTD-576)
  • FeederSchoolAssociation.ReceivingSchoolReference to SchoolReference
  • School.GradesOffered to School.GradeLevel
  • Telephone to InstitutionTelephone

Naming consistency

New School elements (DATASTD-628):

  • CharterApprovalAgencyType (as well as new enumeration type and enumeration values)
  • CharterApprovalSchoolYear

CEDS alignment

Enrollment Domain

ChangeRationale

ClassOf renamed to ClassOfSchoolYear

More accurate name

EducationalPlans renamed to EducationPlan

Naming consistency

TermType changed to TermDescriptor (DATASTD-14)

Enhancement for greater flexibility

Graduation Domain

ChangeRationale

Elements added to GraduationPlan:

  • GraduationSchoolYear
  • RequiresAssessment

Enhancement

Elements added to GraduationPlan.CreditsByCourse:

  • CourseSetName
  • Credits.CreditConversion
  • Credits.CreditType

Enhancement

Name Changes:

  • CreditsByCourse.GradeLevel renamed to WhenTakenGradeLevel (DATASTD-559)
  • CreditsBySubject.SubjectArea to AcademicSubject
  • PostSecondaryInstitution.InstructionalCategory renamed to MediumOfInstruction
  • PostSecondaryInstitution.ControlOfInstitution to AdminstrativeFundingControlDescriptor

Naming consistency

Graduation.TotalCreditsRequired renamed to TotalRequiredCredits

Naming consistency

PostSecondaryInstitution.EducationOrgIdentificationCode converted to PostSecondaryInstitutionIdentificationCode

More precise reference

CreditsByCourse.CourseCode changed to CourseReference

More precise reference

Intervention Domain

ChangeRationale

Renamed Elements:

  • InterventionEffectiveness.Rating to InterventionEffectivenessRating
  • Intervention.SexAppropriateness to AppropriateSex
  • Intervention.GradeLevelAppropriateness to AppropriateGradeLevel
  • InterventionPrescription.GradeLevels to AppropriateGradeLevel
  • InterventionPrescription.Sex to AppropriateSex
  • InterventionStudy.GradeLevels to AppropriateGradeLevel
  • InterventionStudy.Sex to AppropriateSex
  • EducationContentReference to EducationContentSource
  • EducationContent.DerivativeWorkSource to DerivativeSourceEducationContentSource
  • EducationContent.Languages to Language

Naming consistency

Added InterventionIdentificationCode element to Intervention

Helps uniquely identify Intervention

Intervention.EducationContentSource no longer unbounded

Helps uniquely identify Intervention

EducationOrganizationReference added to InterventionPrescription

Helps uniquely identify InterventionPrescription

InterventionPrescriptionIdentificationCode added to InterventionPrescription

Helps uniquely identify InterventionPrescription

InterventionPrescription.EducationContentSource no longer unbounded

Helps uniquely identify InterventionPrescription

EducationOrganizationReference added to InterventionStudy

Helps uniquely identify InterventionStudy

InterventionStudyIdentificationCode added to InterventionStudy

Helps uniquely identify InterventionStudy

InterventionStudy.EducationContentSource no longer unbounded

Helps uniquely identify InterventionStudy

Namespace element added to EducationContent (required) (DATASTD-745)Authorization and identification

Program Domain

Change

Rationale

StudentCTEProgramAssociation.CTEProgram now optional

Allows for extensions

Renamed Elements:

  • Program.ProgramCharacteristics to ProgramCharacteristic
  • StudentProgramAssociation.Services to Service
  • StudentSpecialEdProgramAssociation to StudentSpecialEducationProgramAssociation
  • StudentSpecialEdProgramAssociation.ServiceProviders to ServiceProvider

Naming Consistency

EducationOrganizationReference was added to Program

Enhancement

ProgramType was given a new enumeration value called Foreign Exchange (DATASTD-519)

Enhancement

School Calendar Domain

Change

Rationale

CalendarDateReference removed from AcademicWeek

Days already defined by BeginDate and EndDate

SchoolReference added to AcademicWeek

Required to uniquely identify AcademicWeek (formerly EducationOrganizationReference part of CalendarDateReference)

CalendarDate.EducationOrganizationReference now required

Helps to uniquely define CalendarDate entity

CalendarDate.CalendarEvent changed from DiscriptorReferenceType to CalendarEvent common type with EventDuration (DATASTD-229)

Enhancement

CalendarDateReference removed from GradingPeriod

Days already defined by BeginDate and EndDate

SchoolReference added to GradingPeriod

Required to uniquely identify GradingPeriod (formerly EducationOrganizationReference part of CalendarDateReference)

Special Education Domain

Change

Rationale

RestraintEvent.EducationOrganizationReference converted to SchoolReference

More precise reference

Staff Domain

ChangeRationale

Renamed Associations:

  • TeacherSchoolAssociation to StaffSchoolAssociation
  • TeacherSectionAssociation to StaffSectionAssociation

Naming consistency

Renamed Elements:

  • StaffEducationOrgAssignmentAssociation to StaffEducationOrganizationAssignmentAssociation
  • StaffEducationOrgEmploymentAssociation to StaffEducationOrganizationEmploymentAssociation
  • Staff.Credentials to Staff.Credential
  • Staff.StaffUniqueStateId to Staff.StaffUniqueId
  • Staff.HighestLevelOfEducationCompleted to Staff.HighestCompletedLevelOfEducation
  • Staff.Languages to Staff.Language
  • OpenStaffPosition.AcademicSubjects to AcademicSubject
  • ForeignCitizenshipDocumentation to ForeignCitizenshipIdentificationDocument
  • ForeignCitizenshipDocumentation.DocumentCategory to ForeignCitizenshipIdentificationDocument.PersonalInformationVerification
  • Staff.Citizenship.USCitizenshipDocumentation to Staff.Citizenship.USCitizenshipIdentificationDocument
  • Staff.Citizenship.USCitizenshipDocumentation.DocumentCategory to   Staff.Citizenship.USCitizenshipIdentificationDocument.PersonalInformationVerification
  • Staff.Name.PersonalInformationVerification to Staff.Name.PersonalIdentificationDocument
  • Staff.Name.PersonalInformationVerification.DocumentCategory to Staff.Name.PersonalIdentificationDocument.PersonalInformationVerification
  • OpenStaffPosition.InstructionalGradeLevels to InstructionalGradeLevel
  • Staff.ElectronicMail.EmailAddress to Staff.ElectronicMail.ElectronicMailAddress
  • Staff.StaffIdentificationCode.ID to Staff.StaffIdentificationCode.IdentificationCode
  • Staff.StaffIdentificationCode.AssigningOrganziationCode to Staff.StaffIdentificationCode.AssigningOrganizationIdentificationCode

Naming consistency

Staff.Citizenship.USCitizenshipIdentificationDocument.DocumentExpirationDate and Staff.Name.PersonalIdentificationDocument.DocumentExpirationDate type changed from xs:int to xs:date

Correction

New Elements:

  • Staff.ElectronicMail.ElectronicMailType
  • Staff.ElectronicMail.PrimaryEmailAddressIndicator
  • Staff.HighlyQualfiedTeacher
  • Staff.Name.PersonalIdentificationDocument.IdentificationDocumentUse
  • Staff.Credential.StateOfIssueStateAbbreviationType

Enhancements

Length Change (DATASTD-546):

  • Staff.Name.GenerationCodeSuffix Length = 10
  • Staff.Name.PersonalTitlePrefix Length = 30
  • Staff.OtherName.GenerationCodeSuffix Length = 10
  • Staff.OtherName.PersonalTitlePrefix Length = 30

CEDS alignment

Staff.Race now unbounded

Enhancement for tracking multiple ethnicities

Student Academic Record Domain

ChangeRationale

Element name changes:

  • StudentAcademicRecord.Recognitions to Recognition
  • StudentAcademicRecord.SessionCreditsAttempted to SessionAttemptedCredits
  • StudentAcademicRecord.SessionCreditsEarned to SessionEarnedCredits
  • CreditsAttempted to AttemptedCredits
  • CreditsEarned to EarnedCredits
  • AdditionalCreditsEarned to EarnedAdditionalCredits
  • GradeLevelWhenTaken to WhenTakenGradeLevel

Naming consistency

Achievement-specific elements moved under Achievement common Type:

  • AchievementTitle
  • AchievementCategory
  • AchievementCategorySystem
  • IssuerName
  • IssuerOriginURL
  • Criteria
  • CriteriaURL
  • EvidenceStatement
  • ImageURL

Model enhancement to allow for reuse of Achievement Type

StudentAcademicRecord.SessionReference replaced with SchoolYear, Term, and EducationOrganization references

Enhancement: defined session no longer required

SchoolYear added to AcademicRecord

Enhancement

Elements added to CourseTranscript:

  • CourseTitle
  • AlternativeCourseTitle
  • AlternativeCourseCode

Enhancement

Student Attendance Domain

ChangeRationale

AttendanceEvent structure converted to common Type and new entities created:

  • SectionAttendanceTakenEvent
  • StudentInterventionAttendanceEvent
  • StudentProgramAttendanceEvent
  • StudentSchoolAttendanceEvent
  • StudentSectionAttendanceEvent

Individual entities added that extend AttendenceEvent functionality

Student Identification and Demographics Domain

ChangeRationale

Enumerations added to Parent and Student:

  • Address.State (“AA”, “AE”,”AP”,”AS”, “FM”,   “MH”, “MP”, “PW”, “VI) (DATASTD-514)
  • Race (“Choose Not to Respond”,”Other”) (DATASTD-579)

Alignment with CEDS

Name.GenerationCodeSuffixType changed length from 30 to 10 (DATASTD-546)

Alignment with CEDS

InternationalAddress complex Type added to Student.Address and Parent.Address (DATASTD-537)

Allows for the recording of an international address   where applicable

Renamed Student elements:

  • ForeignCitizenshipDocumentation to ForeignCitizenshipIdentificationDocument (DATASTD-577)
  • CityOfBirth to BirthCity (DATASTD-589)
  • InternationalProvinceOfBirth to BirthInternationalProvince (DATASTD-589)
  • Languages to Language
  • CohortYears to CohortYear
  • Disabilities to Disability
  • LearningStyles to LearningStyle
  • ProgramParticipations to ProgramParticipation
  • StudentCharacteristics to StudentCharacteristic
  • StudentIndicators to StudentIndicator

Naming consistency

Added DisabilityDeterminationSourceType to Disability (DATASTD-627)

CEDS alignment