4.3. Displaying Grade Reports

websubmit can be used to display grade reports to students. This facility is designed to be compatible with the reports prepared by my automatic grader, but the actual report files may be text, HTML, or PDF files, one per student per assignment, so these can actually come from anywhere - there's not a whole lot of flexibility in the directory structure, though.

To provide this facility, add a <gradesDirectory> element to the submission information file.

<assignment notify="cs361@cs.odu.edu"> 
  <title>CS361: Keeping Your Distance</title> 
  <roster>/home/zeil/courses/cs361/Assignments/f10/roster.dat</roster>
  <directory>/home/zeil/courses/cs361Submissions/editd</directory> 
  <gradesDirectory>/home/zeil/courses/cs361Grades/editd</gradesDirectory> 
  <file filter="editdist.cpp" required="1">
     Your implementation of the editDistance function.</text> 
  </file>
  <file filter="README.txt">
     Notes to the grader, if any.
  </file>
  <solutionDirectory>/home/zeil/courses/cs361/Solutions/editd</solutionDirectory> 
  <solutionDate>1/1/2001</solutionDate> 
</assignment>

There are two distinct arrangements that are supported for the grades files:

  1. Within the specified grades directory, create a separate directory for each student. The directory names should match the students' login names. Within each student's directory, place a file named gradeReport.txt, gradeReport.html, or gradeReport.pdf

  2. Or, within the specified grades directory, place one file for each student, named with the student's login name: loginName.txt, loginName.html, or loginName.pdf

Future releases of websubmit may offer some more flexibility on this arrangement.

If a gradesDirectory has been specified, a student who logs into the assignment submissions page will be informed whether a grade has been posted and, if it has, the date of the posting (the modification date of the grade file). The student will be given an option (along with the options of submitting and/or viewing the solution) of viewing that grade report.