Annotation of doc/homework/datastorage, revision 1.18

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.15      albertel   11: resource.partid.acc # a string that can be used to control access, either
                     12:                     # IP based or Domain Name based
                     13: 
1.7       albertel   14: resource.partid.weight     # points the problem is worth
1.1       albertel   15: 
1.7       albertel   16: resource.partid.maxtries   # maximum number of attempts the student can have
1.1       albertel   17: 
1.15      albertel   18: resource.partid.problemstyle # style to show a problem in, possible values:
                     19:                              # online - show problem in default online mode
                     20:                              # bubble - show problem in a mode approriate to
                     21:                              #          being printed out for a bubble sheet
                     22:                              #          exam
                     23: 
1.10      albertel   24: resource.partid.type       # type of problem homework can be:
                     25:                            # homework - randomized, graded, stored with 
                     26:                            #            requesting user, full feeback
                     27:                            # exam - randomized, graded, stored with 
                     28:                            #        requesting user, minimal feedback
                     29:                            # form - unrandomized, ungraded, stored with 
                     30:                            #        specified user, full feedback
                     31:                            # survey - unrandomized, ungraded, stored with 
                     32:                            #          requesting user, full feedback
1.1       albertel   33: 
                     34: 
1.12      albertel   35: <numerical/formula/response needed: (has a default if nonexistant)>
1.1       albertel   36: 
1.11      albertel   37: resource.partid.responseid.tol   # lots of possibilities here
1.1       albertel   38:                     # percentage, range (inclusive and exclusive),
                     39: 		    # variable name, etc
1.3       albertel   40:                     # 3%
                     41:                     # 0.5
                     42:                     # .05+
                     43:                     # 3%+
                     44:                     # 0.5+,.005
1.9       albertel   45: 
1.11      albertel   46: resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
1.5       albertel   47:                      # number of significatn figures a student must use
1.3       albertel   48: 
1.1       albertel   49: 
                     50: 
                     51: <Problem sets using cstore (required):>
1.7       albertel   52: resource.partid.solved # if not set, problem yet to be viewed
1.4       www        53:                 # incorrect_attempted == incorrect and attempted
                     54:                 # correct_by_student == correct by student work
                     55:                 # correct_by_override == correct, instructor override
1.18    ! albertel   56:                 # correct_by_scantron == correct, scantron graded
1.4       www        57:                 # incorrect_by_override == incorrect, instructor override
                     58:                 # excused == excused, problem no longer counts for student
                     59:                 # '' (empty) == not attempted
1.9       albertel   60:                 # ungraded_attempted == an ungraded answer has been
1.8       albertel   61:                                           sumbitted and stored
1.7       albertel   62: resource.partid.tries  # positive integer of number of unsuccessful attempts
1.1       albertel   63:                 # made, malformed answers don't count if feedback is
                     64:                 # on
                     65: 
1.7       albertel   66: resource.partid.awarded # float between 0 and 1, percentage of
1.18    ! albertel   67:                  # resource.partid.weight that the student earned.
1.1       albertel   68: 
1.11      albertel   69: resource.partid.award # final detailed award that was applied to the entire
                     70:                       # part of the question, check awarddetail below for
                     71:                       # possibilities
                     72: 
                     73: resource.partid.previous # boolean, is this submission a previous submission
                     74: 
1.9       albertel   75: resource.partid.responseid.submissons
1.5       albertel   76:                     # the student submitted string for the part.response
1.1       albertel   77: 
1.9       albertel   78: resource.partid.responseid.awarddetail
1.2       albertel   79:                      # list of all of the results of grading the submissions
1.1       albertel   80:                      # in detailed form of the specific failure
1.11      albertel   81: 		     #Possible values:
1.9       albertel   82:                      # EXACT_ANS, APPROX_ANS : student is correct
                     83:                      # NO_RESPONSE : student submitted no response
                     84:                      # MISSING_ANSWER : student submitted some but not
                     85:                      #                   all parts of a response
                     86:                      # WANTED_NUMERIC : expected a numeric answer and
                     87:                      #                   didn't get one
                     88: 		     # SIG_FAIL : incorrect number of Significant Figures
                     89:                      # UNIT_FAIL : incorrect unit
                     90:                      # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
                     91:                      # NO_UNIT : needed a unit but none was submitted
                     92: 		     # BAD_FORMULA : syntax error in submitted formula
                     93:                      # INCORRECT : answer was wrong
                     94:                      # SUBMITTED : submission wasn't graded
1.14      ng         95:                      # DRAFT : submission only stored
1.17      albertel   96:                      # MISORDERED_RANK : student submitted a poorly order
                     97:                      #                   rank response
1.11      albertel   98: 		     # ERROR : unable to get a grade
1.18    ! albertel   99:                      # ASSIGNED_SCORE : there is a 
        !           100:                      #                  resource.partid.responseid.awarded
        !           101:                      #                  the real awarded should be set to the
        !           102:                      #                  average of the individual awardeds
        !           103: 
        !           104: resource.partid.responseid.awarded # float between 0 and 1, percentage of
        !           105:                  # resource.partid.weight that the student earned.
1.1       albertel  106: 
1.13      albertel  107: resource.partid.responseid.message (optional) (not yet supported)
                    108: 		     # a message that should be shown to the student
1.12      albertel  109: 
1.13      albertel  110: resource.partid.bonustries (optional) (not yet supported)
1.12      albertel  111:                      # if set, added to the maxtries parameter for student 
                    112:                      # total number of tries overall

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