Troubleshooting Issues

This document provides troubleshooting guidance for Ed-Fi integrations, including some common issues.

Incomplete Enrollment Data

• Missing session data may lead to incomplete enrollments. Ensure that session sync is enabled and configured correctly.
• Verify that section enrollments have corresponding course offerings linked to active sessions.

Attendance Discrepancies

• Attendance data sync may not align if Ed-Fi codes are missing. Ensure all attendance states (Present, Absent, Tardy) are configured properly.
• Confirm that attendance sync includes section-level and daily meeting-level attendance.

Missing Data

• Issue: Certain categories of information (contacts, parents, etc.) is not picked up by the sync.
• Potential Resolutions:
  • Go through the UI of your SIS/LMS and confirm that there is data available to be picked up by the sync.
  • Verify that the Ed-Fi API user has appropriate permissions to access entities such as students, sections, and courses.
  • Confirm that the API client has read access at both the district and school levels.
  • Contact Edlink to ensure that the version of Ed-fi that you are using is compatible with the Ed-fi endpoints used by the Edlink sync.

Incorrect Or Missing Edlink Mappings Errors

• Issue: User information appears incorrect or does not reflect properly in Edlink.
• Potential Resolutions:
  1. Navigate to the source's "Settings" page in the sidebar for the source, click the "Validate Configuration" button, and confirm that the validation operations completed successfully. This should create a default source-to-edlink mapping for various user information fields.
  2. Navigate to the "Field Mapping" menu for the source. Here you will find source-to-edlink mappings for various fields such as agent relaionships, races, disabilities, etc.
  3. Remap mislabeled user information properly using the dropdown menu.
  4. The user information will be updated in accordance with the new mapping on the next sync.

Sync Completion Errors

• Issue: No districts found
• Potential Resolutions:
  • A single Ed-fi instance can contain multiple districts, so to ensure that a sync is only fetching the data for a specific source, we need to know the ID for the intended district. Otherwise, we might accidentally pull data from other districts that belong to the same Ed-fi instance.
    1. Go to the client's source page in the dashboard.
    2. Click "Data Sync".
    3. Click "Adjust Settings".
    4. Scroll down to "Local Education Agency ID" and enter the correct ID for the district whose information we want to sync.
    5. Scroll to the "Save Changes" button and click it.