Content — Write Content Code to Registration Fields with Action Codes
TraCorp LMS Quick Reference Guide (QRG)
Audience: Main Admin, Sub Admin, User Group Admin
Overview
For courses that send completion data to the LMS, write content code in the form of Action Rules to be used in the Registration Field based on the results of an online test or SCORM course.
Enabled Permissions Required to Complete the Following Steps
- Content (User Group Admin, Sub Admin)
Note: Sub Admin and User Group Admin without access to complete these steps should review Permissions with a Main Admin. User Group Administrators are not authorized to access Registration Fields.
Locate the Metadata Tab
1. From Admin Navigation, click Content.
2. Double-click a piece of content to open the Edit Content window.
3. Click the right arrow at the top of the Edit Content window to scroll to the Metadata tab.
4. Click the Metadata tab.
Action Rules
Action Rules are a series of rules with one rule per line, made up of a trigger and action list.
1. Click ? next to Action Rules and read the options available and syntax for writing them. The syntax is trigger = action_list.
2. Enter the code in the Action Rules field using the information below on Triggers and Action List.
3. Enter Notes or other admin-facing information related to the content that describe the Action Rule.
Triggers
Acceptable triggers are:
- completed — Content has changed from incomplete to complete.
- uncompleted — Content has changed from complete to incomplete. Note: Do not use this trigger to check if an Online Test/Questionnaire content type has been failed.
- testFailed — An online test has been failed. This only applies to the Online Test/Questionnaire content type.
- passingScorePassed —A student’s score has changed to a score greater than or equal to the content’s passing score.
- passingScoreFailed — A student's score has changed to a score less than the content’s passing score.
Action List
The action list is a comma-separated list of one or both actions:
- addCode:field — This adds the content code to a Registration Field.
- removeCode:field — This removes the content code from a Registration Field.
For instructions on using registration fields, see Knowledgebase article: Registration Fields — Registration Fields Tab.
Examples
|
completed = addCode:field10, removeCode:field11 |
This will add the content code to field10 and remove the content code from field11 when the piece of content moves from incomplete to complete in the LMS. |
|
testFailed = addCode:field11, removeCode:field10 |
This will add the content code to field11 and remove the content code from field10 when a test is failed. This is done by comparing the student’s score on the test to the Passing Score input on the Content Options tab for the piece of content. If the student’s score is less than the passing score, it will be submitted as a failure. |
|
passingScorePassed = addCode:field10 |
This will add the code to field10 when the student’s score changes from a score less than the Passing Score to something equal to or greater than the Passing Score. |
|
passingScorePassed = addCode:field21, removeCode:field22 and passingScoreFailed = removeCode:field21 |
This will add the content code to field21 when the student achieves a passing score. An autoassignment rule for a user group can then reference content code in field21 to automatically assign the student to that user group. |
Note: If an Action Rule makes a change to a student’s Registration Field, the student’s auto-assignments and content assignments will be updated. When content codes are added to or removed from Registration Fields, the code will be in square brackets. A single field might contain this for three content codes: [code1][code2][code3].
Best Practices
- There is no action for testPassed; use completed to check for that. The testFailed trigger will only apply if an online test is submitted.
- If checking for uncompleted or passingScoreFailed, include a rule for the opposite (completed or passingScorePassed) to undo whatever the first action does. For example, if passingScoreFailed adds the code to field10, then passingScorePassed should remove the code from field10. Some online courses may submit a (failing) score before all questions have been answered.