As an LMS Admin, how do I configure the LTI 1.3 tool in Blackboard for Sage Vantage?

Modified on Fri, 1 Nov, 2024 at 2:42 PM

TABLE OF CONTENTS

Overview

This guide walks Blackboard administrators through the LTI 1.3 tool configuration to integrate Vantage with Blackboard so instructors are able to create deep links and grade syncs between Vantage and their LMS course.

This process covers the LTI 1.3/Advantage configuration for Blackboard version 3700.11.x or higher.


Some configuration information is provided first to you by Sage:

  • Your Sage Technical Implementation Specialist will provide these details using a privnote link (https://privnote.com/).
  • Please note that this link can be opened once. When you close the page, the contents of the privnote will be destroyed.
  • Once you open the privnote, we recommend storing a copy of this information for your records.


Setting up the LTI 1.3/Advantage Tool

1. Log into your Blackboard LMS as an Administrator. Next, go to the Administrator Tools page. In the Integrations section, select LTI Tool Providers to begin.


LTI Tool Providers appears about halfway down the Integrations list.


2. On the LTI Tool Providers page, select Register LTI 1.3/Advantage Tool.


Register LTI 1.3/Advantage Tool is one of a few options.


The Client ID

You will be asked to enter a Client ID in the Administrator Panel. Sage will provide this information to you. 

  • Paste the Client ID you are given into the text field.
  • Select Submit found on the lower right of the page to continue.


Beneath Register LTI 1.3 Tool you are prompted with the Client ID field.

LTI Settings

You will be taken to the Accept LTI 1.3 Tool page which will allow you to review settings for the tool's setup. Make note of the required settings outlined below to ensure that your Sage Vantage tool will function correctly.

  1. Tool Status: This information is pre-filled based on the default settings for the tool. Change the Tool Status to Approved to allow the LTI connection to work.

The Tool Status radio button is at the bottom of the screen.


b. User Fields to Send: These fields are listed under the "Institution Policies" section. This information is used to identify students in Vantage. Make sure that the checkbox for each of these items is ticked:


  • Role in Course
  • Name
  • Email Address


c. Allow grade service access and Allow Membership Service Access: Select the Yes radio button for both items to enable the grade sync functionality.


d. Make a final review of the settings for accuracy. Next, choose Submit found on the lower right of the page to complete the tool setup. 


 

Manage Placements in the LTI Tool Providers

Find the Sage Vantage tool in the alphabetized list of tools. Hover your mouse over the tool name so its Menu icon will appear to the right. Select the Menu icon then select Manage Placements from the available options.

When you choose Sage Vantage, a drop-down menu carrot appears and from the list you can choose Manage Placements.


Select the link to Create a Placement

Complete the following fields as indicated: 


a. Label: Name the label Sage Vantage.

You will need to key "Sage Vantage" into the open field.


b. Handle: Use a unique value such as sage_vantage.

 

Key in the unique value into the open field.


c. Availability: Select Yes so that course builders and instructors can use the tool.


Select the Yes radio button.

d. Select the Deep Linking content tool radio button. Be sure to select the Allow student access checkbox.

The Allow student access checkbox is below the radio button.


Tick the box to Launch in a New Window.


e. Tool Provider URL: Fill in this text field with the URL provided by Sage.

 
The Target Link URL is a required field to complete.


f. Make a final review of the settings for accuracy. Next, click Submit found on the lower right of the page to complete the placement.


The Submit button is at the bottom right of the screen.


Completing Configuration


We recommend that you attempt to add a link to Vantage in a sandbox course to confirm the tool configuration is working. The steps to add a link are different depending on whether you have Original or Ultra view. 


Original Course View

Navigate to the Content Area in your course where you would like to place your links. Under Build Content, look for the Sage Vantage tool and select it. 


The Sage Vantage Production tool may appear near the bottom of the Build Content screen.


You should see the following error message that you do not have a valid Vantage account:

"Message: Your learning management system email [[email protected]] does not match an existing account in Sage Vantage. Please contact [email protected] so that our support team can create or merge your accounts." 


The Error: 400 - BadRequest message is actually an indication that you have correctly configured Canvas to Vantage.

Seeing this error indicates you have authenticated into Vantage to the point where it is doing a user check. Since the user check is looking for an instructor account, this message indicates the configuration is correct.


Ultra Course View

Navigate to to the Content Area in your course where you would like to place your links. Select the plus sign to begin. 



Note: You can also look under "Books & Tools" in the left navigation, then click the View course & institution tools link. You may then need to click "Browse available partners" or "Browse all course tools" to find the Sage Vantage tool. Both options will take you to the Content Market.

The Books & Tools icon is a wrench.


In the content menu, select Content Market.

The Content Market icon is a shopping cart.



Scroll down to the Institution Tools section at the bottom of the page. Look for the Sage Vantage Production tool and select it. If you don't see the tool, you may need to select Find More to locate it.

 


You should see the following error message that you do not have a valid Vantage account:

"Message: Your learning management system email [[email protected]] does not match an existing account in Sage Vantage. Please contact [email protected] so that our support team can create or merge your accounts." 



Seeing this error indicates you have authenticated into Vantage to the point where it is doing a user check. Since the user check is looking for an instructor account, this message indicates the configuration is correct.

 


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article

Don't see what you're looking for?

CONTACT SUPPORT