Barnes & Noble College LTI Tool Last updated August 2016-1 - 8/1/2016
Contents Table of Contents 1.0 Introduction... 3 2.0 Key and Secret Request Form Link and Instructions... 3 3.0 Testing Link Connectivity with BNC... 5 4.0 System Level External Tool Configurations... 14 Setting Up Global Links... 14 Apply Purchase Course Materials LTI Link... 18 Apply Research and Adopt Course Materials LTI Link... 18 5.0 Link Authoring with a Course... 19 Research and Adopt Course Materials... 25 6.0 Authoring a URL Resource for Yuzu... 30 Creating a URL Access Digital Course Materials... 30 Creating a URL Learn About Digital Options* (optional)... 33 7.0 Important Notes and Troubleshooting... 36 I m getting an error when I try to launch the LTI link.... 36 How do I Set Role Logic at the Course Level so I can manage who sees what links?... 37 I am not able to successfully launch out of the LTI link I authored.... 37-2 - 8/1/2016
1.0 Introduction The purpose of this document is to provide details to an institution and the LMS administrator about how to integrate links within the Desire2Learn Learning Management System. References and screenshots to options in this user guide may differ on location based on the version of Desire2Learn the institution has installed. 2.0 Key and Secret Request Form Link and Instructions LMS Administrators will need to request a key and secret in order to successfully author links for courses in the LMS. Below are instructions on how to access and request a key and secret. Click or paste the link into your browser https://blti.bncollege.com/registration/consumer to access the Consumer Key and Secret Request form. The following fields are listed in the form and must be completed: Field Name LMS Type School Email First Name Last Name Phone Job Title CAPTCHA Description This drop down box displays a list of multiple LMS, Please choose which LMS your institution is using (example: Blackboard, Moodle, Canvas, etc.). This is a required field and must be filled in by a LMS Administrator. Enter your institution name in this field (example: Manhattan College). This is a free form text box with no character limits. This is a required field and must be filled in by a LMS Administrator. Please enter your school email address. An auto-generated email will be sent to this email address when the key and secret is created. Enter your first name in this field. Enter your last name in this field. Enter your phone number in this field. We recommend you also enter your job title. This will help the BNC Administrator know whom they are working with for communication purposes. CAPTCHA requires that the user type the letters and/or numbers of an image. This step is required and must be successfully completed before the key and secret form can be submitted for processing. - 3-8/1/2016
Once all the required fields including CAPTCHA are successfully filled out, click on the Submit button to process the key and secret request. Once the Key and Secret request has successfully been submitted, the system will direct you to a success page. Also, you will receive a confirmation email from the Barnes & Noble College LMS support team with steps on how to test the connectivity and further instructions to setup the LTI integration. - 4-8/1/2016
3.0 Testing Link Connectivity with BNC Once you receive the confirmation email with instructions explaining how to test the link, the testing process can begin. This test can be done prior to the key and secret being officially generated. Desire2Learn requires a key and secret to be entered to perform the connectivity test. You can place the text TEST in the both the Key and Secret field. The following steps describe how to test connectivity. Steps 1. Log into your Desire2Learn LMS with your username and password. Users will need to have LTI link authoring privileges. 2. Navigate to any active available course. Make sure the course is an actual course or if using a test course, please make sure it is formatted like an actual course. Launch requests should come from a course that has been properly set up using the established processes the school has implemented. To properly test the integration post-onboarding process, you will need to use a real course to ensure the cross-over to FacultyEnlight and the bookstore works properly. 3. Select a valid course. - 5-8/1/2016
4. In this user guide, we have listed all courses under Sandboxes. The LMS administrator will have created courses under the applicable template based on their institution need. 5. Click on Content in the header. - 6-8/1/2016
6. Click into the Add a module box and type in BNC Connectivity Test. 7. Press Enter. 8. The BNC Connectivity Test will now show up as a module in the left hand navigation. 9. Click on Edit Course in the upper right part of the screen. - 7-8/1/2016
10. Click on External Learning Tools under the Site Resources section. 11. Click on the blue New Link button. 12. Enter the following fields on the New Link page: Title: BNC Test Connectivity URL: https://blti.bncollege.com/lti/1.1/debug Visibility: Ensure that this is checked to allow users to view this link Key/Secret: Under the Signature section, ensure that the Sign messages with key/secret with option is checked and also ensure the radio button labeled; Link key/secret is selected. Key: Enter TEST Secret: Enter TEST - 8-8/1/2016
Security Settings: Ensure all check boxes are selected/enabled with a check mark under this section. Make link available to: Ensure that the appropriate Org Unit is selected. The user can manage this by clicking into the Add Org Units button. 13. Once all the data has been entered, click Save. 14. You will now be taken to the Manage External Learning Tool Links page. You will now see that you successfully created a link called BNC Connectivity Test. 15. The LMS Administrator should now click on the Content link to be taken back to the course level page. - 9-8/1/2016
16. Click on the Add Existing Activities drop-down arrow and select External Learning Tools. - 10-8/1/2016
17. A window for External Learning Tools will populate. Click on BNC Connectivity Test. 18. The screen will refresh and the LTI link will populate in the center of the screen. - 11-8/1/2016
19. Click on the BNC Connectivity Test link in the middle of the screen. 20. You will see the LTI Parameters page launch. Schools that have multi-section/cross-listed courses need to send multiple connectivity tests. One connectivity test should be sent for each type of course (individual, multisection, cross listed, multi-section/cross listed.) If you have trouble submitting your connectivity test, send a screenshot to ltisupport@bncollege.com. - 12-8/1/2016
The LMS Administrator will need to click on the link Send LTI Parameters to Barnes Noble College. The LMS Administrator will enter their email address, school name and any message they want to BNC administrator to see. When ready to send to the BNC administrator, they should click Submit. This will send a request to Barnes & Noble College and help us ensure no connectivity issues exist between Barnes & Noble College and the school LMS server. The LMS Administrator will receive a success message letting them know it was submitted successfully. Upon receiving your success message, please email ltisupport@bncollege.com with your school terms codes. For example: SP15 = Spring 2015-13 - 8/1/2016
Once the information is received we will process your request and send you a Key and Secret via email, which you can use to install our LTI integration. 4.0 System Level External Tool Configurations In order to set up a system-level external tool configuration within Desire2Learn, you will need to follow the steps below. In addition, you will need to add the LTI integration at the course level in your master template. The system-level configuration can also be used if your school plans on giving faculty the option of adding the integration themselves at the course level later. Log into your Desire2Learn LMS with your username and password. The user needs to have LTI link authoring privileges. In this section, the LMS Administrator will create two external tools to facilitate link authoring at the global level. Setting Up Global Links - 14-8/1/2016
Steps 1. Sign in to Desire2Learn with your username and password. (Users will need to have LTI link authoring privileges) 2. Click on the gears icon in the top right corner of the screen. 3. Under the Organization Related section, click on the External Learning Tools link. - 15-8/1/2016
4. Click on the blue New Link button. You will be taken into the New Link page. In this section, you will author one global link for Purchase Course Materials and another global link for FacultyEnlight. You need to author one link at a time. Enter the following information for Purchase Course Materials and FacultyEnlight: Purchase Course Materials: Title: Purchase Course Materials URL: https://blti.bncollege.com/lti/1.1/launch/bn_wcs Visibility: Ensure that this is checked to allow users to view this link. Key/Secret: Under the Signature section, ensure that the Sign messages with key/secret with option is checked and also ensure the radio button titled; Link key/secret is selected. Key: Enter the system generated Key that was sent to you in an email from Barnes & Noble. Secret: Enter the system generated Secret that was sent to you in an email from Barnes & Noble. Security Settings: Ensure all check boxes are selected/enabled with a check mark under this section. Make link available to: Ensure that the appropriate Org Unit is selected. The user can manage this by clicking into the Add Org Units button. Research and Adopt Course Materials: Title: Research and Adopt Course Materials URL: https://blti.bncollege.com/lti/1.1/launch/bn_fe Visibility: Ensure that this is checked to allow users to view this link Key/Secret: Under the Signature section, ensure that the Sign messages with key/secret with option is checked and also ensure the radio button labeled; Link key/secret is selected. Key: Enter the system generated Key that was sent to you in an email from Barnes & Noble. Secret: Enter the system generated Secret that was sent to you in an email from Barnes & Noble. - 16-8/1/2016
Security Settings: Ensure all check boxes are selected/enabled with a check mark under this section. Make link available to: Ensure that the appropriate Org Unit is selected. The user can manage this by clicking into the Add Org Units button. - 17-8/1/2016
5. Once all the information is entered for the first global link that you are authoring, click Save. You will be taken back to the Manage External Learning Tools Link page. You will see the link you authored. 6. Go back and repeat the same steps to author your other link. 7. Once both links are authored, click on the My Home link. 8. Click back into the specific course you want to apply the global links. 9. Click on the Content link. Apply Purchase Course Materials LTI Link To apply the Purchase Course Materials LTI link: Step 1. Click into the Course Materials Module. 2. Click on the Add Existing Activities drop-down arrow. 3. Click External Learning Tools. 4. Choose Purchase Course Materials. 5. You will see the LTI link populate in the center of the screen. Apply Research and Adopt Course Materials LTI Link To apply the FacultyEnlight LTI link: Step 1. Click into the Research and Adopt Course Materials Module. - 18-8/1/2016
Step 2. Click on the Add Existing Activities drop-down arrow. 3. Click External Learning Tools. 4. Choose Research and Adopt Course Materials. 5. You will see the LTI link populate in the center of the screen. The user can now launch the pages using the LTI links that are in place. 5.0 Link Authoring with a Course This section details the step-by-step process to link authoring within a specific course. The LMS administrator or a Faculty member will create two LTI links within the course. Purchase Course Materials will facilitate students to seamlessly connect to their College bookstore website and purchase course materials assigned for the class. Research and Adopt Course Materials will enable faculty to connect with the online adoption website FacultyEnlight where they can research and adopt course materials and submit their request directly to bookstore. Creating a Module - Course Materials Steps 1. Click into the course that you need to link author. 2. Click on Content. 3. Click into the box that states Add a module - 19-8/1/2016
4. Type in Course Materials and click Enter. Steps Notice that Course Materials is now under Table of Contents in the left hand part of the screen. You are now ready to author a LTI link at the course level. 5. To link author at the course level, click Edit Course. 6. Click on External Learning Tools. - 20-8/1/2016
Steps 7. Click on the blue New Link button. 8. You will now be taken to the New Link page. Enter the following fields: Title: Purchase Course Materials URL: https://blti.bncollege.com/lti/1.1/launch/bn_wcs Visibility: Ensure that this is checked to allow users to view this link. Key/Secret: Under the Signature section, ensure that the Sign messages with key/secret with option is checked and also ensure the radio button titled; Link key/secret is selected. Key: Enter the system generated Key that was sent to you in an email from Barnes & Noble. Secret: Enter the system generated Secret that was sent to you in an email from Barnes & Noble. Security Settings: Ensure all check boxes are selected/enabled with a check mark under this section. Make link available to: Ensure that the appropriate Org Unit is selected. The user can manage this by clicking into the Add Org Units button. - 21-8/1/2016
Steps - 22-8/1/2016
9. Once all information has been entered, click Save. You will now see the Purchase Course Materials in the Manage External Learning Tools Link page. 10. To apply this link at the course level, click on Content. The URLs in the screenshot above will not reflect the production URL information listed in the steps above. This screenshot is for navigation purposes only. 11. You will be taken back to the course page. Ensure you are in the Course Materials module. 12. Click on the Add Existing Activities drop-down arrow and select External Learning Tools. - 23-8/1/2016
13. Click on the Purchase Course Materials LTI link. 14. Notice that the LTI link has now been added to the Course Materials Module. To launch the page, click on the Purchase Course Materials LTI link. The URL will open. - 24-8/1/2016
Research and Adopt Course Materials Steps 1. Click into the course that you need to link author. 2. Click on Content. 3. Click into the box labeled Add a module 4. Type in Research & Adopt Course Materials and click enter. - 25-8/1/2016
5. Notice that Research & Adopt Course Materials is now under Table of Contents in the left hand part of the screen. You are now ready to author a LTI link at the course level. 6. To link author at the course level, click Edit Course. - 26-8/1/2016
7. Click on External Learning Tools. 8. Click on the blue New Link button. You will now be taken to the New Link page. Enter the following fields: Title: FacultyEnlight URL: https://blti.bncollege.com/lti/1.1/launch/bn_fe Visibility: Ensure that this is checked to allow users to view this link Key/Secret: Under the Signature section, ensure that the Sign messages with key/secret with option is checked and also ensure the radio button titled; Link key/secret is selected. Key: Enter the system generated Key that was sent to you in an email from Barnes & Noble. Secret: Enter the system generated Secret that was sent to you in an email from Barnes & Noble. Security Settings: Ensure all check boxes are selected/enabled with a check mark under this section. - 27-8/1/2016
Make link available to: Ensure that the appropriate Org Unit is selected. The user can manage this by clicking into the Add Org Units button. 9. Once all information has been entered, click Save. You will now see the FacultyEnlight in the Manage External Learning Tools Link page. 10. To apply this link at the course level, click on Content. - 28-8/1/2016
The URLs in the screenshot above will not reflect the production URL information listed in the steps above. This screenshot is for navigation purposes only. 11. You will be taken back to the course page. Ensure you are in the Research & Adopt Course Materials module. 12. Click on the Add Existing Activities drop-down arrow and click on External Learning Tools. 13. Click on the FacultyEnlight LTI link. Notice that the LTI link has now been added to the Research & Adopt Course Materials module. 14. To launch the page, click the FacultyEnlight LTI link. The URL will open. - 29-8/1/2016
6.0 Authoring a URL Resource for Yuzu This section details the step-by-step process to author a URL resource for Yuzu within a specific course. The LMS administrator or a Faculty member will create two URLs within the course. Access Digital Course Materials will help students organize read and annotate their reading right in the palm of their hand. Learn About Digital Options* will enable faculty to connect with Yuzu, which is an online ecosystem that enables the collaborative, free flow of information between learners and educators, making it easier than ever to teach, learn, discover and digest. *Optional Creating a URL Access Digital Course Materials Steps 1. Click into the course that you need to link author. 2. Click on Content. 3. Click into the Course Materials module. - 30-8/1/2016
Steps 4. Click on the blue New button. 5. Select the Create a Link option. - 31-8/1/2016
Steps 6. In the Title field in the New Link window, enter Access Digital Course Materials. 7. In the URL field, enter the following URL: http://www.yuzu.com/ 8. Ensure that the Open and External Resource checkbox is selected. 9. Click the Create button. You will now be taken to the URL page you created. 10. Click on the Content link. - 32-8/1/2016
Steps You will see that the Access Digital Course Materials URL is now under the Course Materials module. The user can click on the link and launch the site. Creating a URL Learn About Digital Options* (optional) Steps 1. Click into the course that you need to link author. 2. Click on Content. 3. Click into the Research & Adopt Course Materials module. - 33-8/1/2016
4. Click on the blue New button. 5. Select the Create a Link option. Steps 6. In the Title field of the New Link page, enter Learn About Digital Options. 7. In the URL field, enter the following URL: https://www.facultyenlight.com/#learn-aboutyuzu 8. Ensure that the Open and External Resource checkbox is selected. 9. Click the Create button. You will now be taken to the URL page you created. - 34-8/1/2016
Steps 10. Click on the Content link. You can see the Learn About Digital Options URL is now under the Research & Adopt Course Materials module. The user can click on the link and launch the site. - 35-8/1/2016
Steps 7.0 Important Notes and Troubleshooting This section contains troubleshooting help for common issues. I m getting an error when I try to launch the LTI link. When doing a copy and paste of the launch URLs, key or secret from the emails, sometimes white spaces get picked up in the copy and paste feature. If this happens, a user could receive a 403 error screen or a message that the key and secret must be provided. The best way to resolve this is to take the launch URL, key and secret and paste it into a text pad. This will eliminate any whitespaces. A user can then take the data from the text pad and copy back into LMS. - 36-8/1/2016
How do I Set Role Logic at the Course Level so I can manage who sees what links? You only need to apply role logic to the modules that teachers have access to. Click on the course you want to access Click on the module you want to set role permissions Click on the line that says "Add dates and restrictions..." Under Release Conditions, click on Create button Under Condition Type, under Classlist, click on "Role in current org unit" Under the role drop down box, click on Instructor Click on the Update button You will get a message that Role was updated Successfully I am not able to successfully launch out of the LTI link I authored. The following table describes several ways to troubleshoot this common issue. Step 1. Ensure that the following URLS are listed in both the Launch URL and the Secure Launch URL for Purchase Course Materials and Research and Adopt Course Materials (ensure there are no whitespaces): https://blti.bncollege.com/lti/1.1/launch/bn_fe https://blti.bncollege.com/lti/1.1/launch/bn_wcs 2. Ensure the key and secret that was pasted in the Consumer Key field has no white spaces. Sometimes when a copy and paste is done, whitespaces are picked up. 3. Ensure the URL launches a new window. - 37-8/1/2016