Often times it is helpful to place LTI-based links to Concourse in various places within the learning management system. The most common implementation is to insert Concourse as a part of the navigation for every LMS course. Then when a user clicks the link, they will be automatically logged on to Concourse and directed straight to the syllabus for the given course.
Another possible placement for general Concourse access is on the LMS main page or with the account area. This is beneficial, for example, when a student wants to preview a syllabus for a course which they are considering for a future semester or an administrator wants to log in to run a report. In this case the user will be logged in and placed at the Concourse homepage instead of being redirected to a syllabus.
*Note: For each access point (e.g. course navigation, account navigation, additional LMSs, etc.), we suggest using a different instance of an LTI consumer in Concourse. This gives you greater control over Concourse behavior and enhances security through unique key/secret pairs. There is no limit to the number of LTI consumers you may add to Concourse.
*Note: While it is likely that other LMS providers support similar configuration and options, we are currently unaware of documentation that describes how LTI extensions are implemented. Therefore, the remainder of this article will focus on the LTI extensions available in Canvas.
Instructure's Canvas LMS provides some powerful ways to quickly and easily place LTI apps into their environment using their external tools API. These extra capabilities are derived using XML to set additional configuration parameters when adding the tool to the LMS.
Below we will look at the XML for the most common case, inserting Concourse into course navigation within Canvas. The most important parameters to adjust include:
- launch_url: This should be set to https://yourdomain.campusconcourse.com
- title: The common name for the tool, likely "Syllabus"
- description: The extended description for the tool, such as "Concourse Online Syllabus System"
- options: The option to be configured
- property: The parameters that apply to the given option
This is the full snippet for configuring Concourse as a part of the course navigation. Other placement options will follow similar configuration parameters.
<?xml version="1.0" encoding="UTF-8"?>
xmlns:blti = "http://www.imsglobal.org/xsd/imsbasiclti_v1p0"
xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation = "http://www.imsglobal.org/xsd/imslticc_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticc_v1p0.xsd
<blti:description>Concourse Online Syllabus System</blti:description>
Feel free to review the complete API documentation for Canvas external tools.