Quiz Randomizer User's Guide


Go to User Guide Home

About the Quiz Randomizer

Developed for:

Click2Learn ToolBook Instructor version 8.0 and higher

Works in:

Native, Neuron, and DHTML ToolBook Projects

Type of Tool:

Catalog Object


When you download the program, it will self extract into your Program Files directory into a folder for NirvanaBound\QuizRand##\, where ## will indicate the ToolBook version (i.e. 80, 85, 89 or 90). At the end of the extraction process it will run a utility (written in ToolBook :-) to find your Instructor file and will install the Widget into your catalog folder. The next time you open ToolBook Use the Customize Catalog feature to import this new Quiz Randomizer category.

What the Quiz Randomizer Does

The Quiz Randomizer is designed so that ToolBook Developers can easily add controlled randomization functionality to their ToolBook Quizzes. 

What do we mean by "controlled?"  Standard ToolBook quiz randomization functionality allows you to create a quiz with many questions and then, when presenting the quiz to the learner, randomly select x questions from the pool of questions.  However, often ToolBook quizzes reflect questions from several different topics and it is important to make sure that the questions presented to the learner have a balanced number of questions from each topic.  Or, perhaps there are certain critical questions that should always be included in the quiz regardless of the other questions that are randomly selected.  Or, maybe you want to include more questions from one topic than from others because of its important to the learning process.  Whatever the case, you want to have more "control" over the randomization functionality of your quiz.  That is what we mean by controlled randomization and that is what the Quiz Randomizer will do for you.

IMPORTANT:  Basic Rules for Creating a Quiz That Will Use the Quiz Randomizer

Please note that the following rules apply for the standard ToolBook Randomization and none of these rules are imposed by the Quiz Randomizer Widget.

  1. You must always have at least one non-question page before and after all question pages, typically this would be your Introduction and Score pages.
  2. All quiz question pages MUST be consecutive, there cannot be non-question pages mixed in with question pages.  See "What is a NON-Question Page" below.
  3. All quiz questions must be set to be scored in the Question Object.
  4. There can only be one question object on a given page.
  5. The maximum score of each question must be 1.
  6. Ensure that your questions are organized consecutively by category.  So for example, category 1 questions could be pages 2-7; category 2 questions would be pages 8-12, etc.  You cannot have questions for a category randomly spread throughout the book.

What is a NON-Question Page

The standard ToolBook definition for a non-question page is:

  1. There MUST NOT be a question on the page.
  2. If a question is on the page then the question object MUST:
    1. Not be set for "Score this question".
    2. MUST have a Maximum sore of null (in effect 1 above:-), and
    3. Have a userProperty of NotInQuiz set to true.

Once again, please note that these are standard ToolBook rules and are not imposed by the Quiz Randomizer Widget.

How to Use the Quiz Randomizer Widget

Please note that the following images show the complete setup for the Quiz Randomizer Demo, click here to view the demo.


Be sure that you have properly installed the Quiz Randomization Widget and confirm that it has been imported into your catalog.  It should be listed as the Quiz Randomizer.
2. Confirm that your quiz has been created following the Basic Rules listed above.
3. Drag and drop the Quiz Randomizer Widget onto the first page of your Quiz.  This will be your Quiz Introduction page.  Do not put the Quiz Randomizer on the background of your book.
4. Select the Quiz Randomizer and then open up the Extended Properties. 
5. General Tab:  First, define your question categories.

Select Add and the following dialog will display:

Enter the Category Name, select your Start and End pages for the give category, you now have a page range.  Note that the "Number of Questions" should show the number of questions in your category.  At this point, because you have not yet selected any Mandatory Questions, the number showing will be 0.  Finally, indicate the number of questions in this category that you wish to be selected as part of the quiz by use of the spin controls, updating the "Number To Randomize" field.

6. Mandatory Questions Tab:  A mandatory question is a question that you wish to have asked all of the time, regardless of the other questions that are randomly selected.  All question pages will be listed in the Mandatory Questions tab.  Check any questions that you wish to be considered as "Mandatory".  Note that having mandatory questions is optional as you may not have any questions that are mandatory.

The above shows that in the first category "ToolBook Object Properties" we have one mandatory question.

Important!  You may not have more mandatory questions than the number of questions to randomize in a given category.  If these numbers are the same then you will always get the mandatory questions and none of the other questions in the category.

7. Options Tab:  This tab is only used for Export to Web and will give you control over the DHTML randomization.  The Quiz Randomization functionality is facilitated through OpenScript code for Native deployment and through JavaScript code for Web deployment, this JavaScript code is added to the exported DHTML files. 

Typically you would want to Auto Add JavaScript code when you export your files, so you should check the middle option on the Options tab. 

So, if you typically would check Auto Add JavaScript after export, then when would you use the other two options on the Options tab?

Remove Export Code:  Why would you want to remove the randomization?  Let's say that you want to test your quiz to make sure that all of the questions are correctly scoring.  What are your options?  One options would be to take the test lots and lots of times tracking the questions until you are sure that you have tested all of them.  Another option is to remove the randomization widget, export, do your testing, and then re-export after adding the Randomization Widget back into your project. could simply check the Remove Export (JavaScript) code option and hit the OK button. 

Because all of the randomization code is in the JavaScript, when it is removed you have your quiz without any randomization!  And, you don't even have to re-export :-)  Note that this option is not persistent, meaning that the next time you open the Extended Properties Editor you will see that it is not checked.  Also note that checking this option will override the "Auto Update (JavaScript)" option, so you do not need to uncheck the "Auto Update..."

Auto Update (JavaScript):  This option is provided to allow you to make changes to the way your randomization is set.  For example, you may have missed an important mandatory question. In this case, you would check the Auto Update option after you have made changes to the Quiz Randomizer settings and then click the OK button.  When you do this the Quiz Randomizer will re-generate the JavaScript and update your exported files.  This means that you don't need to re-export you book after making a simple change to the randomization criteria.  Note that this option is persistent meaning that it will remain checked until you uncheck it. 

Taking advantage of the Auto Update option  BTW is a great option if you want to create multiple quizzes from the same files.  With this option you won't even need to re-export to create a newly configured quiz. 

Why would you want to create multiple quizzes???  Let's say that you have a pretest and a post test.  For the pretest you want to give a 20 question quiz, but for the post test you want to give a 40 question quiz.  Here is how you can do it (ensure the Auto Update is checked):

First, export your quiz set for the 20 question pretest.  Now, copy the dhtml files in the WebExport folder to a safe location and mark them as pretest.  Now, open the Extended Properties Editor again, but this time set the randomization criteria for the post test that will have 40 questions. When you click OK to close the Quiz Randomizer Extended Properties, the JavaScript in the DHTML files will be updated for the post test.  Now you have two sets of DHTML files:  Pretest files which you have saved to a safe location and marked as pretest files and post test files that are in the WebExport folder.  Easy, isn't it?

8. General Tab (again):

After you have added all of your categories and assigned all of the questions to the categories you now have a quiz that will select x questions and present them to the learner.

Important!  ALL question pages MUST be assigned or the Quiz Randomizer Widget will NOT randomize your book.

At this point you need to consider whether you want all of the questions presented in a random order or if you would like the questions presented in Category order.  By checking the "Randomize All Questions" option the Quiz Randomizer will re-randomize all of the questions after it has completed the randomization of the questions in the individual categories.  Note that if you do not check this option then the questions within a given category will still be randomized whether or not they contain mandatory question(s).

FAQs, Troubleshooting, and Tech Support Tips

Please see the Knowledge Base for additional assistance in using the Quiz Randomizer.