Index: openacs-4/packages/assessment/www/doc/as_items.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/as_items.html,v
diff -u -N -r1.4 -r1.5
--- openacs-4/packages/assessment/www/doc/as_items.html 28 Jul 2004 10:35:57 -0000 1.4
+++ openacs-4/packages/assessment/www/doc/as_items.html 29 Jul 2004 09:35:10 -0000 1.5
@@ -3,7 +3,7 @@
@@ -178,7 +178,7 @@
cr::name - Identifier
- as_item_default: The content of this
+ default_value: The content of this
field will be prefilled in the response of the user taking the survey
feedback_text: The person correcting
the answers will see the contents of this box as correct answer for
@@ -407,7 +407,7 @@
"small","medium","large". Up to the developer how this translates.
item_answer_alignment - the orientation between the
-"question part" of the Item (the item_text/item_subtext) and the
+"question part" of the Item (the title/subtext) and the
"answer part" -- the native Item widget (eg the textbox) or the 1..n
choices. Alternatives accommodate L->R and R->L alphabets (or is
this handled automagically be Internationalization?) and include:
@@ -455,7 +455,7 @@
Templating widgets here.
item_answer_alignment - the orientation between the
-"question part" of the Item (the item_text/item_subtext) and the
+"question part" of the Item (the title/subtext) and the
"answer part" -- the native Item widget (eg the textbox) or the 1..n
choices. Alternatives accommodate L->R and R->L alphabets (or is
this handled automagically be Internationalization?) and include:
@@ -493,7 +493,7 @@
by order of entry (sort_order field).
item_answer_alignment - the orientation between the
-"question part" of the Item (the item_text/item_subtext) and the
+"question part" of the Item (the title/subtext) and the
"answer part" -- the native Item widget (eg the textbox) or the 1..n
choices. Alternatives accommodate L->R and R->L alphabets (or is
this handled automagically be Internationalization?) and include:
@@ -518,7 +518,7 @@
by order of entry (sort_order field).
item_answer_alignment - the orientation between the
-"question part" of the Item (the item_text/item_subtext) and the
+"question part" of the Item (the title/subtext) and the
"answer part" -- the native Item widget (eg the textbox) or the 1..n
choices. Alternatives accommodate L->R and R->L alphabets (or is
this handled automagically be Internationalization?) and include:
@@ -543,7 +543,7 @@
it allow to select multiple values ?
item_answer_alignment - the orientation between the
-"question part" of the Item (the item_text/item_subtext) and the
+"question part" of the Item (the title/subtext) and the
"answer part" -- the native Item widget (eg the textbox) or the 1..n
choices. Alternatives accommodate L->R and R->L alphabets (or is
this handled automagically be Internationalization?) and include:
@@ -565,7 +565,7 @@
item_answer_alignment
- the orientation between the
-"question part" of the Item (the item_text/item_subtext) and the
+"question part" of the Item (the title/subtext) and the
"answer part" -- the native Item widget (eg the textbox) or the 1..n
choices. Alternatives accommodate L->R and R->L alphabets (or is
this handled automagically be Internationalization?) and include:
@@ -596,7 +596,7 @@
item_answer_alignment
- the orientation between the
-"question part" of the Item (the item_text/item_subtext) and the
+"question part" of the Item (the title/subtext) and the
"answer part" -- the native Item widget (eg the textbox) or the 1..n
choices. Alternatives accommodate L->R and R->L alphabets (or is
this handled automagically be Internationalization?) and include:
Index: openacs-4/packages/assessment/www/doc/data_collection.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/data_collection.html,v
diff -u -N -r1.2 -r1.3
--- openacs-4/packages/assessment/www/doc/data_collection.html 28 Jul 2004 10:35:57 -0000 1.2
+++ openacs-4/packages/assessment/www/doc/data_collection.html 29 Jul 2004 09:35:11 -0000 1.3
@@ -107,7 +107,8 @@
ip_address - IP Address of the entry
percent_score - Current percentage of the subject achieved so
-far
+far
+ consent_timestamp - Time when the consent has been given.
@@ -138,13 +139,15 @@
item_id
choice_id_answer - references as_item_choices
boolean_answer
- clob_answer
numeric_answer
integer_answer
- varchar_answer
- text_answer
+ text_answer
timestamp_answer
- content_answer - references cr_revisions
+ content_answer - references cr_revisions
+ signed_data - This field stores the signed entered data, see
+below for explanation
+ percent_score
+
Possible Extension: item_status - Status of the answer. This
might be
"unanswered, delayed, answered, final". This can be put together with
-
-
+
-
+ style="width: 797px; height: 565px;">
@@ -38,73 +35,138 @@
where all versions potentially are equally-important siblings. In the
case of the Assessment package, it seems likely that in some
applications, users would indeed want to designate a single "live"
-version, while in many others, they wouldn't. However, a given revision
-can be chosen many easy ways other than looking at cr_items, while
-being forced to create and maintain appropriate state in cr_items when
-an application doesn't want it would be a major complication. Thus,
-using the cr_revisions part of the CR alone seems to be the most useful
-approach here. This decision pertains to all entities using the CR, but
-it is particularly important with Assessments since they are the key to
-all the rest of the entity hierarchies.
-
+version, while in many others, they wouldn't.
Attributes of Assessments will include those previously included
-in Surveys plus some others:
-
-
+in Surveys plus some others:
- - assessment_id
+
- assessment_id
+ - cr:name - a curt name appropriate for urls
- - name - a formal title to use in page layouts etc
-
- - short_name - a curt name appropriate for urls
-
- - author
-
- - definition - text that can appear in introductory web pages
-
+ - cr:title - a formal title to use in page layouts etc
+ - creator_id - Who is the "main" author and creator of this
+assessment
+ - cr:description - text that can appear in introductory web
+pages
- instructions - text that explains any specific steps the
-subject needs to follow
-
- - scaled_p - whether some kind of scoring algorithm is defined
-(ie "grading" or other schemes)
-
- - mode - whether this is a standalone assessment (like current
+subject needs to follow
+ - mode - whether this is a standalone assessment (like current
surveys), or if it provides an "assessment service" to another OpenACS
-app, or a "web service" via SOAP etc
+app, or a "web service" via SOAP etc
+ - editable_p - whether the response to the assessment is
+editable once an item has been responded to by the user.
+ - anonymous_p - This
+shows whether the creator of the accessment will have
+the possibility to see the personal details of the respondee or not. In
+particular this will exclude the user_id from the CSV files. It shall
+still be possible to see the user that have not finished the survey
+though.
+ - secure_access_p - The
+assessment can only be taken if a secure connection (https) is used.
+ - reuse_responses_p -
+If
+yes, the system will look for previous responses to the
+the questions and prefill the last answer the respondee has given in
+the assessment form of the respondee
+ - show_item_name_p - If
+yes, the respondee will see the name of the item in
+addition to the item itself when taking the survey.
+ - entry_page - The customizable entry page that will be
+displayed before the first response.
+ - exit_page - Customizable exit / thank you page that will be
+displayed once the assessment has been responded.
+ - consent_page -
- - validated_p - whether this is a formal "instrument" like an
-eponymous test (eg "Seattle Angina Questionnaire" or "MMPI" etc; this
-means that alterations to this Assessment are not allowed since changes
-would invalidate the Assessment
-
- - enabled_p - released for actual use?
-
- - editable_p - can anyone alter it further?
-
- - template - references as_templates - ?not entirely clear
-how/why we want to use this
-
+ - return_url - URL the respondee will be redirected to
+after finishing the assessment. Should be redirected directly if no
+Thank you page is there. Otherwise the return_url should be set in the
+thank you page context, so we can have a "continue" URL.
+ - start_time - At what time shall the assessment become
+available to the users (remark: It will only become available to the
+users who have at least the "respond" priviledge.
+ - end_time - At what time the assessment becomes unavailable.
+This is a hard date, any response given after this time will be
+discarded.
+ - number_tries - Number of times a respondee can answer the
+assessment
+ - wait_between_tries - Number of minutes a respondee has to
+wait before he can retake the assessment.
+ - time_for_response - How many minutes has the respondee to
+finish the assessment (taken from the start_time in as_sessions).
+ - show_feedback - Which feedback_text stored with the item_type
+shall be displayed to the respondee (All, none, correct, incorrect).
+Correct and Incorrect will only show the feedback_text if the response
+was correct or incorrect.
+ - section_navigation
+- How shall the navigation happen
+
+
+ - default
+path - Order given by the relationship between assessment and section
+(the order value in cr_rels, if this is used).
+
+ - randomized
+- Sections will be displayed randomly
+ - rule-based
+branching - Sections will be displayed according to inter-item-checks.
+This should be default.
+
-
-Permissions / Scope: Control of reuse previously was through a
+
+
+ Style Options (as_assessment_styles): Each assessment has a
+special style associated with it. As styles can be reused (e.g. within
+a department) they are covered in the as_assessment_styles:
+
+
+
+ - custom_header - Custom header (and footer)
+that
+will be displayed the the respondee when answering an assessment.
+Possibility to include system variables (e.g. first name).
+
+ - custom_footer
+
+ - form_template - Style (form_template) that will be
+used for this assesment. You can either select an existing one or
+upload a new style as well as edit the currently choosen one (no
+datamodell but UI thought).
+
+ - progress_bar: What
+kind of progress bar shall be
+displayed to the respondee while taking the assessment (no
+progress bar, different styles).
+ - presentation_style:
+These
+options allow the respondee to select between different presentation
+styles. At least one of the checkboxes mentioned below has to be
+selected.
+
+ - All questions at once
+ - One question per page. If you have selected respondee may
+not
+edit their reponses, it will not be possible for them to go back and
+choose another answer to that question.
+ - Sectioned
+
+
+ <>>
+
+ Permissions / Scope: Control of reuse previously was through a
shareable_p boolean. As with Items and Sections, we instead will use
-the acs permission system:
-
-
- - Read: An assessment author (who is granted this permission)
+the acs permission system:
+
+ - Read: An assessment author (who is granted this permission)
can
reuse this assessment (NB: Usually the original author has admin
-priviledges.)
-
- - Write: Author can reuse and change this assessment.
-
- - Admin: Author can reuse, change and give permission on this
-assessment
-
-
-
-
-
+priviledges.)
+ Write: Author can reuse and change this assessment.
+ Admin: Author can reuse, change and give permission on this
+assessment
+ Respond: The user can respond to the survey.
+
+
+
Sections (as_sections) represent logically-grouped
set of Items that always need to be present or absent together in the
Assessment. Sections thus divide at logical branch points. These branch
@@ -115,57 +177,40 @@
Section may be presented one-by-one in different pages; pagination is
thus related but not equivalent to Section definitions and in fact is
an attribute of a Section. Well, more accurately, of a Section Display
-Type (see below). Attributes of Sections themselves include:
-
+Type (see below). Attributes of Sections themselves include
+ e:
- - section_id
-
+ - section_id
- section_display_type_id - references
-as_section_display_types
-
- - name - used for page display
-
+as_section_display_types
+ name - used for page display
definition - text used for identification and selection in
-admin pages, not for end-user pages
-
- instructions - text displayed on user pages
-
- enabled_p - good to go?
-
+admin pages, not for end-user pages
+ instructions - text displayed on user pages
+ enabled_p - good to go?
required_p - probably not as useful as per-Item required_p
but maybe worth having here; what should it mean, though? All Items in
a required section need to be required? At least one? Maybe this isn't
-really useful.
-
+really useful.
content_value - references cr_revisions: for an image, audio
-file or video file
-
- numeric_value - optional "number of points" for section
-
- feedback_text - optional preset text to show user
-
+file or video file
+ numeric_value - optional "number of points" for section
+ feedback_text - optional preset text to show user
max_time_to_complete - optional max number of seconds to
-perform Section
-
+perform Section
-
-Permissions / Scope: Control of reuse previously was through a
+
Permissions / Scope: Control of reuse previously was through a
shareable_p boolean. As with Items and Assessments, we instead will use
-the acs permission system:
-
+the acs permission system:
- Read: A section author (who is granted this permission) can
reuse
-this section (NB: Usually the original author has admin priviledges.)
-
- - Write: Author can reuse and change this section.
-
+this section (NB: Usually the original author has admin priviledges.)
+ - Write: Author can reuse and change this section.
- Admin: Author can reuse, change and give permission on this
-section
-
+section
-
-
+
Section Display Types (as_section_display_types)
define types of display for an groups of Items. Examples are a
@@ -177,45 +222,33 @@
grid (see the SAQ for an
illustration of this).
This entity is directly analogous in purpose and design to
-as_item_display_types.
-
-
+as_item_display_types.
- - section_display_type_id
-
+ - section_display_type_id
- section_type_name - name like "Vertical Column" or
-"Depth-first Grid" or "Combo Box"
-
+"Depth-first Grid" or "Combo Box"
pagination_style - all-items; one-item-per-page; variable
-(get item groups from mapping table)
-
+(get item groups from mapping table)
branched_p - whether this Section defines a branch point (so
that the navigation procs should look for the next step) or whether
this Section simply transitions to the next Section in the sort_order
(it may be better not to use this denormalization and instead always
look into the Sequencing mechanism for navigation -- we're still fuzzy
-on this)
-
+on this)
item_orientation - the pattern by which 2..n Items are laid
out when displayed. Note that this isn't a purely stylistic issue
better left to the .adp templates or css; the patterns have semantic
implications that the Assessment author appropriately should control
here.
-
- - horizontal - all Items are in one line
-
- - vertical - all Items are in one column
-
+ - horizontal - all Items are in one line
+ - vertical - all Items are in one column
- matrix_col-row - Items are laid out in matrix, filling
-first col then row
-
+first col then row
matrix_row-col -Items are laid out in matrix, filling
-first row then col
-
+first row then col
-
-
+
item_labels_as headers_p - whether to display labels of
the Items; if not, a "grid of radiobuttons" gets displayed. See
@@ -226,99 +259,66 @@
the radiobuttons (or checkboxes) only -- without their labels --
displayed in a grid (see this
-example).
-
-
+example).
presentation_type - may actually be superfluous...gotta
think more about this, but there's at least one example:
-
- ranking - a set of alternatives each need to be assigned
an
exclusive rank ("Indicate the order of US Presidents from bad to
worse"). Is this one Item with multiple Item Choices? Actually, not,
since each alternative has a value that must be separately stored (the
tester would want to know that the testee ranked GWB last, for
-instance).
-
- - what others?
-
+instance).
+ what others?
-
-
+
item_alignment - the orientation between the "section
description part" of the Section (if any) and the group of Items.
Alternatives accommodate L->R and R->L alphabets (or is this
handled automagically be Internationalization?) and include:
-
- - beside_left - the Items are left of the "heading"
-
- - beside_right - the Items are right of the "heading"
-
- - below - the Items are below the "heading"
-
- - above - the Items are above the "heading"
-
+ - beside_left - the Items are left of the "heading"
+ - beside_right - the Items are right of the "heading"
+ - below - the Items are below the "heading"
+ - above - the Items are above the "heading"
-
-
+
display_options - field to specify other stuff like the grid
-dimensions ("rows=10 cols=50" eg)
-
+dimensions ("rows=10 cols=50" eg)
-
-
-
+
Item Section map (as_item_section_map) defines 1..n Items to a
Section, caches display code, and contains optional overrides for
Section and Item attributes:
- - item_id
-
- - section_id
-
- - enabled_p
-
- - required_p - whether Item must be answered
-
- - item_default
-
- - content_value - references CR
-
+ - item_id
+ - section_id
+ - enabled_p
+ - required_p - whether Item must be answered
+ - item_default
+ - content_value - references CR
- numeric_value - where optionally the "points" for the Item
-can be stored
-
- - feedback_text
-
- - max_time_to_complete
-
- - adp_chunk - display code
-
- - sort_order
-
+can be stored
+ feedback_text
+ max_time_to_complete
+ adp_chunk - display code
+ sort_order
-
-
+
Section Assessment Map (as_assessment_section_map) basically is
a standard map, though we can override a few Section attributes here if
desired:
-
- - assessment_id
-
- - section_id
-
- - feedback_text
-
- - max_time_to_complete
-
- - sort_order
-
+ - assessment_id
+ - section_id
+ - feedback_text
+ - max_time_to_complete
+ - sort_order
Index: openacs-4/packages/assessment/www/doc/index.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/index.html,v
diff -u -N -r1.2 -r1.3
--- openacs-4/packages/assessment/www/doc/index.html 3 Jul 2004 22:38:06 -0000 1.2
+++ openacs-4/packages/assessment/www/doc/index.html 29 Jul 2004 09:35:11 -0000 1.3
@@ -68,8 +68,7 @@
packages. In particular, incorporating Workflow and a new data
collection package would be key to creation of new vertical-application
tools like dotWRK. Such integration would also be immensely useful for
-a clinical trials management toolkit.
-
+a clinical trials management toolkit.
@@ -112,28 +111,20 @@
Surveys included several important enhancements to the data model:
- Conditional branching within a survey (though how well
-worked out this is remains unclear)
-
- - "Folder" based repositories of questions and sections
-
+worked out this is remains unclear)
+ - "Folder" based repositories of questions and sections
-
-However, Surveys has some important limitations:
-
+ However, Surveys has some important limitations:
- Surveys are "published" as static HTML files which are
-served out to users when they complete the survey
-
- - The package doesn't use a templating system
-
- - Oracle-only
-
+served out to users when they complete the survey
+ - The package doesn't use a templating system
+ - Oracle-only
Still, this package adopts some naming conventions consistent
with
the IMS spec and definitely represents the closest effort to a "complex
-survey" done to date.
-
+survey" done to date.
"Complex Survey". This is the descendant of
@@ -144,8 +135,7 @@
incorporates a number of the features of Surveys. We discuss it in
greater detail here.
-
-
+
Questionnaire. This is a 3.2.5 module developed at The Epimetrics Group in order to
@@ -192,19 +182,29 @@
Data modell
The data modell is described in detail in the design descriptions.
-User Interface
+
The UI for Assessment divides into a number of primary functional
-areas, as diagrammed below. These include:
+areas, with the entry page located here.
+It is split up into multiple sections:
- - the "Home" area (for lack of a better term). These are the main
-index pages for the user and admin sections
- - Assessment Authoring: all the pages involved in creating,
-editing, and deleting the Assessments themselves; these are all admin
-pages
- - Assessment Delivery: all the pages involved in
+
- Assessment
+Authoring: all the pages involved in creating,
+editing, and deleting the Assessments themselves
+ - Section Authoring:
+all the pages involved in creating,
+editing, and deleting the Sections themselves. Includes the page to
+browse for items to include in sections
+ - Item Authoring and
+Catalogue: all the pages involing the item creation and the item
+catalogue.
+ - Assessment Delivery:
+all the pages involved in
deploying a given Assessment to users for completion, processing those
results, etc; these are user pages
- - Assessment Review: all the pages involved in select
+
- Section on Tests:
+Currently still split away, some notes on additional user interface for
+test. Shall be integrated with the rest of the pages.
+ - Assessment Review: all the pages involved in select
data extracts and displaying them in whatever formats indicated; this
includes "grading" of an Assessment -- a special case of data review;
these are admin pages, though there also needs to be some access to
@@ -215,15 +215,13 @@
other "policies" of an Assessment. This area needs to interact with the
next one in some fashion, though exactly how this occurs needs to be
further thought through, depending on where the Site Management
-mechanisms reside.
- - Site Management: pages involved in setting up who
-does Assessments. These are admin pages and actually fall outside the
-Assessment package per se. How dotLRN wants to interact with Assessment
-is probably going to be different from how a Clinical Trials Management
-CTM system would. But we include this in our diagram as a placeholder.
+mechanisms reside.
-More information can be found at the Page Flow
-page.
+
+The Page Flow
+page is diagrammed below and should give a very rough and outdated
+overview, but still good for getting an impression.
+
Authors
The specifications for the assessment system have been written by Stan
Kaufman and Malte Sussdorff with help from numerous people within and
Index: openacs-4/packages/assessment/www/doc/page_flow.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/assessment/www/doc/page_flow.html,v
diff -u -N -r1.1 -r1.2
--- openacs-4/packages/assessment/www/doc/page_flow.html 13 Jun 2004 23:20:44 -0000 1.1
+++ openacs-4/packages/assessment/www/doc/page_flow.html 29 Jul 2004 09:35:11 -0000 1.2
@@ -14,15 +14,12 @@
package will use these OpenACS standards:
- - "trail of breadcrumb" navigational links
-
+ - "trail of breadcrumb" navigational links
- context-aware (via user identity => permissions) menu
options (whether those "menus" are literally menus or some other
-interface widget like toolbars)
-
+interface widget like toolbars)
- in-place, within-form user feedback (eg error messages about a
-form field directly next to that field, not in an "error page")
-
+form field directly next to that field, not in an "error page")
Furthermore, the set of necessary pages for Assessment are not all
that dissimilar to the set required by any other OpenACS package. We
@@ -46,44 +43,59 @@
- the "Home" area (for lack of a better term). These are the main
-index pages for the user and admin sections
-
- - Assessment Authoring: all the pages involved in creating,
+index pages for the user and admin sections
+ - Assessment
+Authoring: all the pages involved in creating,
editing, and deleting the Assessments themselves; these are all admin
-pages
-
+pages
- Assessment Delivery: all the pages involved in
deploying a given Assessment to users for completion, processing those
-results, etc; these are user pages
-
+results, etc; these are user pages
- Assessment Review: all the pages involved in select
data extracts and displaying them in whatever formats indicated; this
includes "grading" of an Assessment -- a special case of data review;
these are admin pages, though there also needs to be some access to
data displays for general users as well (eg for anonymous surveys etc).
Also, this is where mechanisms that return information to "client"
-packages that embed an Assessment would run.
-
+packages that embed an Assessment would run.
- Session Management: pages that set up the timing and
other "policies" of an Assessment. This area needs to interact with the
next one in some fashion, though exactly how this occurs needs to be
further thought through, depending on where the Site Management
-mechanisms reside.
-
+mechanisms reside.
- Site Management: pages involved in setting up who
does Assessments. These are admin pages and actually fall outside the
Assessment package per se. How dotLRN wants to interact with Assessment
is probably going to be different from how a Clinical Trials Management
-CTM system would. But we include this in our diagram as a placeholder.
-
+CTM system would. But we include this in our diagram as a placeholder.
-
-So this is how we currently anticipate this would all interrelate:
+In addition to the page flow we have two types of portlets for .LRN:
+
+ - Portlet for the respondee with all assessments that have to be
+answered and their deadlines.
+ - Portlet for staff with all assessments that have to be reviewed
+with review deadline and number of responses still to look at.
+
+More Ideas:
+
+
+ - Possibility to browse assessments and
+sections by category.
+
+
+
+
+
+
+
+
+So this is how we currently anticipate this would all
+interrelate:
-
+ style="width: 950px; height: 1058px;">