LTI Tool Admin Guide D2L - 1 -
Contents Introduction... 3 About the Bookstore Website... 3 About FacultyEnlight... 3 About Yuzu... 3 Getting Started - Requesting Credentials from Barnes & Noble College... 4 Testing Link Connectivity with Barnes & Noble College... 5 System-Level External Tool Configuration... 7 Setup for Purchase Course Materials Link... 7 Setup for Research and Adopt Course Materials Link... 8 Adding the Bookstore Links to the Navbar... 8 Authoring a URL Resource for Yuzu... 12 Course-Level Setup of Access Digital Course Materials Link... 12 Optional System-Level Setup of Learn About Digital Options Link... 12 Going Live... 14 Important Notes and Troubleshooting... 14 Error Messages... 14 Pop Ups Blocked... 14 Other Issues or Concerns Contact Us... 14-2 -
Introduction The purpose of this document is to provide details on how to integrate Barnes & Noble College links within the Brightspace by D2L learning management system. This guide is intended for the D2L administrator or instructional designer who will configure the LTI tools. This LMS integration simplifies the textbook purchase process for students, showing them the required and recommended materials for their course. It also streamlines the textbook adoption process for faculty, allowing them to select the course materials for their courses more easily. Once setup is complete, a link will be available within all courses, which will allow students to view and purchase their course materials on the bookstore website for their specific course, when coming from D2L. Students will have their bookstore account paired with their Brightspace user ID, eliminating the need to log in again when using these links in the future. Students will land directly on a page showing their section-specific course materials, along with available formats and pricing options. An additional optional LTI link allows faculty to log into FacultyEnlight and pair their user ID to their FacultyEnlight account. After creating an account or signing in, their account will be paired with D2L, eliminating the need to log in when selecting this link in the future. Additionally, the faculty s course information will be automatically populated in FacultyEnlight, saving them this step in the process when submitting their course material selections to the bookstore. About the Bookstore Website The official bookstore website is the online presence for your campus bookstore. Students can find all their required and recommended course materials for their courses, and can save up to 60% by choosing used, rental, or digital formats. Our Price Match program ensures students get the best prices available. Additional materials such as school supplies, apparel, and accessories are also available. Students can check out securely online using any form of tender, including financial aid and campus debit. About FacultyEnlight FacultyEnlight (https://facultyenlight.com/) is a digital platform for faculty and staff that enables them to research and adopt course materials in one, convenient place. Faculty may compare estimated pricing and identify format availability before selecting the materials they wish to use in their courses. Once they select their materials, the information is submitted to the bookstore for processing and inventory preparation, and the materials become available on the bookstore website. About Yuzu Yuzu (https://www.yuzu.com/) is a learning platform, powered by VitalSource, which delivers an enhanced digital reading experience with access to a broad digital catalog. Digital Learning Material includes etextbooks, which are digital versions of printed textbooks that students can access on their laptops, desktops, or mobile devices (Android and ios). - 3 -
Getting Started - Requesting Credentials from Barnes & Noble College The LMS Administrator will need to request a key and secret in order to successfully author links for courses in the LMS. Following are instructions on how to access and request a consumer key and shared secret: Navigate to the following URL: https://blti.bncollege.com/registration/consumer Complete the form, taking note of the required fields: Field Name LMS Type School Email First Name Last Name Phone Job Title CAPTCHA Description Please select the LMS used at your institution (e.g. Desire2Learn). If your institution. Enter your institution s name in this field (e.g. University of Wisconsin). This is a free form text box with no character limits. Please enter your institutional email address. An auto-generated email will be sent to this address when the consumer key and shared secret are created. Enter your first name in this field. Enter your last name in this field. Enter your phone number in this field. We recommend that you also enter your job title. This will help Barnes & Noble College know this request is legitimate. To prevent spam submissions, CAPTCHA requires a user to check the box. This step must be completed before the credential request can be submitted for processing. If your institution employs multiple learning management systems, a separate key request will need to be submitted for each. Once all the required fields including CAPTCHA are successfully filled, click the Submit button to submit the key and secret request. After the credential request has been successfully submitted, the system will direct you to a success page. You will also receive a confirmation email from the Barnes & Noble College LTI support team with steps to test the connectivity (also seen in the next step) and further instructions to set up the LTI integration. Your consumer key and shared secret will be generated and sent to your provided email address, after you have provided Barnes & Noble College with all of the information requested in the following step. - 4 -
Testing Link Connectivity with Barnes & Noble College By testing the link connectivity, you are providing Barnes & Noble College with the parameters used within your D2L instance. Knowing the Course ID or Course Registration Number format used by your campus will help us devise an algorithm to link students to the correct course materials and instructors to their correct courses. Below are the steps to test connectivity in Brightspace by D2L: 1. Log in to Brightspace by D2L as a Super Administrator user. 2. Navigate to an available SIS course, preferably from a recent or current term. 3. Click on Content (Navbar link) or Content Browser (located under the Navbar). 4. Under the Table of Contents, click into the text box where the Add a module text is visible and type Bookstore in the field. 5. Hit the Enter or Return key on your keyboard. Bookstore will now appear as a module under the Content area. 6. Select the Course Admin link located in the Navbar. 7. Click External Learning Tools, under Site Resources. 8. Click New Link under the Manage External Learning Tool Links tab. 9. On the New Link page, enter the following in the fields: Title: BNC Connectivity Test URL: https://blti.bncollege.com/lti/1.1/debug Description: none Visibility: Check the box to allow users to view the link Key/Secret: Check the option for Sign messages with key/secret with, then select the radio option for Link key/secret Key: type in test Secret: type in test Custom Parameters: none Security Settings: Click the radio button for Use link security settings and ensure all check boxes are selected Make link available to: Ensure that the appropriate Org Unit is selected. The Add Org Units button will allow you to select additional units, if necessary. 10. Click Save and Close. 11. The BNC Connectivity Test LTI tool will appear on the list of external tool links. 12. Click Content again to return to the Content page. 13. Select the Bookstore module. 14. Click on Existing Activities, and select External Learning Tools. 15. In the Add Activity window, click on BNC Connectivity Test. - 5 -
16. The BNC Connectivity Test link will appear within the module. Click on it to launch the connectivity test. 17. Once the LTI Parameters appear, click Send LTI Parameters to Barnes & Noble College. 18. Enter your email, school, and a brief message, then click Submit. 19. Please repeat the test for courses of different formats, e.g. multi-section or cross-listed courses. 20. Once testing is complete, please email a listing of term codes for the academic year (e.g. 201901 = Spring 2019, etc.) to ltisupport@bncollege.com. 21. Delete the placement for the BNC Connectivity Test once you have submitted the results to Barnes & Noble College. Otherwise, instructor and student users may attempt to use it. If you have trouble submitting your connectivity test, send a screenshot to ltisupport@bncollege.com. - 6 -
System-Level External Tool Configuration In this section, the D2L administrator will create external tools that will enable the following LTI links globally in D2L: Purchase Course Materials o This LTI link will direct students to their course materials on the official bookstore website. Research and Adopt Course Materials o This LTI link will direct faculty members to FacultyEnlight to place a textbook adoption for their course, or to research textbooks and digital materials. Student users will not see this link. These steps are to be executed after the connectivity test is complete and the consumer key and shared secret have been issued by Barnes & Noble College. We suggest setting up these links in a staging environment for testing before implementing in your production environment. Setup for Purchase Course Materials Link 1. Once you have received your key and secret, click on the gear icon at the top right-hand side of the page to view your Administrator options. 2. Under the Organization Related section, click on the External Learning Tools link. 3. Click New Link under the Manage External Learning Tool Links tab. 4. On the New Link page, enter the following in the fields: Title: Purchase Course Materials URL: https://blti.bncollege.com/lti/1.1/launch/bn_wcs Description: View and purchase your course materials on the official bookstore website. Visibility: Check the box to allow users to view the link Key/Secret: Check the option for Sign messages with key/secret with, then select the radio option for Link key/secret Key: Enter the consumer key provided to you via email. Secret: Enter the shared secret provided to you via email. Custom Parameters: none Security Settings: Click the radio button for Use link security settings and ensure all check boxes are selected Make link available to: Ensure that the appropriate Org Unit(s) is selected, so that the tool is available. The Add Org Units button will allow you to select additional units. 5. Click Save and Close. - 7 -
Setup for Research and Adopt Course Materials Link The steps to set up the Research and Adopt Course Materials link are very similar to the steps for the Purchase Course Materials setup. 1. After setting up the Purchase Course Materials link, you will be returned to the Manage External Tool Links menu. 2. Click New Link. 3. On the New Link page, enter the following in the fields: Title: Research and Adopt Course Materials URL: https://blti.bncollege.com/lti/1.1/launch/bn_fe Description: Faculty: research and adopt your course materials on FacultyEnlight. Visibility: Check the box to allow users to view the link Key/Secret: Check the option for Sign messages with key/secret with, then select the radio option for Link key/secret Key: Enter the consumer key provided to you via email. Secret: Enter the shared secret provided to you via email. Custom Parameters: none Security Settings: Click the radio button for Use link security settings and ensure all check boxes are selected Make link available to: Ensure that the appropriate Org Unit(s) is selected, so that the tool is available. The Add Org Units button will allow you to select additional units. 4. Click Save and Close. Adding the Bookstore Links to the Navbar After you have added installed the LTI tools within D2L, please follow these steps to make sure that students and faculty will have access to them at the course level. 1. Hover over the Navbar. 2. Click the gray box that appears to the right of the menu. 3. Click Edit this Navbar. 4. On the Edit Navbar page, locate the Links section and click Add Links. 5. In the Add Links menu, click Create Custom Link. - 8 -
6. In the Create Custom Link menu, enter the following in the fields: Name: Purchase Course Materials URL: Click Insert Quicklink. Scroll down to External Learning Tools, and click Purchase Course Materials Behavior: New window/tab Browser Attributes: Leave Menubar and Toolbar checked. Description: View and purchase your course materials on the official bookstore website. Icon: Download the icon to your hard drive and upload it to the form. Availability: Check Share with child org units. Leave Limit to specific roles blank. 7. Click Create. 8. The link will be selected. Click Add. 9. Drag the link to your preferred location within the Navbar. 10. Click Add Links again. 11. In the Add Links menu, click Create Custom Link. 12. In the Create Custom Link menu, enter the following in the fields: Name: Research and Adopt Course Materials (alternative name: FacultyEnlight) URL: Click Insert Quicklink. Scroll down to External Learning Tools, and click Research and Course Materials Behavior: New window/tab Browser Attributes: Leave Menubar and Toolbar checked. Description: Faculty: research and adopt your course materials on FacultyEnlight. Icon: Download the icon to your hard drive and upload it to the form. Availability: Check Share with child org units. Check Limit to specific roles and select the administrator and instructor roles for your instance (exclude students and auditors, etc.). 13. Click Create. 14. The link will be selected. Click Add. 15. Drag the link to your preferred location within the Navbar. 16. Click Save and Close. 17. The bookstore links will now appear in your default Navbar in courses where the menu is applied. If your institution uses multiple Navbar menus, please ensure that the bookstore links are installed in those menus as well. - 9 -
Adding the Purchase Course Materials Link to a Course Widget If you use widget-based home pages in your D2L instance, follow these steps to set up the bookstore link in your default course homepage. 1. Open the Admin Tools by clicking the gear icon at the top right-hand corner of the homepage. 2. Under the Organization Related section, select Homepage Management. 3. Click the Widgets tab. 4. Find your student resources widget, or the widget where you wish to place the bookstore link. Ensure that this widget is available to students. 5. Click the pen icon to edit the widget. 6. Select the Content tab. 7. In the text box, type Purchase Course Materials. 8. Highlight the text with your cursor. 9. Click the hyperlink icon to insert a quicklink. 10. On the menu, scroll down to and select External Learning Tools. 11. Click Purchase Course Materials. 12. The Purchase Course Materials LTI link is now added to your widget. 13. Click Save and Close. 14. Click the Homepages tab. 15. Select your default course homepage. 16. Scroll down to widgets and ensure that your widget is in your default homepage. 17. If it is not, click Add Widgets on the part of the page where you would like to add it. 18. Use the filters to locate your widget. 19. Select it, and click Add. 20. Click Save and Close. Adding the Research and Adopt Course Materials Link to a Course Widget These steps, like those above, will enable the faculty link in your default course homepage. 1. Open the Admin Tools by clicking the gear icon at the top right-hand corner of the homepage. 2. Under the Organization Related section, select Homepage Management. 3. Click the Widgets tab. 4. Find your faculty resources widget, or the widget where you wish to place the Research and Adopt Course Materials link. This widget should not be visible to students. - 10 -
5. Click the pen icon to edit the widget. If creating a new widget, click Create Widget. 6. Name your widget. 7. Select the Release Conditions tab. 8. Ensure that the condition Not enrolled in current org unit as the role: Learner is listed as a condition. If not, proceed to the next step. 9. Click Create and Attach. 10. From the menu, select the drop-down for Condition Type and select Role in current org unit. 11. Scroll down to Criteria and select Not enrolled as. 12. For role, select Learner. 13. Click Create. 14. Select the Content tab. 15. In the text box, type Research and Adopt Course Materials. 16. Highlight the text with your cursor. 17. Click the hyperlink icon to insert a quicklink. 18. On the menu, scroll down to and select External Learning Tools. 19. Click Research and Course Materials. 20. The Research and Course Materials LTI link is now added to your widget. 21. Click Save and Close. 22. Click the Homepages tab. 23. Select your default course homepage. 24. Scroll down to widgets and ensure that your widget is in your default homepage. 25. If it is not, click Add Widgets on the part of the page where you would like to add it. 26. Use the filters to locate your widget. 27. Select it, and click Add. 28. Click Save and Close. - 11 -
Authoring a URL Resource for Yuzu This section provides steps to author an optional URL resource for Yuzu. Yuzu is our online platform where students who purchase digital learning materials from the bookstore can access them. We do not currently provide an LTI integration for Yuzu. Course-Level Setup of Access Digital Course Materials Link 1. Navigate to the course or course template where you wish to add the link. 2. Click on Content (Navbar link) or Content Browser (located under the Navbar). 3. Under the Table of Contents, click into the text box where the Add a module text is visible and type Bookstore in the field. Skip this step and step 4 if the Bookstore module already exists. 4. Hit the Enter or Return key on your keyboard. Bookstore will now appear as a module under the Content area. If you would rather place the link in an existing module, click to select it. 5. Click the Upload / Create button. 6. Select Create a Link. 7. For Title, enter Access Digital Course Materials. 8. For URL, enter https://www.yuzu.com/ 9. Check the box for Open as External Resource. 10. Click Create. 11. The external resource will appear. 12. Under the Activity Details tab, click the arrow next to Required: Automatic and then select Not Required. Optional System-Level Setup of Learn About Digital Options Link You may also opt to add a link to a page on FacultyEnlight that provides professors and instructors with an overview of our Yuzu offering. 1. Navigate back to the Content menu, and select the module where you installed the above link. 2. Click the Upload / Create button. 3. Select Create a Link. 4. For Title, enter Learn About Digital Options (Faculty). 5. For URL, enter https://www.yuzu.com/ - 12 -
6. Check the box for Open as External Resource. 7. Click Create. 8. The external resource will appear. 9. Under the Activity Details tab, click the arrow next to Required: Automatic and then select Not Required. - 13 -
Going Live Once you have completed the setup of the Barnes & Noble College LTI links in your production environment, please let us know by reaching out to ltisupport@bncollege.com. Please provide us with a screenshot of the link(s) within your course, so that the store manager can advise students and faculty where to find the bookstore within D2L. Upon going live, we provide the store manager with an email template that may be used to communicate the availability of the bookstore links in D2L. We can also provide how-to documentation for the faculty and student links to you and the store manager. Important Notes and Troubleshooting Error Messages An error message may appear when the tool link is accessed. The most common errors include: 400 Bad Request 403 Forbidden 404 Page Not Found 406 Cookie Error 500 Internal Server Error The message that appears will provide more detail as to the nature of the error, and actions to take to resolve it. Pop Ups Blocked If the LTI link fails to launch, the pop-out window may be blocked. Please allow pop-ups from your D2L site, and then attempt the link again. Other Issues or Concerns Contact Us For help with other concerns relating to the LMS integration in D2L, please contact us by email: Email Address ltisupport@bncollege.com - 14 -