Return to datastorage CVS log

Up to [LON-CAPA] / doc / homework

- document more of the valid values for awarddetail

----PARAMETERS-----
<see also packages.tab>
resource.partid.opendate   #unix time of when the local machine should let the
                    #student in

resource.partid.duedate    #unix time of when the local machine should stop
                    #accepting answers

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
                           # exam - randomized, graded, stored with 
                           #        requesting user, minimal feedback
                           # form - unrandomized, ungraded, stored with 
                           #        specified user, full feedback
                           # survey - unrandomized, ungraded, stored with 
                           #          requesting user, full feedback


<numerical/formula/response needed: (has a default if nonexistant)>

resource.partid.responseid.tol   # lots of possibilities here
                    # percentage, range (inclusive and exclusive),
		    # variable name, etc
                    # 3%
                    # 0.5
                    # .05+
                    # 3%+
                    # 0.5+,.005

resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
                     # number of significatn figures a student must use


<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



----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
                # ungraded_attempted == an ungraded answer has been
                                          submitted and stored
resource.partid.tries  # positive integer of number of unsuccessful attempts
                # made, malformed answers don't count if feedback is
                # on

resource.partid.awarded # float between 0 and 1, percentage of
                        # resource.partid.weight that the student earned.

<only exists in the scantron grading case>
resource.partid.resourceid.awarded
                         # float between 0 and 1, percentage of
                         # resource.partid.weight
                         # that the student was assigned on a scantron sheet
                         # all resource level .awarded s will be averaged
                         # together for the final part .awarded

resource.partid.award # final detailed award that was applied to the entire
                      # part of the question, check awarddetail below for
                      # possibilities

resource.partid.previous # boolean, is this submission a previous submission

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
                     # list of all of the results of grading the submissions
                     # in detailed form of the specific failure
		     #Possible values:
                     # EXACT_ANS, APPROX_ANS : student is correct
                     # NO_RESPONSE : student submitted no response
                     # MISSING_ANSWER : student submitted some but not
                     #                   all parts of a response
	 	     # EXTRA_ANSWER : student submitted a vector of values
                     #                  when a scalar was expected
                     # WANTED_NUMERIC : expected a numeric answer and
                     #                   didn't get one
		     # SIG_FAIL : incorrect number of Significant Figures
                     # UNIT_FAIL : incorrect unit
                     # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
                     # UNIT_INVALID_INSTRUCTOR : the unit provided by the 
                     #            author of the problem is unparasable
                     # UNIT_INVALID_STUDENT : the unit provided by the 
                     #            student is unparasable
                     # UNIT_IRRECONCIBLE : the unit from the student and
                     #                  the instructor are of different types
                     # NO_UNIT : needed a unit but none was submitted
		     # BAD_FORMULA : syntax error in submitted formula
                     # WRONG_NUMBOXESCHECKED : too few or too many checkboxes
                     #             checked in optionresponse with limits
                     # INCORRECT : answer was wrong
                     # SUBMITTED : submission wasn't graded
                     # SUBMITTED_CREDIT : credit for making a submission,
                     #                    regardless of content 
                     # ANONYMOUS : submission to an anonymous survey
                     # ANONYMOUS_CREDIT : credit for submission to an anonymous
                     #                    survey, regardless of content 
                     # 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 
                     # EXCESS_FILESIZE : either the size of an individual file
                     #          or the combined sizes of all files submitted 
                     #          to essayresponse item exceeded the size limit
                     #          in effect for the problem part
                     # FILENAME_INUSE : same path/filename in portfolio space
                     #            can not be used for submission to more than 
                     #            one essayreponse item 
		     # COMMA_FAIL : answer requires the use of comma grouping
                     #              and it wasn't provided or was incorrect

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