A newer version of the Ed-Fi ODS / API is now available. See the Ed-Fi Technology Version Index for a link to the latest version.

Year-Specific ODS Configuration

Some implementations find it useful to add a school year in the API root, for example, as part of a partitioning strategy or to distinguish data associated with previous years from data for the current year. In the Ed-Fi ODS / API, the presence of the school year value in the API root is configurable, and off by default.

The school year can be configured in the API route through the following steps:

  • Update ApiSettings:Mode key in the appsettings.json of the EdFi.Ods.WebApi project to: "Mode": "YearSpecific"
  • Initialize development environment for year-specific configuration using the initdev command as outlined in the Getting Started Guide

  • As an example: from a PowerShell prompt, navigate to the Ed-Fi-ODS-Implementation folder and run the Initialize-PowershellForDevelopment.ps script, followed by the initdev command passing InstallType and OdsTokens parameters. OdsTokens is a semicolon-separated list of school years:

    initdev -InstallType YearSpecific -OdsTokens '2019;2020'
  • The same parameters noted above can be used with the deployment script packaged with EdFi.Suite3.RestApi.Databases NuGet for non-development environments. See Getting Started - Binary Installation Steps for details. 

See the Extensibility & Customization section for information on using year-specific configuration as a facet of a partitioning strategy.