Grading works best when everyone is kept in the loop automatically. This article explains how to set up two automations:
A notification to the manager when a learner's submission is ready for grading
A notification to the learner when their submission has been graded, plus an action that completes or resets the activity
You set these up in TinQwise Control > Behaviour > Automations.
Automation 1: Notify the manager when a submission is ready for grading
This automation fires every time a learner reaches the end of a Learning bite with grading enabled.
Go to Behaviour > Automations in TinQwise Control
Click Create new automation
Give it a name (e.g. "Ready for grading - notify manager")
As the trigger, choose Activity ready for grading
As the condition, select Unconditional
👀 Good to know
This automation fires every time any activity with grading enabled is completed. Keep your notification text generic so it works across all your graded Learning bites.
As the action, select Notify user and fill in the following:
Title: Activity ready for grading
Message:
Hi {{manager}}, {{event.user.get_full_name}} has completed {{event.module.title}}. Click here to grade the activity: /#/reporting/user-detail/{{event.user.pk}}/Tick Send email if you also want the manager to receive an email
For Recipients, select To manager
For Manager selection, choose Direct manager or All managers depending on your setup
For User source, select event > user
Click Save
✏️ Tip
When the manager clicks the link in the notification, they are taken directly to that learner's reporting page. Scroll to the bottom to find the activity waiting for grading.
Automation 2: Notify the learner when their activity has been graded
When a manager grades a submission, the learner should be notified and the activity should be either completed or reset. Set up two separate automations for this: one for a passing grade and one for a failing grade.
👀 Good to know
The platform uses a simple pass/fail threshold. A grade of 1 or higher (Pass, Good, or Excellent) is considered sufficient. Below 1 (Fail) is insufficient. Set the minimum grade to pass to 1 in both automations.
Automation 2a: Grade is sufficient (Pass, Good, or Excellent)
Go to Behaviour > Automations and click Create new automation
Give it a name (e.g. "Activity graded - sufficient")
As the trigger, choose Activity is graded
As the condition, select Activity graded and set Minimum grade to pass: 1
Add the first action: Notify user
Title: Your activity has been graded
Message:
Hi {{event.user.get_full_name}}, Your activity {{event.module.title}} has been graded by {{event.graded_by.get_full_name}} on {{event.recorded_at}}. Your grade: {{event.grade_description}} Comment from your trainer: {{event.grade_comment}}Tick Send email if you also want the learner to receive an email
For User source, select event > user
Add the second action: Complete activity
User source: event > user
Activity source: event > activity
Click Save
Automation 2b: Grade is insufficient (Fail)
Go to Behaviour > Automations and click Create new automation
Give it a name (e.g. "Activity graded - insufficient")
As the trigger, choose Activity is graded
As the condition, select Activity graded, set Minimum grade to pass: 1, and tick the Negate box
Add the first action: Notify user with the same message template as above
Add the second action: Reset activity
User source: event > user
Activity source: event > activity
Click Save
🚧 Be careful
Make sure you set up both automations (2a and 2b). Without the reset action on the insufficient automation, a learner who fails will not be prompted to try again.
Variables you can use in notification messages
These variables are available in grading automations and will be filled in automatically with real data when the notification is sent:
{{event.user.get_full_name}}- the learner's full name{{event.module.title}}- the activity title{{event.graded_by.get_full_name}}- the grader's full name{{event.recorded_at}}- the date and time of grading{{event.grade_description}}- the grade label (e.g. "Excellent"){{event.grade_comment}}- the comment left by the grader
Adjusting platform texts
The platform texts used in the grading feature (such as labels and button text) can be adjusted in Control > Content > Translations.
All three automations work together to create a smooth grading flow. For a full overview, see Setting up grading on a Learning bite and How to grade a learner's submission.