Annotation of doc/homework/datastorage, revision 1.26

1.21      albertel    1: ----PARAMETERS-----
1.25      albertel    2: <see also packages.tab>
1.7       albertel    3: resource.partid.opendate   #unix time of when the local machine should let the
                      4:                     #student in
1.1       albertel    5: 
1.7       albertel    6: resource.partid.duedate    #unix time of when the local machine should stop
                      7:                     #accepting answers
1.1       albertel    8: 
1.7       albertel    9: resource.partid.answerdate #unix time of when the local machine should
                     10:                     #provide the correct answer to the student
1.1       albertel   11: 
1.15      albertel   12: resource.partid.acc # a string that can be used to control access, either
                     13:                     # IP based or Domain Name based
                     14: 
1.7       albertel   15: resource.partid.weight     # points the problem is worth
1.1       albertel   16: 
1.7       albertel   17: resource.partid.maxtries   # maximum number of attempts the student can have
1.1       albertel   18: 
1.21      albertel   19: 
                     20: resource.partid.problemstyle (notcurrently supported)
                     21:                              # style to show a problem in, possible values:
1.15      albertel   22:                              # online - show problem in default online mode
                     23:                              # bubble - show problem in a mode approriate to
                     24:                              #          being printed out for a bubble sheet
                     25:                              #          exam
1.21      albertel   26:                              # checkout - do checkouting of problem
1.15      albertel   27: 
1.10      albertel   28: resource.partid.type       # type of problem homework can be:
                     29:                            # homework - randomized, graded, stored with 
                     30:                            #            requesting user, full feeback
                     31:                            # exam - randomized, graded, stored with 
                     32:                            #        requesting user, minimal feedback
                     33:                            # form - unrandomized, ungraded, stored with 
                     34:                            #        specified user, full feedback
                     35:                            # survey - unrandomized, ungraded, stored with 
                     36:                            #          requesting user, full feedback
1.1       albertel   37: 
                     38: 
1.12      albertel   39: <numerical/formula/response needed: (has a default if nonexistant)>
1.1       albertel   40: 
1.11      albertel   41: resource.partid.responseid.tol   # lots of possibilities here
1.1       albertel   42:                     # percentage, range (inclusive and exclusive),
                     43: 		    # variable name, etc
1.3       albertel   44:                     # 3%
                     45:                     # 0.5
                     46:                     # .05+
                     47:                     # 3%+
                     48:                     # 0.5+,.005
1.9       albertel   49: 
1.11      albertel   50: resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
1.5       albertel   51:                      # number of significatn figures a student must use
1.3       albertel   52: 
1.1       albertel   53: 
1.21      albertel   54: <essayresponse specific>
                     55: 
                     56: resource.partid.responseid.maxcollaborators
                     57:                      	# integer of the maximum number of users to 
                     58:                         # collborate on an answer
                     59: 
                     60: resource.partid.responseid.uploadfiletypes
                     61:                         # a comma seperated list of filetypes to allow a user
                     62:                         # to upload
1.1       albertel   63: 
1.21      albertel   64: 
                     65: 
                     66: ----STORED VALUES----
1.7       albertel   67: resource.partid.solved # if not set, problem yet to be viewed
1.4       www        68:                 # incorrect_attempted == incorrect and attempted
                     69:                 # correct_by_student == correct by student work
                     70:                 # correct_by_override == correct, instructor override
1.18      albertel   71:                 # correct_by_scantron == correct, scantron graded
1.4       www        72:                 # incorrect_by_override == incorrect, instructor override
                     73:                 # excused == excused, problem no longer counts for student
                     74:                 # '' (empty) == not attempted
1.9       albertel   75:                 # ungraded_attempted == an ungraded answer has been
1.24      banghart   76:                                           submitted and stored
1.7       albertel   77: resource.partid.tries  # positive integer of number of unsuccessful attempts
1.1       albertel   78:                 # made, malformed answers don't count if feedback is
                     79:                 # on
                     80: 
1.7       albertel   81: resource.partid.awarded # float between 0 and 1, percentage of
1.25      albertel   82:                         # resource.partid.weight that the student earned.
                     83: 
                     84: <only exists in the scantron grading case>
                     85: resource.partid.resourceid.awarded
                     86:                          # float between 0 and 1, percentage of
                     87:                          # resource.partid.weight
                     88:                          # that the student was assigned on a scantron sheet
                     89:                          # all resource level .awarded s will be averaged
                     90:                          # together for the final part .awarded
1.1       albertel   91: 
1.11      albertel   92: resource.partid.award # final detailed award that was applied to the entire
                     93:                       # part of the question, check awarddetail below for
                     94:                       # possibilities
                     95: 
                     96: resource.partid.previous # boolean, is this submission a previous submission
                     97: 
1.21      albertel   98: resource.partid.regrader
                     99:                  # the username:domain of the user who hand graded this one
                    100: 
                    101: 
                    102: resource.partid.afterduedate
                    103:                  # the award that would have been received if they had
                    104:                  # submitted before the duedate
                    105: 
                    106: resource.partid.responseid.submisson
1.5       albertel  107:                     # the student submitted string for the part.response
1.1       albertel  108: 
1.9       albertel  109: resource.partid.responseid.awarddetail
1.2       albertel  110:                      # list of all of the results of grading the submissions
1.1       albertel  111:                      # in detailed form of the specific failure
1.11      albertel  112: 		     #Possible values:
1.9       albertel  113:                      # EXACT_ANS, APPROX_ANS : student is correct
                    114:                      # NO_RESPONSE : student submitted no response
                    115:                      # MISSING_ANSWER : student submitted some but not
                    116:                      #                   all parts of a response
1.26    ! albertel  117: 	 	     # EXTRA_ANSWER : student submitted a vector of values
        !           118:                      #                  when a scalar was expected
1.9       albertel  119:                      # WANTED_NUMERIC : expected a numeric answer and
                    120:                      #                   didn't get one
                    121: 		     # SIG_FAIL : incorrect number of Significant Figures
                    122:                      # UNIT_FAIL : incorrect unit
                    123:                      # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
1.26    ! albertel  124:                      # UNIT_INVALID_INSTRUCTOR : the unit provided by the 
        !           125:                      #            author of the problem is unparasable
        !           126:                      # UNIT_INVALID_STUDENT : the unit provided by the 
        !           127:                      #            student is unparasable
        !           128:                      # UNIT_IRRECONCIBLE : the unit from the student and
        !           129:                      #                  the instructor are of different types
1.9       albertel  130:                      # NO_UNIT : needed a unit but none was submitted
                    131: 		     # BAD_FORMULA : syntax error in submitted formula
                    132:                      # INCORRECT : answer was wrong
                    133:                      # SUBMITTED : submission wasn't graded
1.14      ng        134:                      # DRAFT : submission only stored
1.17      albertel  135:                      # MISORDERED_RANK : student submitted a poorly order
                    136:                      #                   rank response
1.11      albertel  137: 		     # ERROR : unable to get a grade
1.18      albertel  138:                      # ASSIGNED_SCORE : there is a 
                    139:                      #                  resource.partid.responseid.awarded
                    140:                      #                  the real awarded should be set to the
                    141:                      #                  average of the individual awardeds
1.20      albertel  142:                      # TOO_LONG : answer submission to capa engine longer
                    143:                      #            than 500 characters
                    144:                      # INVALID_FILETYPE : student tried to upload a file
                    145:                      #                    that was of an extension that was
                    146:                      #                    not specficy allowed 
1.26    ! albertel  147: 		     # COMMA_FAIL : answer requires the use of comma grouping
        !           148:                      #              and it wasn't provided or was incorrect
1.18      albertel  149: 
1.13      albertel  150: resource.partid.responseid.message (optional) (not yet supported)
                    151: 		     # a message that should be shown to the student
1.12      albertel  152: 
1.13      albertel  153: resource.partid.bonustries (optional) (not yet supported)
1.12      albertel  154:                      # if set, added to the maxtries parameter for student 
                    155:                      # total number of tries overall
1.19      albertel  156: 
1.21      albertel  157: resource.partid.responseid.scantron
                    158:                  # the letteror string that the scantron submitted as 
                    159:                  # the answer before it was converted into the submission
                    160:                  # value
                    161: 
                    162: rndseed
                    163:                  # for public users or browsed versions, the rndseed used
                    164:                  # for this partcualr submission, should only appear
                    165:                  # in tmpstore dbs
                    166: 
                    167: <option/rank/match response specific>
                    168: resource.partid.responseid.submissiongrading
                    169: 		 # an annotation of which foils that the student
                    170:                  # submitted were wrong and which were correct (hash)
                    171: 
1.19      albertel  172: <optionresponse> specific
1.21      albertel  173: resource.partid.responseid.numfoils
1.19      albertel  174:                      # if graded in scantron mode this is set to number
                    175:                      # of foils a student saw
1.21      albertel  176: 
                    177: <organicresponse specific>
                    178: resource.partid.responseid.molecule
                    179:                      #JME string of the last submission
                    180: 
                    181: <essayresponse> specific
                    182: resource.partid.responseid.uploadedfile
                    183:                      # filename of the upload file that is to be used
                    184:                      # for the submission
                    185: 
                    186: resource.partid.responseid.uploadedurl
                    187:                     # url to use to grab the file that was used for
                    188:                     # the submission
                    189: 
1.23      albertel  190: resource.partid.responseid.portfiles
                    191:                     # comma sepearted list of student portfolio files
                    192:                     # for the submission
                    193: 
1.21      albertel  194: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>