Skip to end of metadata
Go to start of metadata

This section describes the recent improvements, updates, fixes, and changes made since MetaEd v2.0. 

Updating the IDE to the Latest Version

In a command prompt session, navigate to the MetaEd-IDE folder in the project directory, enter yarn upgrade atom-metaed@latest and press Enter. This updates the MetaEd IDE to the latest version without updating other components.

See the section Updating the IDE for additional detail.

Updates & Improvements in 2.5.1


The major improvements in 2.5.1 include:

  • Supports ODS / API 5.2 and Data Standard 3.3.0-a. This version supports the latest (March 2021) release of the Ed-Fi Data Standard and Ed-Fi ODS / API.
  • Language Features Changes.
    • Use of "is weak" is now marked as deprecated; although it continues to support prior data standards, "is weak" will cause an error with Data Standard version 3.3.0-a or higher.
    • Similarly, the use of attributes on Descriptors is deprecated and will generate an error with Data Standard 3.3.0-a and higher. 
    • The new "potentially logical" keywords indicate that a reference may have a logical rather that literal interpretation in a target technology.
  • Publishing Changes.
    • The Data Handbook will no longer display the XSD Datatype for a field.
    • No longer generating an InterchangeOrderMetadata.xml  file, as the API Bulk Client Loader no longer relies on it for running bulk uploads into the ODS / API.

Change Detail

The following is a detailed list of changes in 2.5.1:


MetaEd needs to prohibit adding attributes to descriptors


Generated SQL Artifacts When In Core Mode Should Include License Header


MetaEd language construct to indicate optional reference


Rename API Model element mapping from "potentially logical" keyword


Fix any new year (2021) issues


Fix FK gen issue with role-named collection of entities themselves having role-named properties


Support ODS API version 5.2.0


Bug on build and deploy buttons


Drop 'is weak'


Remove InterchangeOrderMetadata generation for ODS/API 5.0.0+


Remove XSD Datatype from the Data Handbook

Updates & Improvements in 2.4.0


The major improvements in 2.4.0 include:

  • Supports ODS / API 5.1.x and Data Standard 3.2.0-c.  This version supports the latest Data Standard and ODS / API releases.
  • Fixes deploy issue.  This version works around a bug in Atom 1.52.0 that prevented the MetaEd deploy feature from working.

Change Detail

The following is a detailed list of changes in 2.4.0:

  • METAED-1171 — Metaed is not deploying the StudentTransportation sample extension in 5.0.0
  • METAED-1166 — MetaEd consider removing \r\n from generated artifacts
  • METAED-1168 — Support ODS API version 5.1.0

Updates & Improvements in 2.3.0


The major improvements in 2.3.0 include:

  • Supports ODS / API 5.0.x and Data Standard 3.2.0-c. This version supports the latest Data Standard and ODS / API releases.

Change Detail

The following is a detailed list of changes in 2.3.0:

  • METAED-777 — Missing Core Identities When Generating Interchange XSD
  • METAED-1135 — Generates incomplete extension interchange XML
  • METAED-1136 — Align Unique Index Names
  • METAED-635 — Common As Collection With No Identity Properties Should Fail Validation
  • METAED-731 — Shouldn't Allow a Collection of Inline Common
  • METAED-1127 — Update MetaEd IDE version selection components
  • METAED-1134 — Support new surrogate key pattern for Person
  • METAED-1138 — Change XSDs to use semver versions for data standard
  • METAED-1146 — Change About screen text to white
  • METAED-1147 — Update MetaEd IDE version selection components for a change in API release version
  • METAED-1144 — Default MetaEd to latest instead of Suite 2

Updates & Improvements in v2.2


The major improvements in v2.2 include:

  • Supports ODS / API v3.4 and Data Standard v3.2b. This version supports the latest Data Standard and ODS / API releases.

Change Detail

The following is a detailed list of changes in v2.2:

  • METAED-763 — MetaEd Generates Extra Extension Table When Extending With Optional Common
  • METAED-948 — Required collections in MetaEd additions aren't reflected in the ApiModel-EXTENSION.json with correct cardinality
  • METAED-1101 — Deploy does not work correctly when targeting "C:"
  • METAED-1128 — Change Queries Deletes Fail for Derived Types in PostgreSQL
  • METAED-1102 — Consider having deploy list full paths for deployed files
  • ODS-3884 — Refactor Existing Change Queries MetaEd Plug-in for targeting specific database engines
  • ODS-3885 — Modify Change Queries MetaEd Plugins to Support SQL Server and PostgreSQL
  • ODS-4061 — Fix the case on the change query schema name

Updates & Improvements in v2.1.2


MetaEd v2.1.2 is a bug fix release. It resolves an issue that prevented extension projects from deploying to ODS / API version 2.x.

Change Detail

The following is a detailed list of changes in v2.1.2:

  • METAED-1106 — Deploy incorrectly checks for extensions projects in 2.x versions

Updates & Improvements in v2.1.1


MetaEd v2.1.1 is a bug fix release. It resolves an issue when targeting ODS / API v3.3 and Data Standard v3.2a that prevented extension projects from building in the ODS / API.

Change Detail

The following is a detailed list of changes in v2.1.1:

  • METAED-1105 — Revert and incorporate Ed-Fi-Model 3.2a to report project version 3.2.0

Updates & Improvements in v2.1


The major improvements in v2.1 include:

  • Supports ODS / API v3.3 and Data Standard v3.2a. This version supports the latest Data Standard and ODS / API releases.
  • Adds Support for Deprecation. Modelers can now mark entities and properties as being deprecated and slated for removal in future model versions. Warnings notify users where extension projects rely on a deprecated entity or property. Deprecation is also surfaced in the Ed-Fi Handbook documentation.
  • Adds Common Subclasses. This allows modelers to subclass a Common in a manner similar to Association and Domain Entity subclasses, providing an alternative to Common Extensions.
  • Deprecated Uncommon Language Features. Extensions will get deprecation warnings when using uncommon language features slated for removal in a future version. Most extension projects will be unaffected.
  • Ready for Roadrunner. This version generates all files necessary for Project Roadrunner's PostgreSQL implementation.

Change Detail

The following is a detailed list of changes in v2.1:

  • METAED-621 — Create New Language Element to Subclass Core Common Types
  • METAED-1082 — Implement PostgreSQL name collapsing
  • METAED-966 — Revise Data Handbook to clearly distinguish the case when there are duplicate entity names
  • METAED-969 — Remove dash from "Ed-Fi" project name in MetaEd versions of Data Standard projects
  • METAED-989 — Have Data Handbook conform to UML datatypes and standardized bindings
  • METAED-994 — Ed-Fi HTML Handbook missing extension components
  • METAED-1004 — Introduce concept of deprecation in MetaEd DSL
  • METAED-1018 — Expand merge validation to include Domain Entities that are parents of conflicting Simple Types
  • METAED-1041 — Create PostgresSQL-specific SQL plugin
  • METAED-1044 — Surface deprecation in the Data Handbook
  • METAED-1045 — Surface deprecation in the API model
  • METAED-1046 — Deprecate use of MetaEd DSL words for use in extensions
  • METAED-1054 — Add deprecation warnings to extension and subclassing
  • METAED-1055 — Support for Record Level Ownership Authorization
  • METAED-1060 — Minor realignments to Handbook branding
  • METAED-1064 — Add deprecation reason to Data Handbook
  • METAED-1075 — Plugin load errors should communicate to end users
  • METAED-1076 — Surface non-validator issue messages to IDE and console end users
  • METAED-1083 — MetaEd support for ODS/API v2.6
  • METAED-1086 — Change ODS / API Deploy directory structure
  • METAED-1092 — Changes to ODS / API Deploy core artifacts location
  • METAED-1098 — Set log messages unimportant to end users to debug level
  • METAED-891 — Handbook - provide link back to superclass from a subclass
  • METAED-1049 — Entity with same name as simple type causes incorrect XSD generation
  • METAED-1062 — Turn off deprecation warnings for core when in normal (not Alliance) mode
  • METAED-1078 — MetaEdEnvironment.metaEdVersion not being set to actual version
  • METAED-1085 — Relational plugin - column cloning is too shallow
  • METAED-1087 — Some plugins crash when non-dependent plugins are not loaded

Updates & Improvements in v2.0

Backward Compatibility with v1.x

Existing MetaEd v1.x projects can be upgraded to v2.x. The steps to upgrade a project are outlined in Getting Started - Upgrading MetaEd Projects from v1.x.


The major improvements from v1.0 include:

  • Added New Namespace Reference. This new feature allows reuse of entity names across multiple extension projects. See the Namespace Reference documentation for more details.
  • Requires Node 12.5.0 or higher. Node 6.x was end-of-lifed in April 2019.  Node 12.5.0 is the most current version, with long term support until April 2022.
  • Removed Implicit Merges. This improvement removes automatic key unification when column names match, which provides greater transparency to data modelers. See the MetaEd Cookbook entry Using Merge Directives for more information about key unification in MetaEd v2.0.
  • Added Standardized Plugin Configuration. This new feature for the IDE framework automatically loads configuration files, organizes the data, and notifies plugins. See the Plugin Developer Guide for complete details.
  • Changed "With Context" to "Role Name". This language improvement changed With Context to Role Name to better represent the purpose of the keywords. The Upgrading MetaEd Projects from v1.x section in the Getting Started guide has details about how to update old projects to reflect the new language specification.
  • Added Open Existing Project Support in the IDE. This improvement adds a new Open Existing Project menu option, which, not surprisingly, opens an existing project in MetaEd.

Change Detail

The following is a detailed list of changes from v1.0:

  • METAED-898 — New Namespace Reference
  • METAED-854 — Upgrade Node Requirement to 12.x
  • METAED-916 — Removed Implicit Merges
  • METAED-827 — Standardized Plugin Configuration
  • METAED-886 — With Context to Role Name
  • METAED-953 — Api Model is Generating DateTime instead of DateTime2
  • METAED-972 — Convert CreateDate and LastModifiedDate to DateTime2
  • METAED-861 — Have IDE save before build and deploy
  • METAED-991 — inline common not caught by validation in 2.x
  • METAED-988 — MetaEd 2.0 needs validation that SchoolYear is EdFi.SchoolYear
  • METAED-965 — Add an open existing extension project option to IDE
  • METAED-1024 — Association domain entity references cannot have merge directives
  • METAED-993 — Clarify Tech Suite 2 support for new features added in MetaEd 2.0
  • METAED-1026 — Improve error message for projectName
  • METAED-997 — If the user duplicates an entity name in multiple namespaces, don't generate bulk extension artifacts

  • No labels