--- doc/homework/datastorage	2002/11/11 22:00:09	1.15
+++ doc/homework/datastorage	2005/04/07 20:43:06	1.23
@@ -1,4 +1,5 @@
-<Provided by &EXT() and set external to the resource, required>
+----PARAMETERS-----
+
 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,12 +51,24 @@ 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
                 # correct_by_override == correct, instructor override
+                # correct_by_scantron == correct, scantron graded
                 # incorrect_by_override == incorrect, instructor override
                 # excused == excused, problem no longer counts for student
                 # '' (empty) == not attempted
@@ -63,7 +79,7 @@ resource.partid.tries  # positive intege
                 # on
 
 resource.partid.awarded # float between 0 and 1, percentage of
-                 # resource.weight that the stundent earned.
+                 # resource.partid.weight that the student earned.
 
 resource.partid.award # final detailed award that was applied to the entire
                       # part of the question, check awarddetail below for
@@ -71,7 +87,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
@@ -92,8 +116,18 @@ resource.partid.responseid.awarddetail
                      # INCORRECT : answer was wrong
                      # SUBMITTED : submission wasn't graded
                      # DRAFT : submission only stored
-
+                     # MISORDERED_RANK : student submitted a poorly order
+                     #                   rank response
 		     # ERROR : unable to get a grade
+                     # ASSIGNED_SCORE : there is a 
+                     #                  resource.partid.responseid.awarded
+                     #                  the real awarded should be set to the
+                     #                  average of the individual awardeds
+                     # TOO_LONG : answer submission to capa engine longer
+                     #            than 500 characters
+                     # INVALID_FILETYPE : student tried to upload a file
+                     #                    that was of an extension that was
+                     #                    not specficy allowed 
 
 resource.partid.responseid.message (optional) (not yet supported)
 		     # a message that should be shown to the student
@@ -101,3 +135,42 @@ resource.partid.responseid.message (opti
 resource.partid.bonustries (optional) (not yet supported)
                      # 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.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
+
+