Annotation of doc/homework/datastorage, revision 1.11

1.1       albertel    1: <Provided by &EXT() and set external to the resource, required>
1.7       albertel    2: resource.partid.opendate   #unix time of when the local machine should let the
                      3:                     #student in
1.1       albertel    4: 
1.7       albertel    5: resource.partid.duedate    #unix time of when the local machine should stop
                      6:                     #accepting answers
1.1       albertel    7: 
1.7       albertel    8: resource.partid.answerdate #unix time of when the local machine should
                      9:                     #provide the correct answer to the student
1.1       albertel   10: 
1.7       albertel   11: resource.partid.weight     # points the problem is worth
1.1       albertel   12: 
1.7       albertel   13: resource.partid.maxtries   # maximum number of attempts the student can have
1.1       albertel   14: 
1.10      albertel   15: resource.partid.type       # type of problem homework can be:
                     16:                            # homework - randomized, graded, stored with 
                     17:                            #            requesting user, full feeback
                     18:                            # exam - randomized, graded, stored with 
                     19:                            #        requesting user, minimal feedback
                     20:                            # form - unrandomized, ungraded, stored with 
                     21:                            #        specified user, full feedback
                     22:                            # survey - unrandomized, ungraded, stored with 
                     23:                            #          requesting user, full feedback
                     24: 
1.1       albertel   25: 
                     26: 
                     27: <caparesponse needed: (has a default if nonexistant)>
                     28: 
1.11    ! albertel   29: resource.partid.responseid.tol   # lots of possibilities here
1.1       albertel   30:                     # percentage, range (inclusive and exclusive),
                     31: 		    # variable name, etc
1.3       albertel   32:                     # 3%
                     33:                     # 0.5
                     34:                     # .05+
                     35:                     # 3%+
                     36:                     # 0.5+,.005
1.9       albertel   37: 
1.11    ! albertel   38: resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
1.5       albertel   39:                      # number of significatn figures a student must use
1.3       albertel   40: 
1.7       albertel   41: resource.partid.feedback   # at least a single bit (yes/no) may go with a
                     42:                          # bitmask in the future, controls whether or not
                     43:                          # a problem should say "correct" or not
1.1       albertel   44: 
                     45: 
                     46: <Problem sets using cstore (required):>
1.7       albertel   47: resource.partid.solved # if not set, problem yet to be viewed
1.4       www        48:                 # incorrect_attempted == incorrect and attempted
                     49:                 # correct_by_student == correct by student work
                     50:                 # correct_by_override == correct, instructor override
                     51:                 # incorrect_by_override == incorrect, instructor override
                     52:                 # excused == excused, problem no longer counts for student
                     53:                 # '' (empty) == not attempted
1.9       albertel   54:                 # ungraded_attempted == an ungraded answer has been
1.8       albertel   55:                                           sumbitted and stored
1.7       albertel   56: resource.partid.tries  # positive integer of number of unsuccessful attempts
1.1       albertel   57:                 # made, malformed answers don't count if feedback is
                     58:                 # on
                     59: 
1.7       albertel   60: resource.partid.awarded # float between 0 and 1, percentage of
1.1       albertel   61:                  # resource.weight that the stundent earned.
                     62: 
1.11    ! albertel   63: resource.partid.award # final detailed award that was applied to the entire
        !            64:                       # part of the question, check awarddetail below for
        !            65:                       # possibilities
        !            66: 
        !            67: resource.partid.previous # boolean, is this submission a previous submission
        !            68: 
1.9       albertel   69: resource.partid.responseid.submissons
1.5       albertel   70:                     # the student submitted string for the part.response
1.1       albertel   71: 
1.9       albertel   72: resource.partid.responseid.awarddetail
1.2       albertel   73:                      # list of all of the results of grading the submissions
1.1       albertel   74:                      # in detailed form of the specific failure
1.11    ! albertel   75: 		     #Possible values:
1.9       albertel   76:                      # EXACT_ANS, APPROX_ANS : student is correct
                     77:                      # NO_RESPONSE : student submitted no response
                     78:                      # MISSING_ANSWER : student submitted some but not
                     79:                      #                   all parts of a response
                     80:                      # WANTED_NUMERIC : expected a numeric answer and
                     81:                      #                   didn't get one
                     82: 		     # SIG_FAIL : incorrect number of Significant Figures
                     83:                      # UNIT_FAIL : incorrect unit
                     84:                      # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
                     85:                      # NO_UNIT : needed a unit but none was submitted
                     86: 		     # BAD_FORMULA : syntax error in submitted formula
                     87:                      # INCORRECT : answer was wrong
                     88:                      # SUBMITTED : submission wasn't graded
1.1       albertel   89: 
1.11    ! albertel   90: 		     # ERROR : unable to get a grade
1.1       albertel   91: 
1.11    ! albertel   92: resource.partid.responseid.message (optional)
        !            93: 		     # a message hat you need to send to the student

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