This document provides technical details about the integration between Microsoft Teams and Edlink. Additionally, this document includes recommendations for addressing common issues during implementation.
Entity Mapping
Below is a table that represents the mapping of entities between Edlink and Microsoft Teams:
| Edlink | Microsoft Teams |
|---|---|
| District | Tenant |
| School | Education School |
| Courses | Education Course |
| Classes | Education Class |
| People | Education User |
| People | Staff or Student |
| Enrollments | Class Membership |
| Categories | Assignment Category |
| Assignments | Assignments |
| Submissions | Student Submission |
| Resources | File or Link Resource |
Recommendations for Common Issues
Missing or Incomplete Rosters
- Cause: Missing or invalid external identifiers (e.g.,
externalId) for schools, users, or classes in Microsoft Teams. - Resolution: Ensure all schools, users, and classes in Microsoft Teams have unique and valid external identifiers, such as SIS or manual configurations.
Failed Authentication or SSO Issues
- Cause: Misconfigured OAuth2 credentials or incorrect tenant ID during setup.
- Resolution: Verify that OAuth2 credentials and tenant IDs are correctly configured in the Edlink dashboard. Ensure scopes are sufficient to grant access to required endpoints.
Partial Data Syncs
- Cause: Users or classes missing required metadata (e.g., class codes, display names) in Microsoft Teams.
- Resolution: Confirm that metadata for users and classes is complete in Microsoft Teams. Fields like
classCodeanddisplayNamemust be populated.
Resource Errors in Assignments
- Cause: Unsupported file types or missing attachments in assignment resources.
- Resolution: Verify that resources attached to assignments are in supported formats (e.g., PDFs, DOCX) and accessible via public or tenant-specific links.
Limited Access with Non-Education Licenses
- Note: Without Office 365 Education licenses, only basic identity information (names, email addresses, and roles) will be synchronized. Full roster and course data requires Education licenses.