The GoOpenVA  LTI Tool is currently incompatible with Safari. We recommend using the LTI with Chrome or Firefox while we work to fix this. We apologize for the inconvenience.

Overview

The GoOpenVA LTI tool allows educators to embed GoOpenVA content within any Learning Management System that supports LTI 1 or 1.1. It has currently been fully tested for Quality Assurance in Canvas, Moodle, Blackboard,  and Schoology.

Content Selection

The LTI tool allows any educator to browse and embed media objects alongside other content within assignments, or select content which comprises entire modules, lessons, or units. All users are able to search content added to GoOpenVA Collections. Additionally, users can also able to browse or search content from Group Shared Folders and personal My Items libraries, if that content has been configured and made available. 


Authentication and Account Provisioning

The tool provides automated authentication and new account provisioning, providing users with an "SSO like" experience. The LTI key/secret pair can also be configured to automatically add new users to an GoOpenVA Group.

LTI Tool Preview Images

Some basic preview images of the tool have been included below. More details about using the LTI tool are available in the "Using the LTI tool" section of this guide.  

This is a screenshot showing what browsing  GoOpenVA Collections looks like in the LTI tool.

This is a screenshot showing what browsing My Items looks like in the LTI tool.


This is a screenshot showing what browsing Group folders looks like in the LTI tool.




Getting Set up in Blackboard

Get Your LTI Credentials 

Contact goopenva@doe.virginia.gov for your LTI Credentials.

If you would like to configure access to a specific GoOpenVA Group you have created, please specify that in your email.  

Installing and Configuring the App in Blackboard

Add GoOpenVA LTI tool provider

  1. On the Administrator Panel, select LTI Tool Providers.

  2. Configure Provider Domain Status

    1. Enter goopenva.org in the Provider Domain textbox.

    2. Set Provider Domain Status to “Approved”

  3. Default Configuration

    1. Select “Set Globally”

    2. Enter the Key and Secret you received from goopenva@doe.virginia.gov

  4. Configure Institution Policies

    1. Select “Send User Data only over SSL”

    2. User Fields to send should include Role in Course and Email Address 

      1. *Note: If you don’t allow sending email address you will need to manually log in with a username and password every time you use GoOpenVA

  5. Click “Submit” 

Add GoOpenVA LTI Placement

  1. From the LTI Tool Providers page, open the Tools menu and select “Manage Placements”

  2. Select “Create Placement”

  3. Configure Placement Information

    1. Enter a Label. This is the name that appears to users in a course.

    2. Enter a Handle. This must be a unique ID for the tool which can only contain alphanumeric, underscore, or dash characters. 

    3. Set Availability to “Yes”

    4. Set Tool Type to “Content Type” tool

    5. Select “Build Content (Create)” 

  4. Configure Tool Provider Information

    1. Enter the Launch URL ( https://goopenva.org/lti/launch) in the Tool Provider URL input box

    2. Enter the Key and Secret you received from  goopenva@doe.virginia.gov

    3. Click “Submit” 


Troubleshooting and Technical Documentation

The GoOpenVA LTI Tool Provider conforms to the IMS LTI 1.1 Standard: https://www.imsglobal.org/specs/ltiv1p1/implementation-guide


We also support Content Item Message Extension, or Deep Linking: https://www.imsglobal.org/specs/lticiv1p0

Required Parameters

The following parameters must be present in LTI launch request sent by the Tool Consumer

  • One of the following content identification parameters:

a.) resource_link_id (alphanumeric GUID)

b.) custom_redirect_url (full URL pointing to content on the GoOpenVA platform, used in manual config only)

  • tool_consumer_instance_guid

  • role

  • email

  • userid

*If parameters do not conform exactly to the parameters listed above, the LTI tool will return a missing parameter error.

Optional Parameters

  • launch_presentation_return_url

If this parameter is present it will be used to redirect a user when a resource is selected in the picker interface. Otherwise, user is redirected to the specified GoOpenVA content page.

Error Messages

If the cause of the error is known, the LTI tool will return an error message with debugging information. The most common cause of errors is missing LTI parameters.