Known Issues

Below are known issues with information or workarounds for the Admin App v1.5 for Ed-Fi Technical Suite Two and Three as supported by active ODS / API releases. This page will be updated as issues are found and resolved.

An error message when synching learning standards that reads “### learning standards may not have synchronized…”

Ed-Fi is aware of an issue where all available standards from Academic Benchmarks may not fully load on the first try. If this occurs, you will get a similar error message to “### learning standards may not have synchronized…”. The technical issue is a sequencing of learning standards between parent and child related elements. We are working on a resolution to this issue for release in the fall. For the time being, to resolve this issue, repeat the loading of standards using Admin App until the error message goes away. While this is an edge case in our QA testing, we've found that 1–3 more tries typically resolves this issue when presented.

For any issues not identified here, as well as suggestions for improvements, please use the Ed-Fi Tracker to file an issue or bug report under the "EDFI" queue for development review and resolution.

Rerun Admin App's First Time Setup

Replace secret.json file with default content. This file exists in the root of the web site directory. Delete the secret.json and re-create it with the following content

{
  "AdminCredentials": {
    "Password": "",
    "UserName": "",
    "UseIntegratedSecurity": "false"
  },
  "StagingApiCredentials": {
    "Password": "",
    "UserName": ""
  },
  "HostName": ".\\",
  "ProductionApiCredentials": {
    "Password": "",
    "UserName": "EdFiOdsProductionApi"
  },
  "AdminAppCredentials": {
    "Password": "",
    "UserName": "EdFiOdsAdminApp"
  }
}

Create a new text file named FirstTimeSetup and remove the file extension so it shows as “File” in file explorer.

Connect to the EdFi_Admin database on your SQL Server and remove old data created by the original run of setup. There might be a table in the sample below that doesn’t exist -- you can remove these lines if they show an error in SSMS.

BEGIN TRAN    DECLARE @ApplicationId INT;
    SELECT @ApplicationId = ApplicationId FROM dbo.Applications WHERE ApplicationName = 'Ed-Fi ODS Admin App'    DELETE FROM dbo.ClientAccessTokens WHERE EXISTS (
        SELECT 1 FROM dbo.ApiClients
        WHERE ClientAccessTokens.ApiClient_ApiClientId = ApiClients.ApiClientId
          AND Application_ApplicationId = @ApplicationId
    )
    DELETE FROM dbo.ClientAuthorizationCodes WHERE EXISTS (
        SELECT 1 FROM dbo.ApiClients
        WHERE ClientAuthorizationCodes.ApiClient_ApiClientId = ApiClients.ApiClientId
          AND Application_ApplicationId = @ApplicationId
    )
    DELETE FROM dbo.ApiClients WHERE Application_ApplicationId = @ApplicationId
    DELETE FROM dbo.ApplicationEducationOrganizations WHERE Application_ApplicationId = @ApplicationId
    DELETE FROM dbo.ProfileApplications WHERE Application_ApplicationId = @ApplicationId
    DELETE FROM dbo.Applications WHERE ApplicationId = @ApplicationId
    DELETE FROM dbo.OdsInstances--ROLLBACK
--COMMIT

Relaunch Admin App and you should see First Time Setup again.

Known Issues

Contents