Grading works best when everyone is kept in the loop automatically. This article explains how to set up two automations:
A notification to the grader (someone with the Manager and Reporting manager roles on the learner's group) 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 reporting 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 automation
Give it a name (e.g. "Ready for grading - notify manager")
As the trigger, choose Activity is 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: /#/gradingTick Send email if you also want the grader to receive an email
For Recipients, select User
For User source, select event > user
Tick To manager
For Manager selection, choose Direct manager to notify the managers of the learner's own group, or All managers to also notify the managers of the groups above it
Click Save
đ§ Be careful
To manager sends the notification to everyone with the Manager role on the learner's group. The Reporting manager role alone is not enough. Make sure each grader has both Manager and Reporting manager on the same group. Otherwise the automation runs but nobody receives the notification.
âď¸ Tip
When the reporting manager clicks the link in the notification, they are taken directly to the Grading overview (also under More > Grading). The submission is waiting in the Pending tab.
Automation 2: Notify the learner when their activity has been graded
When a reporting 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 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 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.
These 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.
