FAQ content

LTI: Add the Automagic (Manual) 1.0 LTI Tool to Blackboard

In this article

The Automagic LTI tool allows you to embed content from your LibGuides site into Blackboard using matching vs. selecting content manually. A field from a Blackboard course is compared with the metadata added to LibGuides, and any resulting matches are displayed in the Blackboard course.

As with most instructions for other vendors' products, instructions may be a bit different, depending on the version of Blackboard you're using. The general idea of the thing should hold true, though:

  • First, you need to set up the Tool Provider as an approved provider.
  • Next, you need to set up the Placements: where in the system can folks use this tool?  

LibApps: Get the Configuration Information

The LibApps LTI Tool is available to CMS and E-Reserves subscribers. You must be a LibApps Admin to get the configuration information for your system.

You'll need to get your Blackboard admins the configuration information for the Automagic tool or create an account in one of your Springshare apps and make them a LibApps Admin.

  1. Go to the LibApps Dashboard.
    • Log in using your LibApps login URL, or
    • Log into any of your Springshare products, click the blue menu on the left, and choose LibApps.
  2. Go to Admin > LTI Tool Builder.
    • LibApps Admins can access this area. If you are on the LibApps dashboard and do not see an Admin menu, you are not a LibApps Admin.
  3. Click the View/Edit Tool () icon for the Version 1.0 Automagic tool.
getting to the configuration options for a version 1.0 automagic, part 1
  1. Go to the Configuration tab. Send your Blackboard admins the following fields:
    • LTI Launch URL
    • LTI Consumer Key
    • LTI Shared Secret

You do not need the Config URL for Blackboard.

getting to the configuration options for a version 1.0 automagic, part 2

When testing this setup, you'll need to make sure that you have your Automagic tool configured in LibApps / LibGuides. While your Blackboard admins are configuring things there, review the documentation and configure the tool / add some test metadata on the LibApps / LibGuides side as well.


Set Up the Tool Provider

  1. From the Blackboard Administrator Panel, select LTI Tool Providers.
  2. Select Register LTI 1.1 Provider.
  3. Fill out the form:
    1. Provider Domain Status Section:
      • Provider Domain: Your LTI Consumer Key
      • Provider Domain Status: Approved
    2. Default Configuration Section:
      • Default Configuration: Set Globally
      • Tool Provider Key: Your LTI Consumer Key
      • Tool Provider Secret: Your LTI Shared Secret
    3. Organization Policies Section:
      • Send User Data: Send user data only over SSL
      • User Fields to Send: Role in Course (Required for the selection screen to display for instructors / other course editors. Other fields are up to you.)
      • Allow membership service access: Yes
Blackboard Tool Provider form
  1. Click Submit.

Add Placements

The Placement allows you to set the Launch URL for the tool, which is required in order to use the tool.

  1. From the LTI Tool Providers page in Blackboard, open the menu for the tool you just added and choose Manage Placements.
  2. Click Create Placement.
  3. Fill out the placement information fields:
    • Label: Name as you'd like it to appear in the course options.
    • Handle: Unique identifier for the placement.
    • Availability: Set to "Yes" to make the placement available to course builders and instructors.
    • Type: Select the preferred type (Course Tool is recommended for the Automagic Tool).
  4. Fill out the tool provider information fields using the Automagic Tool information in your LibApps LTI Tool Builder settings:
    • Tool Provider URL: For this, use the LTI Launch URL provided in the LibApps LTI Tool Builder settings.
Placement form for adding Automagic tool
  1. Click Submit.

Add it to the Course Navigation

At this point, it's up to you whether you want to add it to all courses globally or allow each instructor to add it manually to their course's navigation.

Add Globally

  1. Go to System Admin > Course Settings > Course Menu and Structures.
  2. Click the + button and select Tool Link (in the upper left of the default menu on the screen).
    • Name: Whatever name you'd like to appear in the course menu.
    • Check off the Available to Users checkbox (if it isn't already checked).
    • Type: Look for the Label you gave it when you set up the Automagic Placement, and choose that.
    • Click Submit.
  3. Reorder the Automagic page wherever you'd like in the course menu structure.

Add in Individual Courses

If you would prefer to have the tool in the course nav be opt-in vs. opt-out, instructors / other course editors can add it to the navigation manually. They'd follow the same basic instructions as above: once in their course, click + > Tool Link, give it a name, select the Tool from the dropdown, and check off the Available to Users checkbox.

Adding the tool to the default course menu in Blackboard

Find the Tool in Blackboard

Once it's been added, you'll find the link in the navigation menu for each course.  

Example of where to find the Automagic tool link in the course navigation
Example of where to find the Automagic tool link in the course navigation