This article is about playing external content in aNewSpring via LTI 1.3. If you want to play external content in aNewSpring via LTI 1.1, then read this article.

LTI stands for Learning Tools Interoperability. It allows you play courses built in one learning system in another learning system.


What roles do you need?

Tenant: to create and manage the LTI 1.3 configuration.

Designer: to create and set up the external activity in the template.


1) Create a LTI 1.3 configuration

Creating a LTI 1.3 configuration requires actions from aNewSpring and the tool provider (the external system from which you are going to play content in aNewSpring).

In order to connect to an external system and play external content in aNewSpring, it is necessary to create a LTI 1.3 configuration.

Tenants can create a new LTI 1.3 configuration via the tab of the learning environment. To do this, click the button in the LTI 1.3 Configurations screen.

To play external content in aNewSpring, an LTI 1.3 configuration must be created via the LTI Platform tab. Click this tab and then click the button to create a new LTI configuration:



Give the LTI configuration a name and fill in the Public Keyset URL and Initiate Login URL.
Then click Create and show settings. You now have access to the Platform settings that are automatically created such as: Client ID, Deployment ID, Issuer, Access Token URL, Authentication Request URL, Public Keyset URL.

The Public Keyset URL and Initiate Login URL information should be provided by the tool provider.



This data should be shared with the external tool whose content you will play in aNewSpring, so the LTI configuration can be further set up on the side of the external system and the creation of the LTI configuration can be completed.

Once the configuration has been created with the correct data, a secure connection can be made between both platforms.
You can now continue with setting up an external activity in the template.


2) Add an external activity to the template

Via the tab, clicknext to the template in which you want to add an external activity to play content from another system in aNewSpring.

Under the Template tab, clickand choose External Activity here. Then click .


3) Select the LTI configuration

Fill in the LTI link and check the box This is a link to a LTI tool provider. You can then choose whether it is an LTI 1.1 connection or an LTI 1.3 connection. In this case you choose LTI 1.3.

After selecting the LTI 1.3 option, two fields will appear that can be filled in: LTI tool configuration and Custom parameters:



Under LTI tool configuration, select the LTI configuration you want to use for this activity. Here you will find all configurations that the tenant created on the Settings page of the learning environment.

When showing the LTI configurations in the drop-down menu, only the LTI configurations of the subenvironment to which the template is linked are shown.

If you want to use custom parameters, you can add them in the field Custom parameters .

Do you have several custom parameters? Then, after each custom parameter, place an enter so that they are displayed one below the other. Do not use commas to seperate them, but add them to the field like this:

CustomParameter1=CodeX
CustomParameter2=CodeY


3) Configure the external activity

The following settings depend on your situation. We will explain them one by one.

Send the admin role to the tool provider

The data sent via LTI includes the user's roles. If the user has the administrator role in aNewSpring, tick this box if you also want to include that role in the data that is sent.

Show 'Continue' after completion

When learners start with the activity, they will see a 'Continue' button in the bottom right of their screen. This might be distracting for the learner, especially on mobile devices. By enabling this option, you can hide the 'Continue' button until the LTI activity is completed.

Do you use GoodHabitz?

The option 'Base the completion of this activity on progress' is made for use with GoodHabitz. In most cases, the LTI provider only sends a score. GoodHabitz can also send information about the progress. For example, if a learner stops halfway through the activity, they will see a progress of 50%.
Select the percentage at which aNewSpring will consider the activity as completed.

Do not check Base the completion of this activity on progress if you are using the link in GoodHabitz specifically for an assessment or test. In that case a score will be given instead of the progress. If the learner passes the test, GoodHabitz will send 1.0, otherwise they will send 0.0.

Launch in a pop-up

When you enable this option, the LTI provider will be played in a pop-up. You can then also decide the size of the frame. If you decide to determine the frame size by percentages, the size of it will be based on the screen size of the learner.

If LTI is not launched in a pop-up, the learner cannot do the activity again once it is completed. Once a score is sent, the learner sees a results page showing their score.

Enable this option if you want learners to be able to do the activity again, even after they completed it and got a score.

If completion is based on progress (which is the case when using GoodHabitz), learners can always start the activity, even if it does not launch in a pop-up.

It is possible to use LTI to play a learning journey made in another aNewSpring environment. In that case, we suggest to use 'Launch in pop-up'. This makes sure that learners are not confused by seeing the same navigation twice.


4) Showing a score and configuring threshold

The LTI standard defines that after completion, a score between 0 and 1 is sent.
If a score of 0.8 is sent, we interpret it as 80%.

Once a score is sent, it is visible in the results overview.

If you want to configure a threshold, enable the option Assessment possible in combination with Manually set score. In the example below, the threshold is set to 80%. The activity thus receives the status 'Passed' when a score of at least 0.8 is sent.

Should the learner complete the LTI activity again and achieve another score, the score for the activity is updated. This might change the status the status of the activity from 'Failed' to 'Passed'. The option Activity can be reassessed has no influence on this.