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.
Step 7. Run the Ed-Fi ODS / API
- Ian Christopher
- Chris Moffatt (Deactivated)
The as-shipped projects in the Ed-Fi-ODS-Implementation repository are configured to run the desktop version of Internet Information Server (i.e., IIS Express). This server is installed with Visual Studio and facilitates easy debugging with minimal configuration.
After the startup projects are set, you are ready to run or debug the Ed-Fi ODS / API.
- To run the Ed-Fi ODS / API without debugging, Press Ctrl+F5.
- To interactively debug the Ed-Fi ODS / API solution, Press F5 (or press the Start button in the Standard Toolbar).
The first time you build the solution, you may get a build error related to the Ed-Fi-Common project. If this occurs, simply building the solution again will generally result in a successful build.
The solution builds and starts each of the projects that were added to the startup projects list. Each web application starts an instance of IIS Express. By default, the websites are configured according to the following table:
Website | Project | URL |
|---|---|---|
Ed-Fi ODS API | EdFi.Ods.WebApi | |
Sandbox Administration | EdFi.Ods.Admin.Web | |
Ed-Fi ODS API Documentation | EdFi.Ods.SwaggerUI |
The Ed-Fi ODS / API Home Page
The Ed-Fi ODS / API homepage is a page at the root level of the the Ed-Fi ODS / API REST interface directory. This page's purpose is to help developers orient themselves to the overall solution. This is not an end-user-facing web page and should be deleted from production installations.
Follow each of the steps on the screen to finish configuring the solution. This involves:
- Creating users, including an administrative user
- Creating a sandbox
- Exploring the API using the key and secret associated with a sandbox
Note that the test user login name changed in v2.1 from test@edfi.org to test@ed-fi.org (adding a hyphen).
The Sandbox Administration Portal
The Sandbox Administration Portal is a web application used to create sandbox databases containing data that can be accessed through the Ed-Fi ODS / API.
The Ed-Fi ODS / API Documentation Web Page
The REST interface to the Ed-Fi ODS / API exposes metadata describing the exposed resources as well as the inputs, HTTP verbs, and schema of the exposed entities. This metadata enables a user interface (based on the Swagger framework) to display API documentation.
The Ed-Fi ODS / API Documentation web page uses a Key and Secret (Sandbox Administration Portal) to access the data that has been placed in the corresponding sandbox.
To view the data in your sandbox, enter the key and secret in the appropriate fields and retrieve a token. This token is used throughout your session to access your sandbox. This is the same process used by other applications to access their data.
