Desire2Learn Integration

Getting Started

In this quick guide, basic steps are outlined to build web links in a D2L environment. The assumptions are that implementation steps have been completed with your Tk20 Product Consultant (i.e. coursework has been created and sent in Tk20, provider domain has been registered in LMS) and you are ready to begin linking courses in your LMS to Tk20 coursework. For more information on the implementation process, please reference the LTI Overview document or speak to your IPC.


Note(s): Screenshots are from a D2L version which may be slightly different than yours.



External Tool Configuration (System Administrators)

  1. Log in as an administrator or instructor.
  2. Click the course title link.
  3. Click Edit Course.
  4. Click External Learning Tools.

    d2l1
     
  5. Select Manage Tool Providers.
  6. Click New Tool Provider.
  7. Launch Point: Launch URL provided in the LTI Tool Provider Setup Menu of the Administration tab.
  8. Secret: Secret provided in the LTI Tool Provider Setup Menu of the Administration tab.
  9. Tool consumer information: select the checkbox for Use custom tool consumer information instead of default.
  10. Key: Key provided in the LTI Tool Provider Setup Menu of the Administration tab.

    d2l2
     
  11. In the Security Settings section, select all the needed fields.
  12. Click Save and Close.


Adding Tk20 Assignments to a Desire2Learn Course

  1. Within the Course, click Edit Course.
  2. Click External Learning Tools.
  3. Click New Link.
  4. Title: Enter a title for the assignment in the module.
  5. URL: Launch URL provided in the LTI Tool Provider Setup Menu of the Administration tab.

    d2l3
     
  6. Visibility: Allow users to view this link.
  7. Key/Secret: Select ‘Sign message with key/secret with Tool consumer key/secret’.
  8. Security Settings: select ‘Use tool provider security settings.

    d2l4
     
  9. Click Save and Close.
  10. Click Content.
  11. Select the desired module under Table of Contents.
  12. Click Add Existing Activities.
  13. Select External Learning Tools.
  14. Select the Tk20 Assignment you created in step 3.
  15. The link to the coursework will be displayed within this module.

    d2l5

    Note(s):
    Faculty and student general account integrations link to the Tk20 Homepage.
    Faculty coursework level integrations link to the Tk20 Coursework Submissions page.
    Student coursework level integrations link to the Tk20 Coursework Submission page.


Grade Return Setting in D2L

  1. Within the Tk20 assignment embedded window, grade all needed assignments.
  2. Scroll down, under Assessment click Add a grade item

    d2ladd2
     
  3. Click the
    d2ladd

     button.
  4. Name: Enter a title for the assignment grade item in the module.

    d2l7
     
  5. Click Create.
  6. Click Submit to Gradebook.
  7. Click Assessments Tab on D2L.
  8. Click Grades.
  9. Find name of the assignment associated with grade item.
  10. Click on Properties menu for the assignment.
  11. Click Edit.

    d2l8
     
  12. Deselect Exclude from Final Grade Calculation.

    d2l9
     
  13. Click Save and Close.


Note: This Assignment Grade Item can be deleted after it has been used. The grade and future edits on the grade will stick on the name of the Assignment. Deleting the Assignment Grade Item should not affect the transfer of grades.

 


Grade Return is used to record a grade in Tk20 and then push that grade back to your Learning Management System (LMS) gradebook



Requirements for Grade Return

  • Additional Parameters may need to be set depending on the LMS. For example, in Blackboard parameter of “Enable Grading” must also be set to “Yes”. This parameter creates a column in the blackboard gradebook for the coursework and grade.
  • All values in the Grade and Overall Grade boxes must be entered as percentages.
  • Tip: Make assignments out of 100 points
  • Grade value must be a whole number (e.g., 87, 90) not including a decimal (e.g., 87.5, 93.4)
  • The student must click on the Coursework link in the LMS to enable grade return. When the link is clicked, a pathway from Tk20 to the appropriate column in the LMS gradebook is created.
  • Students should not log into Tk20 to submit Coursework.

 




Grade Return Examples

  • Grade is entered manually.
  • Total Score is auto-calculated by Tk20.
    d2l12

    Coursework Type: Assignment with One Assessment Tool


    d2l13
    Coursework Type: Assignment or Course Binder with Multiple Assessment Tools


Note(s): For assignments with multiple assessment tools, a grade is provided in each assessment tool. In the image “Coursework Type: Assignment or Course Binder with Multiple Assessment Tools”, the faculty member has recorded a grade for each form. The faculty member then recorded an Overall Grade which will be returned to the LMS.



Troubleshooting Grade Return

If all grades are submitted successfully, the system will display the message “All grades were successfully submitted to the gradebook.” A green checkmark will be displayed next to the grades that were successfully submitted. Potential error messages you may receive:
 

“One or more grades were not sent successfully. Please review the status in the student grade column. For troubleshooting, please contact your LMS administrator.”

  • Do you need to install SSL certificates? (Blackboard requires, other LMS systems may as well) ■
  • Did the student click on the link in the LMS to access the coursework? Student may not have submitted work via Tk20 Coursework Integration. It is an LTI specification that when the student clicks the link the connection to the location in the gradebook is established. ■
  • Are their multiple links set up in the LMS? Did the student click on a “Course Integration” or “Account Integrations” link? Grade return is only available with Coursework Integration.


“Grade must be between 0-100.”

  • Did you enter a Grade value between 0-100? ■
  • If the grade is not a valid value between 0-100, the system will display an error icon next to the student grade. If you hover over the icon a message will appear, “Grade must be between 0-100.”


“Error: Contact Administrator.”

If the grade was not successfully submitted for any other reason, the system will display an error icon next to the student grade. Possible reasons for the error:

  • The Coursework link may not have a column in LMS gradebook OR linked to an assignment in the LMS.
  • The Assignment/Coursework Link may not have a “points possible” value in the LMS gradebook.
  • The student may not have submitted work via Tk20 Coursework Integration. It is an LTI specification that when the student clicks the link the connection to the location in the gradebook is established.
  • The student does not exist in the LMS course.
  • The student does not exist in the LMS gradebook
 
Was this article helpful?
0 out of 0 found this helpful

Articles in this section

See more
How to Contact Support
Click the "Submit A Request" button at the top right or bottom of the screen to create a case.
Watermark Academy
Click to access the Watermark Academy for free webinars, workshops, certifications, and free on-demand training