Admin – one time process

General

This is a one-time step, in which you create a new “External App” in Canvas.

The “External App” holds the details of your Leganto account.

Three parameters were generated after you created the LTI Integration Profile in Alma.

You will be asked to supply these parameters when creating the “External App”.

Create a new “External App”

Navigate to your account => Settings => App.

Select “Add App”.

Paste XML

Select the “Paste XML” option.

Enter the following four values.

1) Name – To expose to whomever creates the future link in the course.

2) Consumer Key – The LTI key from the integration profile.

3) Shared Secret – The LTI secret from the integration profile.

4) XML Configuration – Copy the below XML, and place the Launch URL from the integration profile where marked in bold.

<cartridge_basiclti_link
  xmlns="http://www.imsglobal.org/xsd/imslticc_v1p0"
  xmlns:blti="http://www.imsglobal.org/xsd/imsbasiclti_v1p0"
  xmlns:lticm="http://www.imsglobal.org/xsd/imslticm_v1p0"
  xmlns:lticp="http://www.imsglobal.org/xsd/imslticp_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 http://www.imsglobal.org/xsd/imsbasiclti_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imsbasiclti_v1p0p1.xsd http://www.imsglobal.org/xsd/imslticm_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticm_v1p0.xsd http://www.imsglobal.org/xsd/imslticp_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticp_v1p0.xsd">
  <blti:title>Leganto</blti:title>
  <blti:description></blti:description>
  <blti:launch_url><![CDATA[https://leganto.exlibrisgroup.com/lti/launch?institute=1_INST&tool=LMS_CANVAS_1]]></blti:launch_url>
  <blti:custom></blti:custom>
  <blti:extensions platform="canvas.instructure.com">
    <lticm:property name="tool_id">exlibris_leganto</lticm:property>
    <lticm:property name="domain">exlibrisgroup.com</lticm:property>
    <lticm:property name="privacy_level">anonymous</lticm:property>
    <lticm:options name="post_only">true</lticm:options>
    <lticm:options name="course_navigation">
        <lticm:property name="default">enabled</lticm:property>
        <lticm:property name="visibility">public</lticm:property>
    </lticm:options>
 </blti:extensions>
</cartridge_basiclti_link>

Course Navigation

The example above is configured to display the link in the course navigation panel.
You can decide instead to display this link in Account navigation or User Navigation, or not at all.
The relevant configuration for this in the above XML is:

enabled public

Possible values for visibility are: ‘public’, ‘members’, and ‘admins’.
This specifies what types of users can see the link in the course navigation.
“public” means anyone accessing the course.
“members” means only users enrolled in the course.
“admins” means only teachers, TAs, designers, and account admins.

For more on this see: https://canvas.instructure.com/doc/api/file.navigation_tools.html

NOTE: If you decide to keep the course navigation in place, the link appears automatically for all courses. In this case, there is no need to create an additional link for each course, as described in “Create a Leganto Link in a Course “.

The course navigation looks like this (The tool name in this case is “Reading List”):

5) Select “Submit”.

Add Custom Field

Edit the newly created “App”.

Add the following custom fields:

lis_user_username=$User.username

canvas_masq=$Canvas.masqueradingUser.id (optional, used to detect “Student View”. If “Student View” is used when clicking the LTI link, an error message will be displayed. You can configure the text of the message under this leganto label: lti.user.error.studentView)

select “Submit”.

Course Code Field Name

The course code is passed using the context_label parameter. You will need to add this as a field in Alma’s “Integration Profile”.

Place the value context_label in the ‘Course Code Field Name’ field.

For Banner users

For users which are using the Banner ERP, there might be some exceptions to the above.

If the integration is not workingfor you, try the following changes

  • In the “Add Custom Field“, use the following fields instead of what is documented:
    • lis_user_username=$Person.sourcedId
    • lis_course_id=$Canvas.course.sisSourceId>
  • In the “Course Code Field Name“, leave the field blank, and do not use the value context_label

       

You Are Done

You are now ready to create a Leganto Link in a Course.