Index: openacs-4/packages/assessment/www/doc/item_types.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/item_types.html,v diff -u -N -r1.1 -r1.2 --- openacs-4/packages/assessment/www/doc/item_types.html 13 Jun 2004 23:20:44 -0000 1.1 +++ openacs-4/packages/assessment/www/doc/item_types.html 21 Jul 2004 09:20:38 -0000 1.2 @@ -7,7 +7,9 @@

Overview

-This is a list of item types and their attributes we want to support. +This is a list of item types and some +of their attributes we want to support (a full list is stored +with the design specifications). At a later stage we are going to add the checks for each item_type to this page as well. This does not mean we are going to create all of them in the first shot. The attributes are *ONLY* those which are not @@ -30,32 +32,26 @@ long (text area) elements in the html form. Here are several configuration options the authoring environment will support (in addition to many others, such as alignment/orientation, required/not -required, etc etc): -

+required, etc etc):

Size of the reply box: Radio buttons to set size of textbox: -small/medium/large; or text area -
Prefilled Answer Box: richtext widget. The content of this field will be prefilled in the response of the user taking the survey --> stored as item_default -
Correct Answer Box: richtext widget. The person correcting the answers will see the contents of this box as correct answer for -comparison with the user response. -> stored as feedback_text -
[NTH nice to have?]: Button to add predefined comments next to the correct answer box. This would be shown to the manual corrector to quickly choose from when manually scoring the answer. What kind of comments would these be? Should they be categorized entries in the "message" system that admin users would populate over time, that would be stuck into the authoring UI dynamically during Assessment -creation? -

Short Answer Item:

Short Answer Items allow the user to give a short answer to an @@ -67,55 +63,45 @@ enables us to have Fill-in-the-blank items. In addition to supporting automated validation/grading, this item type differs from "Open Questions" in that only textboxes are -supported -- meaning short answers, no text area essays. -

+supported -- meaning short answers, no text area essays.

Number of Answerboxes: Integer Selectbox. This will control how many answer boxes the respondee will see. I don't agree here; there needs to be one answer box per Item; if a "question" involves more than one answer box, it is actually a group of Items that needs to be implemented as a Section of Items. So this -selector needs to be in the section-edit UI, not item-edit. -
Upper/Lowercase: Radio boolean. This will control, whether we treat the response case sensitive when comparing it to the correct -answers or not. -
The questioneer has the option to define multiple possible correct answers that will be matched with the response of the user in various ways. For each of the possible answers the following fields are given (among others):
- Answer: short_text. This contains the answer string that -will be matched against the response -
- Data type: integer vs real number -
- Data type: integer vs real number
- Value in %: short integer: How many percentage points a -match will awarded. -
- Size: Integer Select: size of the input box (small, medium, large)
- Compare by: Select (equal, contains, regexp). This defines how the comparison between the answer string and the response shall happen.
- Optional Lower bound value; lower bound comparator -
- Optional upper bound value; upper bound comparator -
- Optional Lower bound value; lower bound comparator
- Optional upper bound value; upper bound comparator
- Allow in answerbox: (multiple select box with "All" and the numbers from 1 to x where x is the number of answerboxes from above. For sure this only works with JS enabled :)). Defines the answerboxes the user can fill out that shall be matched with this answer. I don't follow this exactly, but I think the comments about Sections of Items -above applies here also. -

Matching Item:

Matching questions are useful for matching some items on the @@ -127,17 +113,16 @@ potential choices (displayed via a select widget; could be radiobutton though too). If there are several such matchings (three phrases <-> three items in the popup select) then this is a Section with -three Items. The UI for this needs to be in section-edit, not item-edit. -

+three Items. The UI for this needs to be in section-edit, not +item-edit.

Settings:
- Distribution of points: boolean (all or nothing / increasing). All or nothing will either give 100%, if all correct answers are given, or 0% else. Increasing will give (number of correct matches / number of -total matches) *100% points. -
- Allow negative: boolean (yes/no). This will allow a negative percentage as well (as the total result).
@@ -146,28 +131,23 @@ settings. Each one will consist of:
- Match item: This is the item which will be displayed on -the left side of the question presented to the respondee. -
- Matched item: This is the correct item from the select box on the right side. For each match item on the left there will be a select box on the right with ALL the matched items (when taking the survey, -that is...) -
In addition to submit, there is another button to allow further answers to be filled in. Typed in values shall be remembered -and 4 more answerboxes be shown. -

File upload item:

A file upload question will allow the respondent to upload a -file. No additional attributes but the usual for every question. -

+file. No additional attributes but the usual for every question.

Multiple Choice items: @@ -182,17 +162,13 @@

Allow Multiple: boolean (yes/no). This will determine if the respondee has the option to choose multiple possible answers for his -response. -

Select Box: boolean (yes/no). Will display a select box -or radio/checkbox otherwise. -

Distribution of points: boolean (all or nothing / +response. In the datamodell this information is stored with the +as_item_display_* object (e.g. along with the checkbox / select).

Increasing: boolean (all or nothing / increasing). All or nothing will either give 100%, if all correct answers are given, or 0% else. Increasing will give (number of correct matches / number of -total matches) *100% points. -

+total matches) *100% points.

Allow negative: boolean (yes/no). This will allow a negative percentage as well (as the total result).

@@ -202,51 +178,43 @@

Correct answer: boolean, radio with grafik (red x, green y) (yes/no). This marks if the current answer is a correct one.

Answer: Richtext widget. Need option to associate -both/either a numeric value and a text value to each choice. -

+both/either a numeric value and a text value to each choice.

Value: percentage value this answer gives to the -respondee -- this is different from the "answer" -

Reply: richtext widget. This is a reply the student can +respondee -- this is different from the "answer"

Feedback_text: richtext widget. This is a reply the +student can see at the end of the test giving him some more information on the question he -choose. -

CR_Item: cr_item. If we have an image it will be shown +choose.

content_value: cr_item. If we have an image it will be +shown instead of the answer text. If we have a sound item, we will generate -audio includes. -

+audio includes.

In addition to submit, there is another button to allow further answers to be filled in. Typed in values shall be remembered -and 4 more answerboxes be shown. -

+and 4 more answerboxes be shown.

[Additional Feature]: Possibility to randomly choose from the options. This would add a couple of fields:

To each answer: Fixed position: Select Box, Choose the mandatory position when displaying the option (e.g. "none of the -above"). -
Number of correct answers: integer, defining how many correct options have to be displayed. Check if enough correct answers have been -defined. -
Number of answers: integer, defining how many options shall be displayed in total (correct and incorrect). Check if enough answers -are available. -
Display of options: Numerical, alphabetic, randomized or -by order of entry. -
All radio button Items must have a "clear" button that unsets all the radiobuttons for the item. (For that matter, every Section and every Assessment also must have -"clear" buttons. Fairly trivial with Javascript.) -

@@ -260,34 +228,26 @@

Rank question:

Rank questions ask for the answers to be ranked. This appears to me to be a special case of the "matching question" in which -the select options are ordinal values, not arbitrary strings. -

+the select options are ordinal values, not arbitrary strings.

Rank Type: Boolean (alphabetic, numeric). Shall the rank be -from a to z or from 1 to n. -
Only unique rank: Boolean (yes/no). Shall the ranking only -allow unique ranks (like 1,2,3,5,6 instead of 1,2,2,4,5) -
Straigth order: Boolean (alphabetic, numeric). Shall the rank be in a straigth order or is it allowed to skip values (1,2,3 vs. -1,3,4) -
For each answer we ask the following questions:
- Answer: Richtext widget. -
- Rank: correct rank -
- Answer: Richtext widget.
- Rank: correct rank
In addition to submit, there is another button to allow further answers to be filled in. Typed in values shall be remembered -and 4 more answerboxes be shown. -

Matrix table (blocked questions):

The idea here @@ -300,43 +260,32 @@ display option for the section that could reasonably be used for any Item Type. For instance, there are situations where an Assessment author may want to group a set of selects, or radiobuttons, or small -textboxes, etc. -

+textboxes, etc.

Composite matrix-based multiple response item:

Same as the matrix table, but you have different choices that -are displayed in each column. -

+are displayed in each column.

Composite multiple choice with Fill-in-Blank item:

Multiple Choice question with an additional short_text input -field. Usually used for the "Other" thing -

+field. Usually used for the "Other" thing

Calculation:

This type of question will not be supported. But we should make sure we can take care of that type while importing the data from WebCT. Therefore we have to know the values. At -a later stage, we will add more info on this. -

+a later stage, we will add more info on this.

Formula: string -
Units -
Value (in %): integer -
Required (boolean) -
Ignore Space (boolean) -
Ignore spell checking (boolean) -
General Feedback: richtext -
Formula: string
Units
Value (in %): integer
Required (boolean)
Ignore Space (boolean)
Ignore spell checking (boolean)
General Feedback: richtext

@@ -351,15 +300,12 @@ Assessment form. And similarly, when the user submits the Assessment form, response data will be stored not only in Assessment entities (as_item_data eg) but also back in the other table (eg users). The -question has the following additional fields: -

+question has the following additional fields:

Table Name: short_string. This is the name of the table that -is beeing used for storing the responses. -
Column: short_string. This is the column of the table that is -used for storing the responses. -
Key Column: short_string. This is the column of the table that matches the user_id of the respondee.