Versions Compared

Key

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

This documentation covers the changes made for the Ed-Fi Unifying Data Model v3.2. This version contains .... The enhancements in v3.2 originated with feedback from Ed-Fi Community based on real-world implementations. 

The sections that follow provide a high-level overview of the changes and enhancements, best practices for implementation, and a list of impactful and substantial data model changes. Type and element changes are shown, along with a rationale for the change and links to additional detail.

Audience

The audience for this documentation are technical professionals and decision makers who have adopted previous versions of the Ed-Fi Unifying Data Model. Those considering adoption of Ed-Fi Data Standards aligned with the Unifying Data Model v3.2 may find this information useful as well.

Prerequisites

To gain the most benefit from this information, you should already be familiar with the following knowledge areas:

  • Ed-Fi Alliance, see here
  • Ed-Fi technology, see here
  • Representational state transfer (REST) services, see Chapter 5 here
  • Extensible Markup Language (XML), see here
  • XML Schema (XSD), see here 

    Contents

    Table of Contents
    excludeContents

    Overview

    Data Standard v3.2 (most recent version is 3.2a) introduces changes to the core data model around the domains commonly captured in student information systems and assessment systems.  It is the successor to Ed-Fi Data Standard v3.1. The documentation below describes important principles and features of this release, and where to locate detailed information on specific data model changes.

    Release Features

    Non-breaking for API Binding

    The changes proposed in this release are intended to be non-breaking to most API clients. "Non-breaking" in this context generally means that data model changes are additive and optional, datatypes are generalized or field lengths are expanded. However, any change to a data model is potentially breaking given the specific API client behavior, so all API users are cautioned to review the changes carefully.

    Introduction of Deprecation

    In order to limit the impacts to field work derived from the API, including to help make the API binding changes non-breaking, the RFC proposes deprecation of data model elements. Deprecation as a concept is new to Ed-Fi specifications. Deprecation communicates that a data element or other API behavior is intended for removal in a future release, and likely in the next major release. Deprecation is therefore a recommendation to avoid use of certain data fields or features. Deprecation may be accompanied by information listing alternative or preferred options.

    Changes to Core Student Domains

    This release contains many changes to data domains commonly represented in Student Information Systems. These changes are described in detail in ED-FI RFC 20 - CORE STUDENT API

    Changes to Assessment Domains

    This release contains many changes to data domains commonly represented in Student Information Systems. These changes are described in detail in ED-FI RFC 22 - ASSESSMENT OUTCOMES API

    All Changes

    The chart below lists all changes included in Data Standard v3.2a.

    View all Data Standard 3.2(a) changes on the Ed-Fi Tracker.

    Jira Legacy
    serverEd-Fi Issue Tracker
    columnskey,summary,created,reporter
    maximumIssues100
    jqlQueryproject = DATASTD AND fixVersion = "DataStandard v3.1" ORDER BY created ASC
    serverIde04b01cb-fd08-30cd-a7d6-c8f664ef7691


    Include Page
    _What's New - Sidebar
    _What's New - Sidebar