TOOLBOOKDEVELOPER.COM

Quiz Summarizer User's Guide

It's

Go to User Guide Home

About the Quiz Summarizer

Developed for:

SumTotal ToolBook Instructor version 8.0 or higher

Works in:

Native, Neuron, and DHTML ToolBook Projects, IE, NS and Firefox

Type of Tool:

Catalog Object

Current version:

1.4

Installation

When you download the program, it will self extract into your Program Files directory into a folder for NirvanaBound\QuizSum##\, 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 Summarizer category.

Version 1.4 updates

  1. Number Answers and Results: A new check box in the "General" tab. When checked the Answers and Results columns will be numbered.  This makes it a little easier for users to see the different answers and/or results.  Note that the Results are in chronological order and not the order that the users selected.
  2. New Feedback column: This column will display the Delayed feedback of the question object. The Quiz Summarizer will determine if the question has been answered correctly, incorrectly or partially correct and display the appropriate delayed feedback.
  3. Styles Tab:  Provide for advanced users who would like to change the style of various aspects of the Quiz Summary page.

What the Quiz Summarizer Does

The Quiz Summarizer is designed so that ToolBook Developers can easily provide a summary of quizzes which will give your learners ' specific and detailed feedback on the results of their quiz.  Learners will know exactly which questions were answered correctly and which were wrong because the Quiz Summarizer produces a summary table.  The summary table can display a number of different items - you the developer choose exactly what you want your learners ' to see.

How to Use the Quiz Summarizer

Please note that the following images show the complete setup for the Quiz Summarizer.

1.

Be sure that you have properly installed the Quiz Summarizer and confirm that it has been imported into your catalog.  It should be listed as the Quiz Summarizer.
2. Drag and drop the Quiz Summarizer Widget onto a page after the page where you have the score quiz. Do not put the Quiz Summarizer on the background of your book.
3. Select the Quiz Summarizer Widget and then open up the Extended Properties.
4. General Tab:  First define your summary table:

Using the Add, Edit and Delete buttons maintain the list of columns for the Quiz Summarizer table.  There must be at least one column, see below for a list of the columns.
Using the Up and Down buttons will allow you to re-order the columns.
Table Title: Enter the text that you would like to see at the top of the table.
Number Answers and Results: When checked the Answers and Results columns will be numbered.  This makes it a little easier for users to see the different answers and/or results.  Note that the Results are in chronological order and not the order that the users selected.  See example below.
Question Text Field:  Enter the name of the field or recordField that contains the question text, note that you only need to maintain this option if you have chosen to display the question text in a column.
Check Question Field:  Click this button to find all of the question pages in your book and check that there is a Question Text Field (if used:-)

5. Table Columns:  When the Add or Edit button (above) are clicked the following dialog will be displayed:

Column Name:  Select the column name from the drop down list, the column name is used by the Quiz Summarizer Widget to know what data you want to be displayed in the given column.
Column Title:  This is the text that will be used for the column heading, each column has a default value, however, you may change this to suit your needs.

Default details:
Column Name Column Title Description
Link Review This is a link to the page that contains the question.
This allows your users to navigate to the page and review the question.
QText Question This column will contain the text of the actual question.
Ans Answers This column contains all of the answers of the question object.  The answers will be presented in the original order.
Res Results This column will contain all of the selected answers and the the correct answers that have not been selected.  The answers are color coded so your user's know which answer they selected correctly, which they selected incorrectly and those answers that are correct and they did not select.  See below in the Options tab for further details on colors.
Scr Score Here we can display the Score for the question.
Min Min Score This column will display the minimum score for the given question, typically this would be 0 (zero).
Max Max Score This is the maximum score for the given question, typically 1 (one).
Tries Number of Tries This column will display the number of times your user has tried to answer the question.  Note that a try is counted when a question is scored or when feedback plays.
Time Time Spent Here we can display the total time the user was on the page.  Note that the time starts when the page is loaded and stops when we navigate away from the page.  If the page is re-visited the time is not re-started, ToolBook will add to the previous time.
FB Feedback This column will display the Delayed feedback of the question object.  The Quiz Summarizer will determine if the question has been answered correctly, incorrectly or partially correct and display the appropriate delayed feedback.  Note that you can assign standard ToolBook strings like: <correct> and <incorrect>
It's important to note that when using standard stings the converted text is acquired when you click the OK button in the Extended Properties Editor of the Quiz Summarizer Widget.
6. Options Tab:  Now define the colors:

Background Color:  Define the background color of the Quiz Summarizer Page.
Column Header Color:  Define the color of the Quiz Summarizer table column header.
Table Row #1 & 2 Colors:  Here you can define a different color for alternating rows, this will assist with visual separation between rows.
Results:  This section will only be enabled if you have chosen to have a results column.
Correct Color: Define the color of the correct answer(s) that have been selected.
Incorrect Color:  Define the color of the incorrect answer(s) that have been selected.
Correct Not Selected: Define the color of the correct answer(s) that have NOT been selected.
Include Key:  When clicked will display the "Key for Results" dialog see below.
Include Print Summary:  When checked the Quiz Summarizer will include a button to allow the user to print the summary page, you may also define the caption of the button.
The bottom of this screen displays colors you have selected.

7. Key for Results:  Provide a color coded key for the results column.

This dialog can only be displayed if you have chosen to have a results column.

Include Key: If checked then the Results key will be included.
Show Me: Click this button to re-display the details at the bottom of the dialog so you can see what will actually be displayed.
Correct Color Text: Define the text for the correct answer(s) that have been selected.
Incorrect Color Text:  Define the text for the incorrect answer(s) that have been selected.
Correct Not Selected Text: Define the text for the correct answer(s) that have NOT been selected.

Note in the above dialog all of the text fields include the word associated with the color and these words are enclosed in square brackets [ and ], these square brackets are used to color and bold the word as can be seen at the bottom of the dialog.

8. Styles Tab:  Provide for advanced users who would like to change the style of various aspects of the Quiz Summary page.

Styles have been added to allow you to change to look of the Quiz Summary page.  The font used would be the standard font used to display a page on the user's PC, here you can define the "font-family". Note that the "background-color:" in each of the styles is the color selected in the "Options" tab.  You should define the colors first before you check the "Include Styles" button, this way the colors will be loaded as defaults.
Include Styles: If checked then the styles on this page will be use. When first checked the various styles will be loaded with default details.  WARNING: Once selected and the default styles have been loaded then changing the colors in the "Options" tab will not be used!
Body: Enter the style for the body htm tag.
Table: Enter the style for the main Quiz Summary table.
Column Header Enter the style for the column headings.
Table Row #1 and #2: Here you can define a different style for alternating rows, this will assist with visual separation between rows.

9. Below is an example (from the demo) of the the results produced by the Quiz Summarizer.  Don't like the colors, want to add other information such as max score - no problem - just make your choices in the extended property editor. Click here to view the demo.

Really Hard Words Vocabulary Test

Correct answers are GREEN, Incorrect answers are RED, Correct but not selected are ORANGE

Review Word Answers Results Score Time Spent Feedback
Review comminute
1. To reduce to particles.
2. To travel to work using transit.
3. To live in a public place.
4. An unpleasant surprise.
1. To reduce to particles.
2. To travel to work using transit.
0 00:00:05 Incorrect
Review excogitate
1. To live in a foreign country.
2. Speaking in tongues.
3. To think out, devise.
4. A highly educated person.
3. To think out, devise.
1 00:00:07 Correct
Review refocillate
1. To grow hair.
2. To revive with warmth.
3. To be focused on the past.
4. To flush with fresh water.
1. To grow hair.
2. To revive with warmth.
0 00:00:11 Incorrect
Review rhymster
1. One who sings Irish songs.
2. An earthen strawberry planter.
3. An inferior poet.
4. A type of fresh water fish.
3. An inferior poet.
1 00:00:08 Correct
Review oneric
1. Wealthy.
2. Dreamy.
3. Sleepy.
4. Satisfied.
2. Dreamy.
1 00:00:15 Correct
10. Supports the following question objects:
  • Multiple Choice Questions - including field type

  • Definable Multiple Choice Questions

  • Grid Questions (a ToolBookDeveloper.com product)

  • Taquin Questions (a ToolBookDeveloper.com product)

  • True/False Questions

  • Match Item and Match Object Questions

  • Fill In The Blank Questions

11. The Quiz Summarizer Widget will extract the text of the answers for each question and display this text in the Answers column, this text is also used in the Results column.  The exception to this (for the Results column) is the text entered for a Fill In The Blank (FITB) question.  For some questions like the Match Object, Definable Multiple Choice and (in some cases) the FITB questions the actual text of the answers is not appropriate or it can be completely useless.  Therefore, the Quiz Summarizer Widget will use the NB_SummaryAnswers userProperty of a given question object instead of the actual answer text. The following is an example of a Definable Multiple Choice question:

The Quiz Summary would look like:
Question Answers Results
Identify the shutter release button by clicking on it. 1
2
3
4
5
2

Clearly the above is of no use to he learner, to overcome this limitation of the question you can assign meaningful answers to the NB_SummaryAnswers userProperty, to do this:
Simple, go to the page with the question on it and select the question object. Enter <Ctrl> + F4 to open up the properties browser and select the user tab. Double-click <Add New> and then add your new property along the lines illustrated below:

Now the Quiz Summary will look like:

Question Answers Results
Identify the shutter release button by clicking on it. 1 = View Finder
2 = Shutter Release
3 = Shutter Speed Selector
4 = Auto Release
5 = Lens
2 = Shutter Release

FAQs, Troubleshooting, and Tech Support Tips

Please see the ToolBookDeveloper.com Knowledge Base for additional assistance in using the Quiz Summarizer.