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

 

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

This section is primarily of interest to current platform hosts and client implementers of the Ed-Fi ODS / API. It contains general guidance about updating from previous versions, and a summary of the impact that the major changes have on existing implementations. The Feature & Change Summary contains more information about each change. 

The ODS / API v3.0 was designed to minimize breaking changes and impact on current technology implementers. However, some improvements and additions with a non-zero impact were deemed necessary by the Ed-Fi Community.

ChangeImpact on Platform HostsImpact on Client Developers
Data Standard Support
  • Review any current Extensions to see if additional elements are included in the new Data Standard. 
  • Apply and test Extensions, coordinate roll-out and support with API consumers though data governance, sandbox testing, and so forth.
  • Review client application API interactions for breaking changes in JSON payloads due to data model changes.
Ed-Fi Extension Decoupling
  • Review new Extension capabilities.
  • Client system developers will need to accommodate any platform changes or enhancements in API integration code.
Swagger / Open API Updates
  • Review new documentation and sandbox capability.
Standard OAuth 2.0 Alignment
  • Review and understand standard OAuth 2.0 Client Credentials Grant Flow.
  • Adapt client code to request a new access token upon token expiration.
  • This requirement will likely be familiar to developers using OAuth 2.0 in other implementations. The ODS / API v3.0 removes the previous non-standard OAuth implementation, which included a rolling expiration for tokens.
Descriptor References Require Namespaces
  • Review and consume the updated code.
  • Review all Ed-Fi Descriptors, ensure any localized Descriptors (i.e., those with values other than the as-shipped Ed-Fi Descriptor sets) adhere to the fully qualified namespace pattern. An overview of the feature and the namespace naming requirements is available in the New & Improved Features section of the Feature & Change Summary documentation.
  • Publish updated documentation, notify client systems.
  • Adapt client code to new specifications.
Code Refactoring
  • Review and consume the refactored code.
  • If applicable, re-apply customizations.
  • No impact.

* MetaEd v1.1.2 provides support for  ODS / API v3.0 Technical Preview. See /wiki/spaces/METAED/pages/18941343 for details.

Contents

Read more about the ODS / API v3.0 Tech Preview:

  • No labels