--- doc/homework/datastorage	2002/01/30 17:08:47	1.11
+++ 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
 
@@ -8,10 +9,22 @@ resource.partid.duedate    #unix time of
 resource.partid.answerdate #unix time of when the local machine should
                     #provide the correct answer to the student
 
+resource.partid.acc # a string that can be used to control access, either
+                    # IP based or Domain Name based
+
 resource.partid.weight     # points the problem is worth
 
 resource.partid.maxtries   # maximum number of attempts the student can have
 
+
+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 
                            #            requesting user, full feeback
@@ -23,8 +36,7 @@ resource.partid.type       # type of pro
                            #          requesting user, full feedback
 
 
-
-<caparesponse needed: (has a default if nonexistant)>
+<numerical/formula/response needed: (has a default if nonexistant)>
 
 resource.partid.responseid.tol   # lots of possibilities here
                     # percentage, range (inclusive and exclusive),
@@ -38,16 +50,25 @@ resource.partid.responseid.tol   # lots
 resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
                      # number of significatn figures a student must use
 
-resource.partid.feedback   # at least a single bit (yes/no) may go with a
-                         # bitmask in the future, controls whether or not
-                         # a problem should say "correct" or not
 
+<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
@@ -58,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
@@ -66,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
@@ -86,8 +115,62 @@ resource.partid.responseid.awarddetail
 		     # BAD_FORMULA : syntax error in submitted formula
                      # 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
+
+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
+
 
-resource.partid.responseid.message (optional)
-		     # a message hat you need to send to the student