Annotation of doc/homework/datastorage, revision 1.13

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: 
1.12      albertel   27: <numerical/formula/response needed: (has a default if nonexistant)>
1.1       albertel   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.1       albertel   41: 
                     42: 
                     43: <Problem sets using cstore (required):>
1.7       albertel   44: resource.partid.solved # if not set, problem yet to be viewed
1.4       www        45:                 # incorrect_attempted == incorrect and attempted
                     46:                 # correct_by_student == correct by student work
                     47:                 # correct_by_override == correct, instructor override
                     48:                 # incorrect_by_override == incorrect, instructor override
                     49:                 # excused == excused, problem no longer counts for student
                     50:                 # '' (empty) == not attempted
1.9       albertel   51:                 # ungraded_attempted == an ungraded answer has been
1.8       albertel   52:                                           sumbitted and stored
1.7       albertel   53: resource.partid.tries  # positive integer of number of unsuccessful attempts
1.1       albertel   54:                 # made, malformed answers don't count if feedback is
                     55:                 # on
                     56: 
1.7       albertel   57: resource.partid.awarded # float between 0 and 1, percentage of
1.1       albertel   58:                  # resource.weight that the stundent earned.
                     59: 
1.11      albertel   60: resource.partid.award # final detailed award that was applied to the entire
                     61:                       # part of the question, check awarddetail below for
                     62:                       # possibilities
                     63: 
                     64: resource.partid.previous # boolean, is this submission a previous submission
                     65: 
1.9       albertel   66: resource.partid.responseid.submissons
1.5       albertel   67:                     # the student submitted string for the part.response
1.1       albertel   68: 
1.9       albertel   69: resource.partid.responseid.awarddetail
1.2       albertel   70:                      # list of all of the results of grading the submissions
1.1       albertel   71:                      # in detailed form of the specific failure
1.11      albertel   72: 		     #Possible values:
1.9       albertel   73:                      # EXACT_ANS, APPROX_ANS : student is correct
                     74:                      # NO_RESPONSE : student submitted no response
                     75:                      # MISSING_ANSWER : student submitted some but not
                     76:                      #                   all parts of a response
                     77:                      # WANTED_NUMERIC : expected a numeric answer and
                     78:                      #                   didn't get one
                     79: 		     # SIG_FAIL : incorrect number of Significant Figures
                     80:                      # UNIT_FAIL : incorrect unit
                     81:                      # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
                     82:                      # NO_UNIT : needed a unit but none was submitted
                     83: 		     # BAD_FORMULA : syntax error in submitted formula
                     84:                      # INCORRECT : answer was wrong
                     85:                      # SUBMITTED : submission wasn't graded
1.1       albertel   86: 
1.11      albertel   87: 		     # ERROR : unable to get a grade
1.1       albertel   88: 
1.13    ! albertel   89: resource.partid.responseid.message (optional) (not yet supported)
        !            90: 		     # a message that should be shown to the student
1.12      albertel   91: 
1.13    ! albertel   92: resource.partid.bonustries (optional) (not yet supported)
1.12      albertel   93:                      # if set, added to the maxtries parameter for student 
                     94:                      # total number of tries overall

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