Index: openacs-4/packages/assessment/www/doc/display_types.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/display_types.html,v diff -u -r1.3 -r1.4 --- openacs-4/packages/assessment/www/doc/display_types.html 21 Jul 2004 16:02:49 -0000 1.3 +++ openacs-4/packages/assessment/www/doc/display_types.html 9 Dec 2004 11:09:16 -0000 1.4 @@ -20,7 +20,6 @@ graphic pertaining to the Item Display Types system is available there also.

Item Display Types

Each item has an item_display_type object associated with it, that defines how to display the item. Each item_display_type has a couple of @@ -156,7 +155,6 @@ In addition, there are some potential presentation_types that actually seem to be better modeled as a Section of separate Items:

ranking - a set of alternatives each need to be assigned an exclusive rank ("Indicate the order of US Presidents from bad to @@ -166,18 +164,47 @@ instance).
...

Section display

-A section can be seen as a form with all the +A section can be seen as a form with all the items within this section making up the form. Depending on the type of assessment we are talking about, the section can be displayed in -various ways (examples): +various ways.

Normal survey view, with a description on top.
Test view, which has certain restrictions on the display (e.g. -not allowed to use the back button)
Portlet view, only displaying the items of the section with a -submit button

+The section display page will be made up of the following attributes:
+

Name: text. Name of the section like "test view sorted"
Number of questions per page: integer. THIS HAS TO BE CHANGED IN +THE DATAMODELL FROM PAGINATION_STYLE. How many questions shall be +displayed per page in this section. Usually the answer would be "" for +all questions on one page (default), or "1" for one question per page +(aka one question at a time), but any number is imagineable.
ADP style: ADP to choose +from that will control the makeup of the section along with the option +to create a new one and a link to edit existing ones that Opens a page with the current layout +of +the section in an textarea to be edited. Deferred., was item_orientation, +presentation_type, and item_alignment and item_labels_as_headers_p
+
Sort questions: Select (random, +manual, alphabetic, numerical)<>
<>Back button allowed: boolean (back_button_p). Is the use +of the +back button allowed? If not, the back button should be broken on +purpose and result in an error.
+
Submit Answer seperately: boolean. Shall each answer be answered +seperately, even if we display multiple answers? If yes, display a +"save" button next to each answer along with green "V" if the answer +has been already submitted. To finish the section, you still have to +click on the OK button at the buttom. Once the section is finished all +answers that have not been seperatly submitted will be treated as not +being submitted at all.
+

Additionally each section has certain parameters that determine the look and feel of the section itself. Luckily it is not necessary to have differing attributes for the sections, therefore all Index: openacs-4/packages/assessment/www/doc/user_interface/section_creation.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/user_interface/section_creation.html,v diff -u -r1.1 -r1.2 --- openacs-4/packages/assessment/www/doc/user_interface/section_creation.html 29 Jul 2004 09:35:12 -0000 1.1 +++ openacs-4/packages/assessment/www/doc/user_interface/section_creation.html 9 Dec 2004 11:09:17 -0000 1.2 @@ -8,154 +8,133 @@ Section page. This page is for editing information about a section and -adding questions to it. It contains a couple of subpages. +adding questions to it. It contains a couple of subpages. Datamodell +can be found here.
+
+On the Top of the page display the title and description along with the +display type for information purposes. Below this put links to the +following pages.
+
+The section edit page contains the following Items:

Title: Title of the section +
Title: Title of the section
Description: text used for identification and selection in admin +pages, not for end-user pages
Instructions: text displayed on user pages describing the user +how to fill out the section.
Display Type: +section display type to use. Select box of display types in use by this +user, as well as "new display type" and "display type from catalogue".
Display of the Pre Display Checks (with an edit and a remove -link). +
Seconds allowed for completion: integer. +Seconds allowed for completing the section.
Feedback Text: textarea. Feedback given to the user after +finishing the section.
Number of questions: +Number of questions that will be displayed +in this section. Only useful if we randomize. If the +number of questions added to this section is higher than number of +questions to display then we randomly pick from the questions, but +definitely add the mandatory questions.
+

+The branch conditions page allows the conditions to be added under +which this section will be called (branch conditions). This is still +work in progress and will not be developed in the first phase.
+

Sequencing +Information

Add new Pre Display Check.

Add new Post Display Check. (See the sequencing -documenation for this).
-

Use one or all conditions: boolean. Is it mandatory that all +

Display of the Pre Display +Checks (with an edit and a remove +link).
Add new Pre Display Check.
Add new Post Display Check.
+
Use one or all conditions: +boolean. Is it mandatory that all conditions have been met or is one condition enough (for not displaying -this section)
-
Add question(s) from question database: Link to the search page -which allows to search for questions that can be added to this section -(multiple add possibility). -
Add question: Link to the question catalogue entry form with a -return_url that adds the question from the catalogue to this section -and return to the section page. -
Sort questions: Select (random, manual, alphabetic, numerical) -
Number of questions: Number of questions that will be displayed -in this section. Only useful if we randomize. -
Custom Template: link. Opens a page with the current layout of -the section in an textarea to be edited -
At the buttom display all questions that have been added to this -section with the following items -
- Change order of questions (arrow navigation) -
- Title of the question -
- Link to edit question properties with regards to this section -
  - Points: integer. Number of Points this question is worth -in the section -
  - Mandatory: boolean (yes/no). Is this question mandatory -in this section. It will be displayed in any case, regardless of -randomizing. -
  - Fixed Position: select (1,2..., buttom). Position the -question has to be displayed, regardless of randomizing. -
  -
-

-The branch conditions page allows the conditions to be added under -which this section will be called (branch conditions). You have two -general options +

Branch by question. This kind of branch depends on previous +
Branch by question. This kind of +branch depends on previous answers. A table of all multiple choice / boolean questions will be given to the creator along with their possible answers.
- Each question has a checkbox to determine if this question shall be included in this branch condition and a radio button, if all answers or just one have to be given (e.g. if we have multiple correct answers, we might want to branch into this section all answers have -been selected by the respondee or just one). -
- The answers have checkboxes, with the correct answers checked by default for multiple choice question. All other questions will only be displayed if they give a percentage value to the answer. In this case a textfield is given with the possibility to give a range (10-100) -or seperate percentages (10, 100, 200). -
- The display of this section depends on whether the valid answers have been given to all or just one of the questions that have been checked (as you might have guessed, we need a radio button for -this below the table). -
Questions that will be displayed depend on the position of the section. Only questions that could have been answered in the assessment before -this section is displayed will be shown. -
Branch by result. Instead of relying on one or multiple answers +this section is displayed will be shown.
Branch by result. Instead of +relying on one or multiple answers we check for a result in a previous section. This can only work in a test environment (so don't display this option if we are not dealing with a test).
- Section: select. This will display a list of all previous -sections. The selected section will be used for the computation. -
- Calculation: select (median, distractor, absolut number of points). What shall be computed to determine whether the user is -allowed to see this section. -
- From / To value: integer. Two fields to display the valid -range for which this section will be displayed to the user. -
It is imagineable that a combination of both methods makes sense, -so we should take this into account when creating the UI. -
It is imagineable that a +combination of both methods makes sense, +so we should take this into account when creating the UI.

-
-

Order of creation: sections and questions

Requiring the questions to be written first -before the sections are created by selecting and "inserting" the -questions into the section is reasonable. But it would also be very -useful to be able to import entire sections from other assessments into -a new assessment. In clinical trials, there are sets of questions that -show up in many forms, and it shouldn't be necessary to recreate these -sets every time a new assessment is being designed.

I think that the data model should provide catalogues of all levels -of the hierarchical assessment structures to support, say, inserting -one entire assessment into the middle of another. This seems like a -generalization of the mechanism you suggest here.

-- Stan Kaufman -on November 18, 2003 05:19 PM (view -details)

Branch conditions

-It seems to me that there are two types of branch conditions: -

+
+Below this information we have a paragraph where all questions are +displayed with the options to
+

Single item branch points: a user's response evaluates -against some criteria (is choice n; is < 50 or > 200; regexps to -some string; etc) and this evaluation then directs the user down 1-m -paths. +
Edit +question
+
Search and add question(s) from question database: Link to the +search page +which allows to search for questions that can be added to this section +(multiple add possibility).
Add question: Link to the question catalogue entry form with a +return_url that adds the question from the catalogue to this section +and return to the section page.
Multiple item branch points: a user's responses to 2-m -items (located in 1-n sections) all evalute against some criteria to -direct the user down 1-m paths: (if item a response is A and item b is -B, then route C) +
Change order of questions (arrow navigation) Title of the +question Link to edit question properties with regards to this section
Points: integer. Number of Points this question is worth in this +section.
Mandatory: boolean (yes/no). Is this question mandatory +in this section. It will be displayed in any case, regardless of +randomizing.
Fixed Position: select (1,2..., buttom). Position the +question has to be displayed, regardless of randomizing.

-The datamodel and UI must thus support creating and processing a) these -criteria; and b) the paths. This seems more or less to be what you've -said, I think. -

-- Stan Kaufman -on November 18, 2003 05:32 PM (view -details)