Blackboard: LTI 1.3 Tool Configuration
Helpful Not Helpful
Question
How do I configure the LTI 1.3 tool for Sage Vantage in Blackboard? 


Solution

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

 

Some configuration information is provided 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.

 

 

  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.

    This image shows the Integrations section of the Blackboard Admin tools page. In the list of actions available in the Integrations section, LTI Tool Providers is highlighted.

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

    This images shows the LTI Tool Providers page. The "Register LTI 1.3 / Advantage Tool" option is highlighted.

  3. You will be asked to enter a Client ID. Sage will provide this information to you. Paste the Client ID you are given into the text field. Next, click Submit found on the lower right of the page to continue.

    This image shows the "Register LTI 1.3 Tool" page. It contains the Client ID text field where the Client ID you receive from Sage will be pasted.

  4. 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.

      Graphical user interface, text, application, email

Description automatically generated

    2. 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:

      1. Role in Course
      2. Name
      3. Email Address

        This image shows the checkboxes ticked for the User Fields to Send: Role in Course, Name, Email Address.

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

      This image shows the "Yes" radio buttons selected for Allow Grade Service Access and Allow Membership Service Access.

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

  5. 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. Click the Menu icon then select Manage Placements from the available options.

    This image shows the context menu for the Sage Vantage tool opened. Manage Placements is highlighted.

  6. Select the link to Create a Placement. Complete the following fields as indicated:

    In this image, the Create Placement button is highlighted.

    1. Label: Name the label Sage Vantage.

      This image shows the Create Placement page. Under the Placement Information section, the first field is the Label where Sage Vantage has been entered.

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

      This image shows the Handle field where sage_vantage is entered.

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

      This image shows "Availability" with the "Yes" radio button selected.

    4. : Select the Deep Linking content tool radio button. Be sure to click the Allow student access checkbox.

      This image shows the "Type" settings when using Blackboard Learn SaaS. The radio button for "Deep Linking content tool" is selected. Underneath it, the "Allow student access" checkbox is ticked.: Tick the checkbox to enable this option.

      This image shows a tick in the checkbox for "Launch in New Window."

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

      This image shows the "Tool Provider URL" text field populated with the URL provided by Sage.

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

      This image is a quick overview highlighting the areas on the page where your selections will be made.

  7. 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.
    1. Original Course View

                                                         i.            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.

This image highlights the context menu for Build Content. The Sage Vantage tool is noted in the list of available tools.

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

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

The 400 - BadRequest error reads: "Message: Your learning management system email [your_email@school.edu] does not match an existing account in Sage Vantage. Please contact collegetechissues@sagepub.com so that our support team can create or merge your accounts." It tells you that Vantage has authenticated and is looking for a valid instructor account rather than an Admin account.

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.


    1. Ultra Course View

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

This image shows the default Ultra course view with no content built. The "+" icon is highlighted which is where you will start building your Vantage course links.

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.

This image highlights the "Books & Tools" section in the left navigation.

                                                       ii.            In the content menu, select Content Market.

This image shows the context menu after clicking the "+" icon. The Content Market option is highlighted.

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

This image shows the Content Market page. Institution Tools are grouped at the bottom of the page. You will select your Sage Vantage tool (highlighted in this image) from this area.

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

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

        The 400 - BadRequest error reads: "Message: Your learning management system email [your_email@school.edu] does not match an existing account in Sage Vantage. Please contact collegetechissues@sagepub.com so that our support team can create or merge your accounts." It tells you that Vantage has authenticated and is looking for a valid instructor account rather than an Admin account.

        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.


Share