TOOLBOOKDEVELOPER.COM

It's

Go to User Guide Home

About the Taquin Question Object

Developed for: 

Click2Learn ToolBook Instructor version 8.0, 8.5, and 8.9 (2004)

Works in: 

Native, Neuron, and DHTML ToolBook Projects

Type of Tool: 

Catalog Object

Installation

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

What the Taquin Question Object Does

The Taquin question provides a combination of Multiple Choice, Match Item and Ordered List type question with interesting and unique behaviors and unlimited layout options. This question can be used in a local book or in one that is deployed as DHTML files on the Internet. You sequentially select the correct answers, the correct answer moves to the appropriate location and all subsequent answers move to make room for the next correct answer.

Note that the Taquin Question consists of multiple objects that are grouped. The main or top level group is called Taquin, this is not the actual ToolBook question widget. The actual ToolBook question widget is a group of objects which are the answers, these may either be fields or buttons, and this group is called Elements.

To open the Extended Properties Editor for the Taquin question you must first select the group called Elements, for your convenience, if you hold the <Ctrl> key down and click on one of the answers the Elements group will be selected. Alternatively you will need to double click on an answer. Once the Elements group is selected you will be able to click on the Extended Properties button from the Tools palette or from the Object menu.

How to Use the Taquin Question Object

Please note that the following images show the complete setup for the Taquin Question Object.

1.

Be sure that you have properly installed the Taquin Question Object and confirm that it has been imported into your catalog.  It should be listed as the Taquin.
2. The Extended Properties Editor (EPE) for the Taquin Question Object is similar to any standard ToolBook EPE with an extra tab named Addition Details.
3. General Tab:  First, define your question limits and when to reset.

Limits on interaction
Limit time: Specifies the limit on the amount of time allowed for a response to the object. The count for the time begins when the object is reset, usually when the page is entered. When the time limit is reached, the object is locked and no further responses are allowed.
Note: Limit Time is not supported on the Internet
Limit tries: Specifies the limit on the number of tries allowed for the object. (A try is counted when a question is scored or when feedback plays.) When the limit is reached, the object is locked and no further responses are allowed.
Limit Tries per answer: Specifies the limit on the number of tries allowed for each answer. A "try" per answer is counted every time the user clicks on an answer. The answer is automatically moved to the appropriate location on the last click. If this is not selected or the value is 0 (zero) then there is no limit on the number of tries.
Highlight correct answers: When checked then the correct answer that has been selected and not automatically answered will be highlighted. Note that if the Score first attempt only is checked then the answer will only be highlighted if selected on the first attempt.
Highlight Colour: Select the RGB fill colour to be used as the highlight colour.
Normal Colour: Select the RGB fill colour to be used as the normal or reset colour.
Automatically Reset Question: Specifies if and when the question is reset. Once a question is reset, it is no longer scored.
Never: Never on page navigation. Reset occurs only when a Reset object is used and selected by the student. is sent to the page, to the book, or directly to the question.
When entering the page: When the page is entered - recommended.
When leaving the page: When the page is exited.
Always: Every time the page is entered and exited.
Note: that when exported it is highly recomened that the question be reset when entering page.


4. Answers tab:  Now define your answers.

Move subsequent answers: When checked then all of the answers move to their appropriate locations simultaneously. If not then only the next answer is moved and all subsequent answers jump (one step) to their locations.
Move steps: The number of steps used to move the answers, 5 will move fast and 30 will move slowly.
Web move steps There is a difference in the speed of the DHTML deployed Taquin, generally it moves slower. This has been provided to allow a different value from that used in Move steps (see above).
Possible Answers: Lists the possible answers to the question. To set if an answer is correct or incorrect, click the graphic at the beginning of each line. The graphic will toggle between showing correct and incorrect.
There must be at least 1 Correct answer starting from the first answer, also a Taquin question works best with at least 1 Incorrect answer, this would be the last answer. When there is an incorrect answer the user will always have to choose the correct answer. If all answers are correct then the last answer will be a give away.
Also there must be a minimum of 3 answers.
Note: Starting from the first Incorrect answer all subsequent answers will also be Incorrect.
Add: Opens the Add An Answer dialog box, which you can use to add an answer.
Edit: Opens the Edit The Answer dialog box, which you can use to change the answer.
Hint: Double clicking on an answer in the Possible answers box will also open the Edit the Answer dialog box.
Delete: Deletes the selection from the list of possible answers.

Add/Edit the Answer:

Add or edit the text to be displayed. If the answers are fields then this will be the text of the field and you may enter more than one line of text. When the answers are buttons then this text is the Caption of the button.
To designate the response as correct or incorrect, click the Correct/Incorrect icon.

 
5. Scoring tab:  Now define your score.

Score this question: Specifies if the question is to be scored.
Score first attempt only: When checked and only if Score this question is also checked, then only the first attempt at selecting the correct answer is scored. Otherwise if the correct answer is selected within the Limit Tries per answer value then the answer is scored.
Possible answers: Displays the possible answers that were defined under the Answers tab.
Hint: Double click on an answer to go to the Edit the Answer dialog box from the Answers tab.
Weight of Answer: Specifies the percentage of the maximum score to be applied to the answer. Select Automatic for automatic weighting of the question.
Lowest possible score: If the question is to be scored, set a minimum score for the question by typing a number in the Lowest Possible Score box.
Highest possible score: If the question is to be scored, set a maximum possible score by typing a number in the Highest Possible Score box.
Partially correct response: Select how a partially correct response is to be scored.

 
6. Immediate Feedback tab:  Now define your feedback.

The Taquin question is unique because other than the first answer object all of the answer objects can have feedback for correct, incorrect or Auto Answered. This is dependent on the order in which the user selects the answers.
This is best described using an example of 3 answers where the first and second are correct and the third is incorrect and the Limit tries per answer = 2, each number indicates a click or selection:
1. User selected first answer - <Correct>
2. User selected third answer - <Incorrect>
3. User selected third answer - <Auto Answer>
At this point the second answer will move to its correct location and the third answer will disappear leaving only the correct answers.

Enable feedback: Causes feedback to be delivered at the time of response
Answer feedback: Lists the three types of feedback for each answer.
Correct: When the selected answer is correct.
Incorrect: When the selected answer is incorrect.
Auto Answered: When the Limit Tries per answer has been reached.
Play Media Clip: Specifies the clip to play for the selected response. To choose a clip.
Feedback Text: Specifies the text that is to be displayed for the selected response. To add or edit the text, click ... button (opens the standard ToolBook question Feedback Text dialog box).
Send OpenScript: Specifies the OpenScript message to send to the question for the selected response. To add or edit the message, click ... button (opens the standard ToolBook Send Message dialog box).
Go To Page: Specifies the hyperlink to execute for the selected response. To add or edit the hyperlink, click ... button (opens the standard ToolBook Hyperlink dialog box).
Of Book: Displays the book that owns the specified hyperlink page.

 
7. Delayed Feedback tab:  Now define your delayed feedback.

Feedback to execute: Allows you to deliver different types of delayed feedback depending on the number of correct responses to the question.
The three response types are: All Correct, All Incorrect and Partially Correct.

Play Media Clip: Specifies the clip to play for the selected response. To choose a clip.
Feedback Text: Specifies the text that is to be displayed for the selected response. To add or edit the text, click ... button (opens the standard ToolBook question Feedback Text dialog box).
Send OpenScript: Specifies the OpenScript message to send to the question for the selected response. To add or edit the message, click ... button (opens the standard ToolBook Send Message dialog box).
Go To Page: Specifies the hyperlink to execute for the selected response. To add or edit the hyperlink, click ... button (opens the standard ToolBook Hyperlink dialog box).
Of Book: Displays the book that owns the specified hyperlink page.

 
8. Addition Details tab:  Enter the text for the main question here and enter additional hint/question text for each step/answer.

Layout: When clicked the layout dialog will open and allow various options for the layout of the Taquin question.
Note: this button is disabled when answers are added or deleted. After adding or deleting answers and the OK button is clicked, a prompt will ask if you would like to revise the layout.
Auto size on: When checked and whenever you size any of the objects in the Taquin question (except for the main question field) all objects are sized correctly. See Sizing Hints
Save rich text: Turn this feature on when you wish to include rich text in the answer fields or if the answers are buttons and you wish to use graphics. The answers a ordinary ToolBook fields or buttons and you maintain the rich text as you would with any ToolBook field or button. This is done at author level and not in the Taquin Editor.
Please note: you will loose any rich text in the fields each time you open the editor and click on the OK button. Therefore you should ensure that you are happy with the question before you add any rich text.
Main Question: Enter the text for the main question.
Hint/question text: Enter additional hint or question text for each answer.
Edit: Opens the Edit The Correct Position text dialog box, which you can use to change the answer question text.
Hint: Double clicking on an answer in the Possible answers box will also open the Edit The Correct Position text dialog box. This allows you to specify addition details about the answer to assist the user in selecting the correct answer.
Clear: This will clear the text for the selected correct position.


Sizing Hints
When sizing the Taquin question and the “Auto size on” is checked there are a number of options to achieve the desired result.
1. Size the entire Taquin group.
2. Size the "Elements" group, this is the group that contains the answers.
3. Size the "CorrectPosn" group, this is the group under the "Elements" group.
4. Size an object from either the "Elements" group or the "CorrectPosn" group.

What happens with the above options:
1. No automatic sizing will be activated as you have already sized all objects.
2. The objects in the "CorrectPosn" group will be sized based on the objects in the "Elements" group.
3. The objects in the "Elements" group will be sized based on the objects in the "CorrectPosn" group.
4. All objects in the parent group will be re-sized based on the new size of the object you have just sized, and the objects of other group will be re-sized based on the object you have just sized.
eg. If you size an "Answer" object then all "Answer" objects will be re-sized to the new size and all of the objects in the "CorrectPosn" group will also be sized correctly.

Note: correctly means that the position and size is correct based on the corresponding object in the other group.

Therefore, if you size an answer too big (width and/or height) and it will overlaps other answer objects, then all of the objects will be re-sized and they will overlap each other. There is no scripts to fix this, so you have to re-size the answer object so there is no overlap and then re-size the whole “Elements” group.

If you find that text has been truncated (textOverflow <> 0) then you will need to re-size using the above options.
If the truncated text is in the "CorrectPosn" group you can move the "Elements" group off screen so you can see all of the fields and then re-size the "CorrectPosn" group. The "Elements" group will always find the correct position when you finish sizing.

 
9. Layout dialog:

This dialog will allow you to arrange the Taquin question. The green rectangle represents your working screen and the Taquin on that screen. This dialog is provided for layout only and the data displayed is for the Taquin question on your working page, therefore any updates will not be shown here. If you have added or deleted answers then you will not be able to access this dialog until after the update.
Note that you must Apply any changes and this will immediately update the Taquin question in your main page.

The Taquin or screen area: This section will display the Taquin from your main page. After selecting the layout type each answer will have a small circle in the centre. The first circle is red and the second is blue with a red circumference, all others are yellow. These indicate answers 1, 2, 3, etc. and show the direction and order of the answers. For type RC and CR there is also an angled line that shows the path. For type O (Oval) you may drag the points around the circumference. Right click on the Taquin (not the points) to display a bounding box that will allow you to move the question. For type O you may also re-size and shape the oval.
Type: Select the type of layout. There are three types:
RC: Row/Column order.
CR: Column/Row order.
O: Oval shaped.
Show/Hide: This will display the options and points for the given type.
Columns: For type RC and CR:
Use the spin buttons to adjust the number of columns.
Rows: For type RC and CR:
Use the spin buttons to adjust the number of rows.
Spaces: For type RC and CR:
Use the spin buttons to adjust the space between each question, these are page units.
Grid On: For type O:
This will display a grid on the oval to assist with alignment.
Lines On: For type O:
This will display lines from the centre of the oval to each point to also assist with alignment.
Link Points: For type O:
Each point will retain its relational angle to other points, this allows you to rotate all points or just move individual points.
Clockwise: For type O:
When the question has been answered all of the answers are displayed clockwise.
Reset Taquin: Reset the Taquin, allows you to play with the layout.

 

FAQs, Troubleshooting, and Tech Support Tips

Please see the ToolBookDeveloper.com Knowledge Base for additional assistance in using the Taquin Question Object.


Privacy Statement

© 2002-2012 Nirvana Bound PTY LTD