|
| 1 | +--- |
| 2 | +title: Use Microsoft Teams Assignments with LTI 1.3 Advantage compliant LMS |
| 3 | +description: Learn how to integrate and use the Teams Assignments LTI app with any LTI 1.3 Advantage compliant LMS or virtual learning environment (VLE). |
| 4 | +author: jennplatt |
| 5 | +ms.author: avering |
| 6 | +manager: mimast |
| 7 | +ms.date: 03/20/2025 |
| 8 | +ms.topic: how-to |
| 9 | +ms.service: microsoft-365-business |
| 10 | +--- |
| 11 | + |
| 12 | +# Use Microsoft Teams Assignments with any LTI 1.3® Advantage compliant LMS/VLE |
| 13 | + |
| 14 | +This guide provides steps for deploying the Microsoft Teams Assignments Learning Tools Interoperability (LTI®) app in any learning management system (LMS) that implements [the LTI® 1.3 Advantage](https://www.imsglobal.org/spec/lti/v1p3/impl/) standard as a fully conformant platform (LTI® Advantage Complete). |
| 15 | + |
| 16 | +For an overview of all of the Microsoft integrations for LMS, see [Integrating Microsoft products with your LMS](/microsoft-365/lti/). |
| 17 | + |
| 18 | +## Request a Microsoft 365 sandbox environment |
| 19 | + |
| 20 | +> [!IMPORTANT] |
| 21 | +> If you're a **Microsoft Partner** that has an LTI® 1.3 Advantage compliant platform and wish to test deployment and functionality of the Teams Assignments LTI® tool on behalf of your customers, you need a Microsoft 365 Education sandbox environment to deploy and use the application. |
| 22 | +
|
| 23 | +**To request a Microsoft 365 sandbox environment:** |
| 24 | + |
| 25 | +1. You first need a Microsoft Partner ID. Your Microsoft Partner ID appears in the top right corner next to your name when you log into the [Microsoft Partner Center](https://partner.microsoft.com). If you don't have one, you can obtain one by [joining the Microsoft AI Cloud Partner program](https://partner.microsoft.com/partnership). |
| 26 | +1. When you have your Microsoft Parter ID, request a sandbox using one of the following methods based on your business type: |
| 27 | + - [Request a Microsoft 365 Education development/testing sandbox](https://m365edupartnerportal.powerappsportals.com/MSEDUIntegrationSignup/) as an Education ISV or SI partner who builds and supports integrations with Microsoft products and services. |
| 28 | + - [Request to join the Microsoft Global Training Partner program](https://m365edupartnerportal.powerappsportals.com/MSGTPSignup/) as a Training Partner who delivers training and support to customers on Microsoft products and services. |
| 29 | + |
| 30 | +> [!NOTE] |
| 31 | +> The person who performs this integration should be an administrator of their LMS and have a Microsoft 365 Education (school) account. |
| 32 | +
|
| 33 | +## Deploy the Teams Assignments LTI® tool for your LMS |
| 34 | + |
| 35 | +1. Go to the [Microsoft LMS Gateway](https://lti.microsoft.com/). |
| 36 | +1. Select the **Go to Registration Portal** button. |
| 37 | +1. Sign in with a _Microsoft 365 Education_ account (this is the account provided to you by your qualified education institution, or an account in your Edu Partner Microsoft 365 Education sandbox environment). |
| 38 | +1. After signing in, select **Add new registration**. |
| 39 | +1. Select **Microsoft** **Teams Assignments**, and then select **Next**. |
| 40 | +1. Enter an easily identifiable **Registration name**. |
| 41 | +1. Select **Other** as the **LMS platform**, and then select **Next**. You're given a list of keys that need to be copied and pasted to your LMS site. |
| 42 | +1. Leave the Microsoft LMS Gateway open in your browser tab and open the LMS site in another browser or tab and log in as an administrator. |
| 43 | +1. Navigate to your platform's LTI Tool configurations and add a new LTI 1.3 tool. |
| 44 | +1. Copy the values provided and save them. You need to add them to your LMS LTI® 1.3 tool configuration in the following steps. Hint: Check your LMS documentation to find the steps to create a new LTI® 1.3 registration and the correct fields to paste these values into. |
| 45 | +1. On the **Microsoft LMS gateway** tab, select **LMS provided registration keys**. |
| 46 | +1. Copy and paste the LTI® 1.3 platform values from the LMS tool registration into correct fields on Microsoft's **LMS provided registration keys** page. Hint: Check your LMS's documentation to find the correct place to get the registration values from your LMS. |
| 47 | +1. Select **Next**. |
| 48 | +1. Review the fields and values summarized on the **Review and add** page. |
| 49 | +1. If there are no errors, select **Save and exit**. |
| 50 | +1. When you see a message indicating successful registration, you've completed registration of the platform on the Microsoft LMS Gateway. |
| 51 | +You're now ready to continue configure common registration settings in the LTI® 1.3 tool in your LMS platform. |
| 52 | + |
| 53 | +## Configure common registration settings |
| 54 | + |
| 55 | +Every platform may have different options and steps for completing tool registration and adding placements for where the tool is launched within the platform. However, many common settings and steps are required to successfully deploy the app. |
| 56 | + |
| 57 | +1. Enable the tool to be available to both instructor (teacher) and learner (student) roles in the platform. |
| 58 | +1. Enable Deep Linking. |
| 59 | +1. Enable Names and Roles Provisioning Service (NRPS). |
| 60 | +1. Enable Assignment and Grading Services (AGS). |
| 61 | +1. Confirm that the Name, Email, and Username of the user that launches the tool will be sent to the tool in the privacy settings. |
| 62 | +1. Add the following custom parameters to be replaced by the platform at runtime. The LTI spec suggests the following variables be available, but platforms may have additional variables that are better suited based on definitions. |
| 63 | + |
| 64 | + | **Name** | **LTI/LIS Variable** | **Description** | **Example expression** | |
| 65 | + |---|---|---|---| |
| 66 | + | **t** | ResourceLink.title | Title of the resource lineItem (assignment) from the label property | t=$ResourceLink.title | |
| 67 | + | **dd** | ResourceLink.submission.endDateTime | Due date of the resource lineItem (assignment) from the endDateTime property | dd=$ResourceLink.submission.endDateTime | |
| 68 | + | **mp** | N/A | Maximum score possible for a lineItem submission form the scoreMaximum property | mp=$ResourceLink.lineItem.scoreMaximum | |
| 69 | + | **csid** | CourseOffering.sourcedId | Sourced ID for the course offering in the LMS | csid=$CourseOffering.sourcedId | |
| 70 | + | **ssid** | CourseSection.sourcedId | Sourced IDs for the course sections in the LMS | ssid=$CourseSection.sourcedId | |
| 71 | + |
| 72 | +1. Add the secure **Icon URL** from the tool values copied if the platform requires this URL to display an icon. |
| 73 | + |
| 74 | +## Add placements for the tool to launch from in the LMS platform |
| 75 | + |
| 76 | +The Teams Assignments LTI® tool implements both a Resource Launch and a Deep Linking launch using the same **Target link URL** that is used in the core registration. |
| 77 | + |
| 78 | +- **Resource Launch placement** - best used in a course context as a navigation menu item placement, or where course level resources are available to instructor and student member roles. |
| 79 | +- **Deep Linking Launch placement** - best used in a new assignment or content activity placement (external tool type of assignment/content) where the tool, when launched by an instructor, creates a resource link that can be launched from the assignments or content activity list by instructors and teachers. The tool also creates a lineItem and sends scores back to the LMS to sync into its gradebook as Teams Assignments are graded by the instructor. |
0 commit comments