How the Integration Works
Edlink's integration with Blackboard facilitates synchronization of key educational data, including users, courses, enrollments, assignments, and submissions. The integration leverages Blackboard API endpoints to pull data and transform it into Edlink's unified data model. Blackboard objects like Users, Courses, and Enrollments are mapped to Edlink objects through a standardized transformation process.
Data Mapping
The table below highlights how Blackboard entities are mapped to Edlink's internal data models:
| Blackboard Entity | Edlink Entity | Details |
|---|---|---|
| Term | Session | i.e. Semester, Trimester, Quarter, Term, etc. However the school breaks up the year. |
| Users | Person | Includes Students, Teachers, and Administrators. Roles are mapped based on Blackboard user roles. |
| Courses | Course | Blackboard courses are synced to Edlink courses. |
| Sections | Class | Each section in Blackboard becomes a class in Edlink. |
| Enrollments | Enrollment | Links users to classes, syncing their enrollment status. |
| Assignments | Assignment | Retains metadata such as due dates, points, and descriptions. |
| Submissions | Submission | Reflects student submissions, including timestamps, statuses, and files. |
| Meetings | Meetings | Details about when a class actually met for instruction. |
| Attendance | Attendance | A Person's attendance of a Meeting. |
Key Considerations
API Access and Permissions:
Ensure the API client has sufficient permissions to access Blackboard endpoints for users, courses, and grades. Lack of permissions may result in incomplete data syncs.
Historical Data Limitations:
Blackboard's API primarily supports active courses and enrollments. Historical data may not be available without additional customization.
Role Mapping:
Custom roles in Blackboard must be manually mapped to appropriate Edlink roles during initial setup to avoid discrepancies.
Time Zones:
Ensure that time zones for courses and assignments are correctly configured in Blackboard to maintain alignment in Edlink.
SSO Dependencies:
Blackboard's SSO integration requires proper OAuth2 credentials. Misconfigured OAuth settings may result in authentication failures.