For Developers
Supported Functionality
This document outlines the supported functionality of the Microsoft Teams integration with Edlink, detailing the capabilities mapped to Edlink's unified data model and features provided by the integration.
Overview
Rostering
- Synchronization of educational data entities, including:
- Districts: Mapped as Microsoft Tenants.
- Schools: Mapped as Microsoft Education Schools, including principal and address details.
- Classes: Mapped as Microsoft Education Classes, supporting metadata like class codes and grade levels.
- People: Mapped as Microsoft Education Users, including demographic details and roles.
- Enrollments: Class memberships, enabling roster synchronization.
Categories
- Synchronization of assignment categories, mapped to Edlink's
Category
model, for organizing coursework and related resources.
Authentication
- SSO (Single Sign-On):
- OAuth2-based SSO for seamless user authentication.
- Supports role-based access using Microsoft Education Graph API.
- Token Management:
- Secure handling of OAuth2 tokens for API requests.
- Refresh mechanisms to maintain session continuity.
On-Demand Access via API
- Assignments:
- Access and manage assignments, including metadata like state, due dates, and associated resources. These are accessible on demand via API requests.
- Submissions:
- Retrieve and manage student submissions, including attempt details, submission states, and outcomes such as points or feedback.
- Grades:
- Access grades and feedback linked to submissions through API, supporting analytics and reporting use cases.
Limitations
- Assignments and Grades Sync: These are not synchronized automatically but are accessible via API on demand.
- Observer Roles: Parent/Observer accounts are not synced in the current integration.
- Real-Time Updates: Synchronization occurs periodically and is not real-time.