--- doc/homework/datastorage	2003/05/23 07:04:43	1.20
+++ doc/homework/datastorage	2006/03/02 20:16:46	1.25
@@ -1,4 +1,5 @@
-<Provided by &EXT() and set external to the resource, required>
+----PARAMETERS-----
+<see also packages.tab>
 resource.partid.opendate   #unix time of when the local machine should let the
                     #student in
 
@@ -15,11 +16,14 @@ resource.partid.weight     # points the
 
 resource.partid.maxtries   # maximum number of attempts the student can have
 
-resource.partid.problemstyle # style to show a problem in, possible values:
+
+resource.partid.problemstyle (notcurrently supported)
+                             # style to show a problem in, possible values:
                              # online - show problem in default online mode
                              # bubble - show problem in a mode approriate to
                              #          being printed out for a bubble sheet
                              #          exam
+                             # checkout - do checkouting of problem
 
 resource.partid.type       # type of problem homework can be:
                            # homework - randomized, graded, stored with 
@@ -47,8 +51,19 @@ resource.partid.responseid.sig  # one or
                      # number of significatn figures a student must use
 
 
+<essayresponse specific>
+
+resource.partid.responseid.maxcollaborators
+                     	# integer of the maximum number of users to 
+                        # collborate on an answer
+
+resource.partid.responseid.uploadfiletypes
+                        # a comma seperated list of filetypes to allow a user
+                        # to upload
+
 
-<Problem sets using cstore (required):>
+
+----STORED VALUES----
 resource.partid.solved # if not set, problem yet to be viewed
                 # incorrect_attempted == incorrect and attempted
                 # correct_by_student == correct by student work
@@ -58,13 +73,21 @@ resource.partid.solved # if not set, pro
                 # excused == excused, problem no longer counts for student
                 # '' (empty) == not attempted
                 # ungraded_attempted == an ungraded answer has been
-                                          sumbitted and stored
+                                          submitted and stored
 resource.partid.tries  # positive integer of number of unsuccessful attempts
                 # made, malformed answers don't count if feedback is
                 # on
 
 resource.partid.awarded # float between 0 and 1, percentage of
-                 # resource.partid.weight that the student earned.
+                        # resource.partid.weight that the student earned.
+
+<only exists in the scantron grading case>
+resource.partid.resourceid.awarded
+                         # float between 0 and 1, percentage of
+                         # resource.partid.weight
+                         # that the student was assigned on a scantron sheet
+                         # all resource level .awarded s will be averaged
+                         # together for the final part .awarded
 
 resource.partid.award # final detailed award that was applied to the entire
                       # part of the question, check awarddetail below for
@@ -72,7 +95,15 @@ resource.partid.award # final detailed a
 
 resource.partid.previous # boolean, is this submission a previous submission
 
-resource.partid.responseid.submissons
+resource.partid.regrader
+                 # the username:domain of the user who hand graded this one
+
+
+resource.partid.afterduedate
+                 # the award that would have been received if they had
+                 # submitted before the duedate
+
+resource.partid.responseid.submisson
                     # the student submitted string for the part.response
 
 resource.partid.responseid.awarddetail
@@ -106,9 +137,6 @@ resource.partid.responseid.awarddetail
                      #                    that was of an extension that was
                      #                    not specficy allowed 
 
-resource.partid.responseid.awarded # float between 0 and 1, percentage of
-                 # resource.partid.weight that the student earned.
-
 resource.partid.responseid.message (optional) (not yet supported)
 		     # a message that should be shown to the student
 
@@ -116,7 +144,41 @@ resource.partid.bonustries (optional) (n
                      # if set, added to the maxtries parameter for student 
                      # total number of tries overall
 
+resource.partid.responseid.scantron
+                 # the letteror string that the scantron submitted as 
+                 # the answer before it was converted into the submission
+                 # value
+
+rndseed
+                 # for public users or browsed versions, the rndseed used
+                 # for this partcualr submission, should only appear
+                 # in tmpstore dbs
+
+<option/rank/match response specific>
+resource.partid.responseid.submissiongrading
+		 # an annotation of which foils that the student
+                 # submitted were wrong and which were correct (hash)
+
 <optionresponse> specific
-resource.partid.responseid.partid.numfoils
+resource.partid.responseid.numfoils
                      # if graded in scantron mode this is set to number
                      # of foils a student saw
+
+<organicresponse specific>
+resource.partid.responseid.molecule
+                     #JME string of the last submission
+
+<essayresponse> specific
+resource.partid.responseid.uploadedfile
+                     # filename of the upload file that is to be used
+                     # for the submission
+
+resource.partid.responseid.uploadedurl
+                    # url to use to grab the file that was used for
+                    # the submission
+
+resource.partid.responseid.portfiles
+                    # comma sepearted list of student portfolio files
+                    # for the submission
+
+