Troubleshooting Issues

Below is troubleshooting guidance for Brightspace integrations, including common issues that may arise during setup or synchronization.

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:userdata:read, enrollment:orgunit:read`).
  • Confirm that the class the user is enrolled in is active.

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 (orgunits:course: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 (dropbox:access:read, dropbox:folders:*).

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

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.