Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Terracotta will not accept a score for a launch token that has already been used.  

Best practices

  • Check if the Launch Token has Previously Been Used: When configuring a Qualtrics survey in Terracotta, there is a checkbox: Survey allows students to view past submissions. If this box is checked, Terracotta will assume that the survey is able to display a past submission to a student. In this situation, if the Qualtrics survey receives a launch token that has previously been used, this indicates that a student is attempting to review their responses from a past submission. Check if the launch token has previously been used, and that the anonymous_id and assignment_id of the current launch matches the anonymous_id and assignment_id of the past submission associated with the launch_token. If so, the external page should display the data from the past submission associated with the provided launch token, with no interactivity.  

    • NOTE: There is one reserved launch_token: "0000000-0000-4000-a000-000000000000". This launch token is issued by Terracotta when previewing external integrations. 

  • Communicate When There are Limited Remaining Attempts: When the teacher has placed restrictions on the number of attempts that a student may submit in response to an assignment, it may be helpful for the Qualtrics survey to communicate this to the student (e.g., if there is only 1 attempt remaining). If there are unlimited attempts available to the student, remaining_attempts = u. A Qualtrics survey will never need to handle a situation where remaining_attempts = 0, because in this situation, Terracotta will not generate a launch_token and will not launch the student into the survey. 

  • Respect Due Dates: Consider warning users when they are accessing the webpage after the due date. Submissions made after the due date will be delivered into Canvas, but will be flagged as late. 

  • Score Calculation: The Qualtrics survey is responsible for determining the student’s score on the activity, which should be returned to Terracotta as an embedded data field with the name “score.” 

...