Troubleshooting Issues

This document provides troubleshooting guidance for Brightspace integrations, including common issues that may arise during setup or synchronization. For further assistance, contact Edlink support or your Customer Success Manager.

Common Issues

Below are common Brightspace integration issues and their potential resolutions.

Missing Users or Enrollments

• Issue: Some users or enrollments are not appearing in Edlink.
  • Potential Resolutions:
    • Verify that the user is actively enrolled in a Brightspace course offering. Inactive or incomplete enrollments may not sync.
    • Ensure that the Brightspace API user has the necessary permissions to access enrollment data (users.read, enrollments.read).
    • Confirm that the course or class the user is enrolled in is active and not archived.

Course Offerings Not Syncing

• Issue: Brightspace course offerings are not showing up in Edlink.
  • Potential Resolutions:
    • Ensure that the course offering is active in Brightspace.
    • Check if the Brightspace OAuth application has access to course data (courses.read).

Assignment or Submission Data Missing

• Issue: Assignments or submissions are failing to create in Brightspace.
  • Potential Resolutions:
    • Check if the Brightspace API has permission to access assignment and submission endpoints (assignments.read, submissions.read).

Role Mapping Errors

• Issue: User roles appear incorrect or do not reflect properly in Edlink.
  • Potential Resolutions:
    • Ensure any special Brightspace roles are mapped to an Edlink-compatible role (Teacher, Student, Administrator, Observer).

API Connection Errors

• Issue: The sync fails or does not start due to API connection issues.
  • Potential Resolutions:
    • Verify that the Brightspace API credentials (Client ID, Secret, URL) are correctly entered in the Edlink configuration.
    • Ensure the Brightspace API is not experiencing downtime by visiting the Brightspace status page or contacting their support.
    • Re-authorize the API connection through Edlink if the issue persists.