loncom/homework/grades.pm - diff

Return to grades.pm CVS log

Up to [LON-CAPA] / loncom / homework

Diff for /loncom/homework/grades.pm between versions 1.422 and 1.453

-version 1.422, 2007/07/19 09:52:59
+version 1.453, 2007/10/11 21:27:50
  Line 45  use LONCAPA;
  use POSIX qw(floor);
- my %oldessays=();
  my %perm=();
+ my %bubble_lines_per_response = ();     # no. bubble lines for each response.
+                                    # index is "symb.part_id"
+ my %first_bubble_line = ();	# First bubble line no. for each bubble.
+ # Save and restore the bubble lines array to the form env.
+ sub save_bubble_lines {
+     &Apache::lonnet::logthis("Saving bubble_lines...");
+     foreach my $line (keys(%bubble_lines_per_response)) {
+ 	&Apache::lonnet::logthis("Saving form.scantron.bubblelines.$line value: $bubble_lines_per_response{$line}");
+ 	$env{"form.scantron.bubblelines.$line"}  = $bubble_lines_per_response{$line};
+ 	$env{"form.scantron.first_bubble_line.$line"} =
+ 	    $first_bubble_line{$line};
+     }
+ }
+ sub restore_bubble_lines {
+     my $line = 0;
+     %bubble_lines_per_response = ();
+     while ($env{"form.scantron.bubblelines.$line"}) {
+ 	my $value = $env{"form.scantron.bubblelines.$line"};
+ 	&Apache::lonnet::logthis("Restoring form.scantron.bubblelines.$line value: $value");
+ 	$bubble_lines_per_response{$line} = $value;
+ 	$first_bubble_line{$line}  =
+ 	    $env{"form.scantron.first_bubble_line.$line"};
+ 	$line++;
+     }
+ }
+ #  Given the parsed scanline, get the response for
+ #  'answer' number n:
+ sub get_response_bubbles {
+     my ($parsed_line, $response)  = @_;
+     my $bubble_line = $first_bubble_line{$response};
+     my $bubble_lines= $bubble_lines_per_response{$response};
+     my $selected = "";
+     for (my $bline = 0; $bline < $bubble_lines; $bline++) {
+ 	$selected .= $$parsed_line{"scantron.$bubble_line.answer"};
+ 	$bubble_line++;
+     }
+     return $selected;
+ }
  # ----- These first few routines are general use routines.----
+ # Return the number of occurences of a pattern in a string.
+ sub occurence_count {
+     my ($string, $pattern) = @_;
+     my @matches = ($string =~ /$pattern/g);
+     return scalar(@matches);
+ }
+ # Take a string known to have digits and convert all the
+ # digits into letters in the range J,A..I.
+ sub digits_to_letters {
+     my ($input) = @_;
+     my @alphabet = ('J', 'A'..'I');
+     my @input    = split(//, $input);
+     my $output ='';
+     for (my $i = 0; $i < scalar(@input); $i++) {
+ 	if ($input[$i] =~ /\d/) {
+ 	    $output .= $alphabet[$input[$i]];
+ 	} else {
+ 	    $output .= $input[$i];
+ 	}
+     }
+     return $output;
+ }
  #
  # --- Retrieve the parts from the metadata file.---
  sub getpartlist {
      my ($symb) = @_;
-     my (undef,undef,$url) = &Apache::lonnet::decode_symb($symb);
-     my $partorder = &Apache::lonnet::metadata($url, 'partorder');
+     my $navmap   = Apache::lonnavmaps::navmap->new();
-     my @parts;
+     my $res      = $navmap->getBySymb($symb);
-     if ($partorder) {
+     my $partlist = $res->parts();
- 	for my $part (split (/,/,$partorder)) {
+     my $url      = $res->src();
- 	    if (!&Apache::loncommon::check_if_partid_hidden($part,$symb)) {
+     my @metakeys = split(/,/,&Apache::lonnet::metadata($url,'keys'));
- 		push(@parts, $part);
- 	    }
- 	}
-     } else {
- 	my $metadata = &Apache::lonnet::metadata($url, 'packages');
- 	foreach (split(/\,/,$metadata)) {
- 	    if ($_ =~ /^part_(.*)$/) {
- 		if (!&Apache::loncommon::check_if_partid_hidden($1,$symb)) {
- 		    push(@parts, $1);
- 		}
- 	    }
- 	}
-     }
      my @stores;
-     foreach my $part (@parts) {
+     foreach my $part (@{ $partlist }) {
- 	my (@metakeys) = split(/,/,&Apache::lonnet::metadata($url,'keys'));
  	foreach my $key (@metakeys) {
  	    if ($key =~ m/^stores_\Q$part\E_/) { push(@stores,$key); }
  	}
- Line 195  sub showResourceInfo {
+ Line 264  sub showResourceInfo {
      return $result,$responseType,$hdgrade,$partlist,$handgrade;
  }
+ sub reset_caches {
+     &reset_analyze_cache();
+     &reset_perm();
+ }
- sub get_order {
+ {
-     my ($partid,$respid,$symb,$uname,$udom)=@_;
+     my %analyze_cache;
-     my (undef,undef,$url)=&Apache::lonnet::decode_symb($symb);
-     $url=&Apache::lonnet::clutter($url);
+     sub reset_analyze_cache {
-     my $subresult=&Apache::lonnet::ssi($url,
+ 	undef(%analyze_cache);
- 				       ('grade_target' => 'analyze'),
+     }
- 				       ('grade_domain' => $udom),
- 				       ('grade_symb' => $symb),
+     sub get_analyze {
- 				       ('grade_courseid' =>
+ 	my ($symb,$uname,$udom)=@_;
- 					        $env{'request.course.id'}),
+ 	my $key = "$symb\0$uname\0$udom";
- 				       ('grade_username' => $uname));
+ 	return $analyze_cache{$key} if (exists($analyze_cache{$key}));
-     (undef,$subresult)=split(/_HASH_REF__/,$subresult,2);
-     my %analyze=&Apache::lonnet::str2hash($subresult);
+ 	my (undef,undef,$url)=&Apache::lonnet::decode_symb($symb);
-     return ($analyze{"$partid.$respid.shown"});
+ 	$url=&Apache::lonnet::clutter($url);
+ 	my $subresult=&Apache::lonnet::ssi($url,
+ 					   ('grade_target' => 'analyze'),
+ 					   ('grade_domain' => $udom),
+ 					   ('grade_symb' => $symb),
+ 					   ('grade_courseid' =>
+ 					    $env{'request.course.id'}),
+ 					   ('grade_username' => $uname));
+ 	(undef,$subresult)=split(/_HASH_REF__/,$subresult,2);
+ 	my %analyze=&Apache::lonnet::str2hash($subresult);
+ 	return $analyze_cache{$key} = \%analyze;
+     }
+     sub get_order {
+ 	my ($partid,$respid,$symb,$uname,$udom)=@_;
+ 	my $analyze = &get_analyze($symb,$uname,$udom);
+ 	return $analyze->{"$partid.$respid.shown"};
+     }
+     sub get_radiobutton_correct_foil {
+ 	my ($partid,$respid,$symb,$uname,$udom)=@_;
+ 	my $analyze = &get_analyze($symb,$uname,$udom);
+ 	foreach my $foil (@{&get_order($partid,$respid,$symb,$uname,$udom)}) {
+ 	    if ($analyze->{"$partid.$respid.foil.value.$foil"} eq 'true') {
+ 		return $foil;
+ 	    }
+ 	}
+     }
  }
  #--- Clean response type for display
  #--- Currently filters option/rank/radiobutton/match/essay/Task
  #        response types only.
- Line 259  sub cleanRecord {
+ Line 360  sub cleanRecord {
      } elsif ($response eq 'radiobutton') {
  	my %answer=&Apache::lonnet::str2hash($answer);
  	my ($toprow,$bottomrow);
- 	my $correct=($order->[0])+1;
+ 	my $correct =
- 	for (my $i=1;$i<=$#$order;$i++) {
+ 	    &get_radiobutton_correct_foil($partid,$respid,$symb,$uname,$udom);
- 	    my $foil=$order->[$i];
+ 	foreach my $foil (@$order) {
  	    if (exists($answer{$foil})) {
- 		if ($i == $correct) {
+ 		if ($foil eq $correct) {
  		    $toprow.='<td><b>true</b></td>';
  		} else {
  		    $toprow.='<td><i>true</i></td>';
- Line 327  sub cleanRecord {
+ Line 428  sub cleanRecord {
  	    $result.='</ul>';
  	    return $result;
  	}
+     } elsif ( $response =~ m/(?:numerical|formula)/) {
+ 	$answer =
+ 	    &Apache::loncommon::format_previous_attempt_value('submission',
+ 							      $answer);
      }
      return $answer;
  }
- Line 371  COMMONJSFUNCTIONS
+ Line 475  COMMONJSFUNCTIONS
  #--- Dumps the class list with usernames,list of sections,
  #--- section, ids and fullnames for each user.
  sub getclasslist {
-     my ($getsec,$filterlist) = @_;
+     my ($getsec,$filterlist,$getgroup) = @_;
      my @getsec;
+     my @getgroup;
+     my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));
      if (!ref($getsec)) {
  	if ($getsec ne '' && $getsec ne 'all') {
  	    @getsec=($getsec);
- Line 381  sub getclasslist {
+ Line 487  sub getclasslist {
  	@getsec=@{$getsec};
      }
      if (grep(/^all$/,@getsec)) { undef(@getsec); }
+     if (!ref($getgroup)) {
+ 	if ($getgroup ne '' && $getgroup ne 'all') {
+ 	    @getgroup=($getgroup);
+ 	}
+     } else {
+ 	@getgroup=@{$getgroup};
+     }
+     if (grep(/^all$/,@getgroup)) { undef(@getgroup); }
-     my $classlist=&Apache::loncoursedata::get_classlist();
+     my ($classlist,$keylist)=&Apache::loncoursedata::get_classlist();
      # Bail out if we were unable to get the classlist
      return if (! defined($classlist));
+     &Apache::loncoursedata::get_group_memberships($classlist,$keylist);
      #
      my %sections;
      my %fullnames;
- Line 401  sub getclasslist {
+ Line 516  sub getclasslist {
              $classlist->{$student}->[&Apache::loncoursedata::CL_FULLNAME()];
          my $status   =
              $classlist->{$student}->[&Apache::loncoursedata::CL_STATUS()];
+         my $group   =
+             $classlist->{$student}->[&Apache::loncoursedata::CL_GROUP()];
  	# filter students according to status selected
- 	if ($filterlist && $env{'form.Status'} ne 'Any') {
+ 	if ($filterlist && (!($stu_status =~ /Any/))) {
- 	    if ($env{'form.Status'} ne $status) {
+ 	    if (!($stu_status =~ $status)) {
- 		delete ($classlist->{$student});
+ 		delete($classlist->{$student});
  		next;
  	    }
  	}
+ 	# filter students according to groups selected
+ 	my @stu_groups = split(/,/,$group);
+ 	if (@getgroup) {
+ 	    my $exclude = 1;
+ 	    foreach my $grp(@getgroup) {
+ 	        foreach my $stu_group(@stu_groups) {
+ 	            if ($stu_group eq $grp) {
+ 	                $exclude = 0;
+     	            }
+ 	        }
+     	        if (($grp eq 'none') && !$group) {
+         	        $exclude = 0;
+         	}
+ 	    }
+ 	    if ($exclude) {
+ 	        delete($classlist->{$student});
+ 	    }
+ 	}
  	$section = ($section ne '' ? $section : 'none');
  	if (&canview($section)) {
  	    if (!@getsec || grep(/^\Q$section\E$/,@getsec)) {
  		$sections{$section}++;
- 		$fullnames{$student}=$fullname;
+ 		if ($classlist->{$student}) {
+ 		    $fullnames{$student}=$fullname;
+ 		}
  	    } else {
  		delete($classlist->{$student});
  	    }
- Line 485  sub student_gradeStatus {
+ Line 622  sub student_gradeStatus {
  # Shows a student's view of problem and submission
  sub jscriptNform {
      my ($symb) = @_;
+     my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));
      my $jscript='<script type="text/javascript" language="javascript">'."\n".
  	'    function viewOneStudent(user,domain) {'."\n".
  	'	document.onestudent.student.value = user;'."\n".
- Line 496  sub jscriptNform {
+ Line 634  sub jscriptNform {
  	'<input type="hidden" name="symb"    value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
  	'<input type="hidden" name="saveState" value="'.$env{'form.saveState'}.'" />'."\n".
  	'<input type="hidden" name="probTitle" value="'.$env{'form.probTitle'}.'" />'."\n".
- 	'<input type="hidden" name="Status"  value="'.$env{'form.Status'}.'" />'."\n".
+ 	'<input type="hidden" name="Status"  value="'.$stu_status.'" />'."\n".
  	'<input type="hidden" name="command" value="submission" />'."\n".
  	'<input type="hidden" name="student" value="" />'."\n".
  	'<input type="hidden" name="userdom" value="" />'."\n".
- Line 504  sub jscriptNform {
+ Line 642  sub jscriptNform {
      return $jscript;
  }
  # Given the score (as a number [0-1] and the weight) what is the final
  # point value? This function will round to the nearest tenth, third,
  # or quarter if one of those is within the tolerance of .00001.
- Line 538  sub compute_points {
+ Line 678  sub compute_points {
  #
  sub most_similar {
-     my ($uname,$udom,$uessay)=@_;
+     my ($uname,$udom,$uessay,$old_essays)=@_;
  # ignore spaces and punctuation
- Line 555  sub most_similar {
+ Line 695  sub most_similar {
      my $scrsid='';
      my $sessay='';
  # go through all essays ...
-     foreach my $tkey (keys %oldessays) {
+     foreach my $tkey (keys(%$old_essays)) {
- 	my ($tname,$tdom,$tcrsid)=split(/\./,$tkey);
+ 	my ($tname,$tdom,$tcrsid)=map {&unescape($_)} (split(/\./,$tkey));
  # ... except the same student
-         if (($tname ne $uname) || ($tdom ne $udom)) {
+         next if (($tname eq $uname) && ($tdom eq $udom));
- 	    my $tessay=$oldessays{$tkey};
+ 	my $tessay=$old_essays->{$tkey};
-             $tessay=~s/\W+/ /gs;
+ 	$tessay=~s/\W+/ /gs;
  # String similarity gives up if not even limit
-             my $tsimilar=&String::Similarity::similarity($uessay,$tessay,$limit);
+ 	my $tsimilar=&String::Similarity::similarity($uessay,$tessay,$limit);
  # Found one
-             if ($tsimilar>$limit) {
+ 	if ($tsimilar>$limit) {
- 		$limit=$tsimilar;
+ 	    $limit=$tsimilar;
-                 $sname=$tname;
+ 	    $sname=$tname;
-                 $sdom=$tdom;
+ 	    $sdom=$tdom;
-                 $scrsid=$tcrsid;
+ 	    $scrsid=$tcrsid;
-                 $sessay=$oldessays{$tkey};
+ 	    $sessay=$old_essays->{$tkey};
-             }
+ 	}
-         }
      }
      if ($limit>0.6) {
         return ($sname,$sdom,$scrsid,$sessay,$limit);
- Line 661  sub listStudents {
+ Line 800  sub listStudents {
      my $cdom      = $env{"course.$env{'request.course.id'}.domain"};
      my $cnum      = $env{"course.$env{'request.course.id'}.num"};
      my $getsec    = $env{'form.section'} eq '' ? 'all' : $env{'form.section'};
+     my $getgroup  = $env{'form.group'} eq '' ? 'all' : $env{'form.group'};
      my $submitonly= $env{'form.submitonly'} eq '' ? 'all' : $env{'form.submitonly'};
      my $viewgrade = $env{'form.showgrading'} eq 'yes' ? 'View/Grade/Regrade' : 'View';
      $env{'form.probTitle'} = $env{'form.probTitle'} eq '' ?
  	&Apache::lonnet::gettitle($symb) : $env{'form.probTitle'};
- Line 722  LISTJAVASCRIPT
+ Line 861  LISTJAVASCRIPT
      if ($env{'form.handgrade'} eq 'yes' && scalar(@$partlist) > 1) {
  	$gradeTable.='<label><input type="radio" name="lastSub" value="hdgrade" '.$checkhdgrade.' /> essay part only </label>'."\n";
      }
+     my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));
-     my $saveStatus = $env{'form.Status'} eq '' ? 'Active' : $env{'form.Status'};
+     my $saveStatus = $stu_status eq '' ? 'Active' : $stu_status;
      $env{'form.Status'} = $saveStatus;
      $gradeTable.='<label><input type="radio" name="lastSub" value="lastonly" '.$checklastsub.' /> last submission only </label>'."\n".
  	'<label><input type="radio" name="lastSub" value="last" /> last submission & parts info </label>'."\n".
  	'<label><input type="radio" name="lastSub" value="datesub" /> by dates and submissions </label>'."\n".
- Line 736  LISTJAVASCRIPT
+ Line 874  LISTJAVASCRIPT
          '<option value=".25">Quarter Points</option>'.
          '<option value=".1">Tenths of a Point</option>'.
          '</select>'.
+         &build_section_inputs().
- 	'<input type="hidden" name="section"     value="'.$getsec.'" />'."\n".
  	'<input type="hidden" name="submitonly"  value="'.$submitonly.'" />'."\n".
  	'<input type="hidden" name="handgrade"   value="'.$env{'form.handgrade'}.'" /><br />'."\n".
  	'<input type="hidden" name="showgrading" value="'.$env{'form.showgrading'}.'" /><br />'."\n".
- Line 747  LISTJAVASCRIPT
+ Line 884  LISTJAVASCRIPT
  	'<input type="hidden" name="saveStatusOld" value="'.$saveStatus.'" />'."\n";
      if (exists($env{'form.gradingMenu'}) && exists($env{'form.Status'})) {
- 	$gradeTable.='<input type="hidden" name="Status"   value="'.$env{'form.Status'}.'" />'."\n";
+ 	$gradeTable.='<input type="hidden" name="Status"   value="'.$stu_status.'" />'."\n";
      } else {
  	$gradeTable.='<b>Student Status:</b> '.
  	    &Apache::lonhtmlcommon::StatusOptions($saveStatus,undef,1,'javascript:reLoadList(this.form);').'<br />';
- Line 764  LISTJAVASCRIPT
+ Line 901  LISTJAVASCRIPT
  	'value="Next->" /> <br />'."\n";
      $gradeTable.=&check_buttons();
      $gradeTable.='<label><input type="checkbox" name="checkPlag" checked="checked" />Check For Plagiarism</label>';
-     my ($classlist, undef, $fullname) = &getclasslist($getsec,'1');
+     my ($classlist, undef, $fullname) = &getclasslist($getsec,'1',$getgroup);
      $gradeTable.='<table border="0"><tr><td bgcolor="#777777">'.
  	'<table border="0"><tr bgcolor="#e6ffff">';
      my $loop = 0;
- Line 839  LISTJAVASCRIPT
+ Line 976  LISTJAVASCRIPT
  	$ctr++;
  	my $section = $classlist->{$student}->[&Apache::loncoursedata::CL_SECTION()];
+         my $group = $classlist->{$student}->[&Apache::loncoursedata::CL_GROUP()];
  	if ( $perm{'vgr'} eq 'F' ) {
  	    $gradeTable.='<tr bgcolor="#ffffe6">' if ($ctr%2 ==1);
  	    $gradeTable.='<td align="right">'.$ctr.'&nbsp;</td>'.
- Line 847  LISTJAVASCRIPT
+ Line 984  LISTJAVASCRIPT
                 $student.':'.$$fullname{$student}.':::SECTION'.$section.
  	       ')&nbsp;" />&nbsp;&nbsp;</label></td>'."\n".'<td>'.
  	       &nameUserString(undef,$$fullname{$student},$uname,$udom).
- 	       '&nbsp;'.$section.'</td>'."\n";
+ 	       '&nbsp;'.$section.'/'.$group.'</td>'."\n";
  	    if ($env{'form.showgrading'} eq 'yes' && $submitonly ne 'all') {
  		foreach (sort keys(%status)) {
- Line 1663  sub download_all_link {
+ Line 1800  sub download_all_link {
      return
  }
+ sub build_section_inputs {
+     my $section_inputs;
+     if ($env{'form.section'} eq '') {
+         $section_inputs .= '<input type="hidden" name="section" value="all" />'."\n";
+     } else {
+         my @sections = &Apache::loncommon::get_env_multiple('form.section');
+         foreach my $section (@sections) {
+             $section_inputs .= '<input type="hidden" name="section" value="'.$section.'" />'."\n";
+         }
+     }
+     return $section_inputs;
+ }
  # --------------------------- show submissions of a student, option to grade
  sub submission {
      my ($request,$counter,$total) = @_;
      my ($uname,$udom)     = ($env{'form.student'},$env{'form.userdom'});
      $udom = ($udom eq '' ? $env{'user.domain'} : $udom); #has form.userdom changed for a student?
      my $usec = &Apache::lonnet::getsection($udom,$uname,$env{'request.course.id'});
      $env{'form.fullname'} = &Apache::loncommon::plainname($uname,$udom,'lastname') if $env{'form.fullname'} eq '';
      my $symb = &get_symb($request);
      if ($symb eq '') { $request->print("Unable to handle ambiguous references:."); return ''; }
- Line 1691  sub submission {
+ Line 1839  sub submission {
  	'" src="'.$request->dir_config('lonIconsURL').
  	'/check.gif" height="16" border="0" />';
+     my %old_essays;
      # header info
      if ($counter == 0) {
  	&sub_page_js($request);
- Line 1723  sub submission {
+ Line 1872  sub submission {
  	    &Apache::lonxml::clear_problem_counter();
  	    $request->print(&show_problem($request,$symb,$uname,$udom,0,1,$mode));
  	}
  	# kwclr is the only variable that is guaranteed to be non blank
          # if this subroutine has been called once.
  	my %keyhash = ();
- Line 1742  sub submission {
+ Line 1891  sub submission {
  	    $env{'form.savemsgN'} = $keyhash{$symb.'_savemsgN'} ne '' ? $keyhash{$symb.'_savemsgN'} : '0';
  	}
  	my $overRideScore = $env{'form.overRideScore'} eq '' ? 'no' : $env{'form.overRideScore'};
+ 	my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));
  	$request->print('<form action="/adm/grades" method="post" name="SCORE" enctype="multipart/form-data">'."\n".
  			'<input type="hidden" name="command"    value="handgrade" />'."\n".
  			'<input type="hidden" name="saveState"  value="'.$env{'form.saveState'}.'" />'."\n".
- 			'<input type="hidden" name="Status"     value="'.$env{'form.Status'}.'" />'."\n".
+ 			'<input type="hidden" name="Status"     value="'.$stu_status.'" />'."\n".
  			'<input type="hidden" name="overRideScore" value="'.$overRideScore.'" />'."\n".
  			'<input type="hidden" name="probTitle"  value="'.$env{'form.probTitle'}.'" />'."\n".
  			'<input type="hidden" name="refresh"    value="off" />'."\n".
- Line 1757  sub submission {
+ Line 1906  sub submission {
  			'<input type="hidden" name="vProb"      value="'.$env{'form.vProb'}.'" />'."\n".
  			'<input type="hidden" name="vAns"       value="'.$env{'form.vAns'}.'" />'."\n".
  			'<input type="hidden" name="lastSub"    value="'.$env{'form.lastSub'}.'" />'."\n".
- 			'<input type="hidden" name="section"    value="'.$env{'form.section'}.'" />'."\n".
+ 			&build_section_inputs().
  			'<input type="hidden" name="submitonly" value="'.$env{'form.submitonly'}.'" />'."\n".
  			'<input type="hidden" name="handgrade"  value="'.$env{'form.handgrade'}.'" />'."\n".
  			'<input type="hidden" name="NCT"'.
- Line 1805  KEYWORDS
+ Line 1954  KEYWORDS
  	    my ($adom,$aname,$apath)=($essayurl=~/^($LONCAPA::domain_re)\/($LONCAPA::username_re)\/(.*)$/);
  	    $apath=&escape($apath);
  	    $apath=~s/\W/\_/gs;
- 	    %oldessays=&Apache::lonnet::dump('nohist_essay_'.$apath,$adom,$aname);
+ 	    %old_essays=&Apache::lonnet::dump('nohist_essay_'.$apath,$adom,$aname);
          }
      }
+ # This is where output for one specific student would start
+     my $bgcolor='#DDEEDD';
+     if (int($counter/2) eq $counter) { $bgcolor='#DDDDEE'; }
+     $request->print("\n\n".
+                     '<p><table border="2"><tr><th bgcolor="'.$bgcolor.'">'.$env{'form.fullname'}.'</th></tr><tr><td bgcolor="'.$bgcolor.'">');
      if ($env{'form.vProb'} eq 'all' or $env{'form.vAns'} eq 'all') {
- 	$request->print('<br /><br /><br />') if ($counter > 0);
  	my $mode;
  	if ($env{'form.vProb'} eq 'all' && $env{'form.vAns'} eq 'all') {
  	    $mode='both';
- Line 1943  KEYWORDS
+ Line 2097  KEYWORDS
  		    my $similar='';
  		    if($env{'form.checkPlag'}){
  			my ($oname,$odom,$ocrsid,$oessay,$osim)=
- 			    &most_similar($uname,$udom,$subval);
+ 			    &most_similar($uname,$udom,$subval,\%old_essays);
  			if ($osim) {
  			    $osim=int($osim*100.0);
- 			    $similar="<hr /><h3><span class=\"LC_warning\">Essay".
+ 			    my %old_course_desc =
- 				" is $osim% similar to an essay by ".
+ 				&Apache::lonnet::coursedescription($ocrsid,
- 				&Apache::loncommon::plainname($oname,$odom).
+ 								   {'one_time' => 1});
+ 			    $similar="<hr /><h3><span class=\"LC_warning\">".
+ 				&mt('Essay is [_1]% similar to an essay by [_2] ([_3]:[_4]) in course [_5] (course id [_6]:[_7])',
+ 				    $osim,
+ 				    &Apache::loncommon::plainname($oname,$odom),
+ 				    $oname,$odom,
+ 				    $old_course_desc{'description'},
+ 				    $old_course_desc{'num'},
+ 				    $old_course_desc{'domain'}).
  				'</span></h3><blockquote><i>'.
  				&keywords_highlight($oessay).
  				'</i></blockquote><hr />';
- Line 2071  KEYWORDS
+ Line 2234  KEYWORDS
      }
      $request->print($result.'</td></tr></table></td></tr></table>'."\n");
+ # Done with printing info for one student
+     $request->print('</td></tr></table></p>');
      # print end of form
      if ($counter == $total) {
  	my $endform='<table border="0"><tr><td>'."\n";
- Line 2733  sub version_selected_portfile {
+ Line 2901  sub version_selected_portfile {
      my $new_answer;
      $env{'form.copy'} = &Apache::lonnet::getfile("/uploaded/$domain/$stu_name/portfolio$directory$file_name");
      if($env{'form.copy'} eq '-1') {
-         &Apache::lonnet::logthis('problem getting file '.$file_name);
          $new_answer = 'problem getting file';
      } else {
          $new_answer = $answer_name.'.'.$version.'.'.$answer_ext;
- Line 2954  sub viewgrades {
+ Line 3121  sub viewgrades {
      $result.=&jscriptNform($symb);
      #beginning of class grading form
+     my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));
      $result.= '<form action="/adm/grades" method="post" name="classgrade">'."\n".
  	'<input type="hidden" name="symb"    value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
  	'<input type="hidden" name="command" value="editgrades" />'."\n".
- 	'<input type="hidden" name="section" value="'.$env{'form.section'}.'" />'."\n".
+ 	&build_section_inputs().
  	'<input type="hidden" name="saveState" value="'.$env{'form.saveState'}.'" />'."\n".
- 	'<input type="hidden" name="Status" value="'.$env{'form.Status'}.'" />'."\n".
+ 	'<input type="hidden" name="Status" value="'.$env{'stu_status'}.'" />'."\n".
  	'<input type="hidden" name="probTitle" value="'.$env{'form.probTitle'}.'" />'."\n";
      my $sectionClass;
+     my $section_display = join (", ",&Apache::loncommon::get_env_multiple('form.section'));
      if ($env{'form.section'} eq 'all') {
  	$sectionClass='Class </h3>';
      } elsif ($env{'form.section'} eq 'none') {
- 	$sectionClass='Students in no Section </h3>';
+ 	$sectionClass=&mt('Students in no Section').'</h3>';
      } else {
- 	$sectionClass='Students in Section '.$env{'form.section'}.'</h3>';
+ 	$sectionClass=&mt('Students in Section(s) [_1]',$section_display).'</h3>';
      }
-     $result.='<h3>Assign Common Grade To '.$sectionClass;
+     $result.='<h3>'.&mt('Assign Common Grade To [_1]',$sectionClass);
      $result.= '<table border=0><tr><td bgcolor="#777777">'."\n".
  	'<table border=0><tr bgcolor="#ffffdd"><td>';
      #radio buttons/text box for assigning points for a section or class.
- Line 3076  sub viewgrades {
+ Line 3245  sub viewgrades {
  	'onClick="javascript:submit();" target="_self" /></form>'."\n";
      if (scalar(%$fullname) eq 0) {
  	my $colspan=3+scalar(@parts);
- 	$result='<span class="LC_warning">There are no students in section "'.$env{'form.section'}.
+ 	my $section_display = join (", ",&Apache::loncommon::get_env_multiple('form.section'));
- 	    '" with enrollment status "'.$env{'form.Status'}.'" to modify or grade.</span>';
+         my $stu_status = join(' or ',&Apache::loncommon::get_env_multiple('form.Status'));
+ 	$result='<span class="LC_warning">'.
+ 	    &mt('There are no students in section(s) [_1] with enrollment status [_2] to modify or grade',
+ 	        $section_display, $stu_status).
+ 	    '</span>';
      }
      $result.=&show_grading_menu_form($symb);
      return $result;
- Line 3154  sub editgrades {
+ Line 3327  sub editgrades {
      my ($request) = @_;
      my $symb=&get_symb($request);
-     my $title='<h3><span class="LC_info">Current Grade Status</span></h3>';
+     my $section_display = join (", ",&Apache::loncommon::get_env_multiple('form.section'));
-     $title.='<h4><b>Current Resource: </b>'.$env{'form.probTitle'}.'</h4><br />'."\n";
+     my $title='<h3><span class="LC_info">'.&mt('Current Grade Status').'</span></h3>';
-     $title.='<h4><b>Section: </b>'.$env{'form.section'}.'</h4>'."\n";
+     $title.='<h4>'.&mt('<b>Current Resource: </b>[_1]',$env{'form.probTitle'}).'</h4><br />'."\n";
+     $title.='<h4>'.&mt('<b>Section: </b>[_1]',$section_display).'</h4>'."\n";
      my $result= '<table border="0"><tr><td bgcolor="#777777">'."\n";
      $result.= '<table border="0"><tr bgcolor="#deffff">'.
- Line 3354  sub split_part_type {
+ Line 3528  sub split_part_type {
      my ($partstr) = @_;
      my ($temp,@allparts)=split(/_/,$partstr);
      my $type=pop(@allparts);
-     my $part=join('.',@allparts);
+     my $part=join('_',@allparts);
      return ($part,$type);
  }
- Line 3760  sub csvuploadassign {
+ Line 3934  sub csvuploadassign {
  	}
  	if (! %grades) { push(@skipped,"$username:$domain no data to save"); }
  	$grades{"resource.regrader"}="$env{'user.name'}:$env{'user.domain'}";
- #	&Apache::lonnet::logthis(" storing ".(join('-',%grades)));
  	my $result=&Apache::lonnet::cstore(\%grades,$symb,
  					   $env{'request.course.id'},
  					   $domain,$username);
- Line 3827  LISTJAVASCRIPT
+ Line 4000  LISTJAVASCRIPT
      $result.='<form action="/adm/grades" method="post" name="displayPage">'."\n";
      $result.='&nbsp;<b>Problems from:</b> <select name="selectpage">'."\n";
-     my ($titles,$symbx) = &getSymbMap($request);
+     my ($titles,$symbx) = &getSymbMap();
      my ($curpage) =&Apache::lonnet::decode_symb($symb);
  #    my ($curpage,$mapId) =&Apache::lonnet::decode_symb($symb);
  #    my $type=($curpage =~ /\.(page|sequence)/);
- Line 3857  LISTJAVASCRIPT
+ Line 4030  LISTJAVASCRIPT
  	'<label><input type="radio" name="lastSub" value="none" /> none</label>'."\n".
  	'<label><input type="radio" name="lastSub" value="datesub" checked="checked" /> by dates and submissions</label>'."\n".
  	'<label><input type="radio" name="lastSub" value="all" /> all details</label>'."\n";
-     $result.='<input type="hidden" name="section"     value="'.$getsec.'" />'."\n".
+     $result.=&build_section_inputs();
- 	'<input type="hidden" name="Status"  value="'.$env{'form.Status'}.'" />'."\n".
+     my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));
+     $result.='<input type="hidden" name="Status"  value="'.$stu_status.'" />'."\n".
  	'<input type="hidden" name="command" value="displayPage" />'."\n".
  	'<input type="hidden" name="symb"    value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
  	'<input type="hidden" name="saveState" value="'.$env{'form.saveState'}.'" />'."<br />\n";
- Line 3909  LISTJAVASCRIPT
+ Line 4083  LISTJAVASCRIPT
  }
  sub getSymbMap {
-     my ($request) = @_;
      my $navmap = Apache::lonnavmaps::navmap->new();
      my %symbx = ();
- Line 4113  sub displaySubByDates {
+ Line 4286  sub displaySubByDates {
  	my $where = ($isTask ? "$version:resource.$interaction"
  		             : "$version:resource");
- 	#&Apache::lonnet::logthis(" got $where");
  	$studentTable.='<tr bgcolor="#ffffff" valign="top"><td>'.$timestamp.'</td>';
  	if ($isCODE) {
  	    $studentTable.='<td>'.$record->{$version.':resource.CODE'}.'</td>';
- Line 4133  sub displaySubByDates {
+ Line 4305  sub displaySubByDates {
  		    my ($responseId)= ($isTask ? ($matchKey=~ /^resource\.(.*?)\.\Q$partid\E\.award$/)
  				               : ($matchKey=~ /^resource\.\Q$partid\E\.(.*?)\.submission$/));
- 		    #&Apache::lonnet::logthis("match $matchKey $responseId (".$$record{$version.':'.$matchKey});
  		    $displaySub[0].='<b>Part:</b>&nbsp;'.$display_part.'&nbsp;';
  		    $displaySub[0].='<span class="LC_internal_info">(ID&nbsp;'.
  			$responseId.')</span>&nbsp;<b>';
- Line 4354  sub updateGradeByPage {
+ Line 4525  sub updateGradeByPage {
  #
  #------ start of section for handling grading by page/sequence ---------
- # Create the hidden field entries used to hold context/default values.
+ =pod
+ =head1 Bubble sheet grading routines
+   For this documentation:
+    'scanline' refers to the full line of characters
+    from the file that we are parsing that represents one entire sheet
+    'bubble line' refers to the data
+    representing the line of bubbles that are on the physical bubble sheet
+ The overall process is that a scanned in bubble sheet data is uploaded
+ into a course. When a user wants to grade, they select a
+ sequence/folder of resources, a file of bubble sheet info, and pick
+ one of the predefined configurations for what each scanline looks
+ like.
+ Next each scanline is checked for any errors of either 'missing
+ bubbles' (it's an error because it may have been mis-scanned
+ because too light bubbling), 'double bubble' (each bubble line should
+ have no more that one letter picked), invalid or duplicated CODE,
+ invalid student ID
+ If the CODE option is used that determines the randomization of the
+ homework problems, either way the student ID is looked up into a
+ username:domain.
+ During the validation phase the instructor can choose to skip scanlines.
+ After the validation phase, there are now 3 bubble sheet files
+   scantron_original_filename (unmodified original file)
+   scantron_corrected_filename (file where the corrected information has replaced the original information)
+   scantron_skipped_filename (contains the exact text of scanlines that where skipped)
+ Also there is a separate hash nohist_scantrondata that contains extra
+ correction information that isn't representable in the bubble sheet
+ file (see &scantron_getfile() for more information)
+ After all scanlines are either valid, marked as valid or skipped, then
+ foreach line foreach problem in the picked sequence, an ssi request is
+ made that simulates a user submitting their selected letter(s) against
+ the homework problem.
+ =over 4
+ =item defaultFormData
+   Returns html hidden inputs used to hold context/default values.
+  Arguments:
+   $symb - $symb of the current resource
+ =cut
  sub defaultFormData {
      my ($symb)=@_;
-     return '
+     return '<input type="hidden" name="symb"    value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
-       <input type="hidden" name="symb"    value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
       '<input type="hidden" name="saveState" value="'.$env{'form.saveState'}.'" />'."\n".
       '<input type="hidden" name="probTitle" value="'.$env{'form.probTitle'}.'" />'."\n";
  }
- # Make a drop down of the sequences
+ =pod
+ =item getSequenceDropDown
+    Return html dropdown of possible sequences to grade
+  Arguments:
+    $symb - $symb of the current resource
+ =cut
  sub getSequenceDropDown {
-     my ($request,$symb)=@_;
+     my ($symb)=@_;
      my $result='<select name="selectpage">'."\n";
-     my ($titles,$symbx) = &getSymbMap($request);
+     my ($titles,$symbx) = &getSymbMap();
      my ($curpage)=&Apache::lonnet::decode_symb($symb);
      my $ctr=0;
      foreach (@$titles) {
- Line 4383  sub getSequenceDropDown {
+ Line 4620  sub getSequenceDropDown {
      return $result;
  }
- # Returns a list of the scantron files that have been uploaded to date.
+ =pod
+ =item scantron_filenames
+    Returns a list of the scantron files in the current course
+ =cut
  sub scantron_filenames {
      my $cdom=$env{'course.'.$env{'request.course.id'}.'.domain'};
- Line 4400  sub scantron_filenames {
+ Line 4644  sub scantron_filenames {
      return @possiblenames;
  }
- # Returns the html required for a drop-down list of scantron
+ =pod
- # files that have been uploaded.
+ =item scantron_uploads
+    Returns  html drop-down list of scantron files in current course.
+  Arguments:
+    $file2grade - filename to set as selected in the dropdown
+ =cut
  sub scantron_uploads {
      my ($file2grade) = @_;
- Line 4414  sub scantron_uploads {
+ Line 4666  sub scantron_uploads {
      return $result;
  }
- # Returns the html for a drop down list of the scantron formats in the
+ =pod
- # scantronformat.tab file.
+ =item scantron_scantab
+   Returns html drop down of the scantron formats in the scantronformat.tab
+   file.
+ =cut
  sub scantron_scantab {
      my $fh=Apache::File->new($Apache::lonnet::perlvar{'lonTabDir'}.'/scantronformat.tab');
- Line 4431  sub scantron_scantab {
+ Line 4689  sub scantron_scantab {
      return $result;
  }
- #  Returns the html for the options in the
+ =pod
- #  saved codes dropdown.
+ =item scantron_CODElist
+   Returns html drop down of the saved CODE lists from current course,
+   generated from earlier printings.
+ =cut
  sub scantron_CODElist {
      my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
- Line 4448  sub scantron_CODElist {
+ Line 4712  sub scantron_CODElist {
      return $namechoice;
  }
- # Returns the HTML for "Each CODE to be used once" radio.
+ =pod
+ =item scantron_CODEunique
+   Returns the html for "Each CODE to be used once" radio.
+ =cut
  sub scantron_CODEunique {
      my $result='<span style="white-space: nowrap;">
                   <label><input type="radio" name="scantron_CODEunique"
-                         value="yes" checked="checked" /> Yes </label>
+                         value="yes" checked="checked" />'.&mt('Yes').' </label>
                  </span>
                  <span style="white-space: nowrap;">
                   <label><input type="radio" name="scantron_CODEunique"
-                         value="no" /> No </label>
+                         value="no" />'.&mt('No').' </label>
                  </span>';
      return $result;
  }
- #
- #    Display the first scantron file selection form.
+ =pod
- # Paramters:
- #    r           - The apache request object
+ =item scantron_selectphase
- #    file2grade  - The name of the scantron file to be graded(?).
+   Generates the initial screen to start the bubble sheet process.
+   Allows for - starting a grading run.
+              - downloading existing scan data (original, corrected
+                                                 or skipped info)
+              - uploading new scan data
+  Arguments:
+   $r          - The Apache request object
+   $file2grade - name of the file that contain the scanned data to score
+ =cut
  sub scantron_selectphase {
      my ($r,$file2grade) = @_;
      my ($symb)=&get_symb($r);
      if (!$symb) {return '';}
-     my $sequence_selector=&getSequenceDropDown($r,$symb);
+     my $sequence_selector=&getSequenceDropDown($symb);
      my $default_form_data=&defaultFormData($symb);
      my $grading_menu_button=&show_grading_menu_form($symb);
      my $file_selector=&scantron_uploads($file2grade);
- Line 4479  sub scantron_selectphase {
+ Line 4761  sub scantron_selectphase {
      my $CODE_selector=&scantron_CODElist();
      my $CODE_unique=&scantron_CODEunique();
      my $result;
-     #FIXME allow instructor to be able to download the scantron file
-     # and to upload it,
      # Chunk of form to prompt for a file to grade and how:
- Line 4516  sub scantron_selectphase {
+ Line 4796  sub scantron_selectphase {
  	    <td> Options: </td>
              <td>
  	       <label><input type="checkbox" name="scantron_options_redo" value="redo_skipped"/> Do only previously skipped records</label> <br />
-                <label><input type="checkbox" name="scantron_options_ignore" value="ignore_corrections"/> Remove all exisiting corrections</label> <br />
+                <label><input type="checkbox" name="scantron_options_ignore" value="ignore_corrections"/> Remove all existing corrections</label> <br />
                 <label><input type="checkbox" name="scantron_options_hidden" value="ignore_hidden"/> Skip hidden resources when grading</label>
  	    </td>
            </tr>
- Line 4621  SCANTRONFORM
+ Line 4901  SCANTRONFORM
      return
  }
- # Parse and return the scantron configuration line selected as a
+ =pod
- # hash of configuration file fields.
- #
+ =item get_scantron_config
- # Parameters:
- #   which - the name of the configuration to parse from the file.
+    Parse and return the scantron configuration line selected as a
- #           If the named configuration is not in the file, an empty
+    hash of configuration file fields.
- #           hash is returned.
+  Arguments:
+     which - the name of the configuration to parse from the file.
+  Returns:
+             If the named configuration is not in the file, an empty
+             hash is returned.
+     a hash with the fields
+       name         - internal name for the this configuration setup
+       description  - text to display to operator that describes this config
+       CODElocation - if 0 or the string 'none'
+                           - no CODE exists for this config
+                      if -1 || the string 'letter'
+                           - a CODE exists for this config and is
+                             a string of letters
+                      Unsupported value (but planned for future support)
+                           if a positive integer
+                                - The CODE exists as the first n items from
+                                  the question section of the form
+                           if the string 'number'
+                                - The CODE exists for this config and is
+                                  a string of numbers
+       CODEstart   - (only matter if a CODE exists) column in the line where
+                      the CODE starts
+       CODElength  - length of the CODE
+       IDstart     - column where the student ID number starts
+       IDlength    - length of the student ID info
+       Qstart      - column where the information from the bubbled
+                     'questions' start
+       Qlength     - number of columns comprising a single bubble line from
+                     the sheet. (usually either 1 or 10)
+       Qon         - either a single character representing the character used
+                     to signal a bubble was chosen in the positional setup, or
+                     the string 'letter' if the letter of the chosen bubble is
+                     in the final, or 'number' if a number representing the
+                     chosen bubble is in the file (1->A 0->J)
+       Qoff        - the character used to represent that a bubble was
+                     left blank
+       PaperID     - if the scanning process generates a unique number for each
+                     sheet scanned the column that this ID number starts in
+       PaperIDlength - number of columns that comprise the unique ID number
+                       for the sheet of paper
+       FirstName   - column that the first name starts in
+       FirstNameLength - number of columns that the first name spans
+       LastName    - column that the last name starts in
+       LastNameLength - number of columns that the last name spans
+ =cut
  sub get_scantron_config {
      my ($which) = @_;
- Line 4661  sub get_scantron_config {
+ Line 4990  sub get_scantron_config {
      return %config;
  }
- #  creates a hash keyed by student id that conains
+ =pod
- #  the corresponding student username:domain.
- # Parameters:
+ =item username_to_idmap
- #   reference to the class list hash. This is a hash
- #   keyed by student name:domain  whose elements are references
+     creates a hash keyed by student id with values of the corresponding
- #   to arrays containng various chunks of information
+     student username:domain.
- #   about the student. (See loncoursedata for more info).
- #
+   Arguments:
- #
+     $classlist - reference to the class list hash. This is a hash
+                  keyed by student name:domain  whose elements are references
+                  to arrays containing various chunks of information
+                  about the student. (See loncoursedata for more info).
+   Returns
+     %idmap - the constructed hash
+ =cut
  sub username_to_idmap {
      my ($classlist)= @_;
      my %idmap;
- Line 4679  sub username_to_idmap {
+ Line 5018  sub username_to_idmap {
      }
      return %idmap;
  }
- #
- # Make a correction in a scantron line?
+ =pod
- # Parameters:
- #   scantron_config    - Format of the scantron file
+ =item scantron_fixup_scanline
- #   scan_data          - Hash of line by line info about the scan(?).
- #   line               - Scantron line to edit?
+    Process a requested correction to a scanline.
- #   whichline
- #   field
+   Arguments:
- #   args               - Keyword/value hash of additional parameters.
+     $scantron_config   - hash from &get_scantron_config()
- #
+     $scan_data         - hash of correction information
+                           (see &scantron_getfile())
+     $line              - existing scanline
+     $whichline         - line number of the passed in scanline
+     $field             - type of change to process
+                          (either
+                           'ID'     -> correct the student ID number
+                           'CODE'   -> correct the CODE
+                           'answer' -> fixup the submitted answers)
+    $args               - hash of additional info,
+                           - 'ID'
+                                'newid' -> studentID to use in replacement
+                                           of existing one
+                           - 'CODE'
+                                'CODE_ignore_dup' - set to true if duplicates
+                                                    should be ignored.
+ 	                       'CODE' - is new code or 'use_unfound'
+                                         if the existing unfound code should
+                                         be used as is
+                           - 'answer'
+                                'response' - new answer or 'none' if blank
+                                'question' - the bubble line to change
+   Returns:
+     $line - the modified scanline
+   Side effects:
+     $scan_data - may be updated
+ =cut
  sub scantron_fixup_scanline {
      my ($scantron_config,$scan_data,$line,$whichline,$field,$args)=@_;
-     #
-     # ID field, args->{'newid'} is the new value of the ID field.
-     #
      if ($field eq 'ID') {
  	if (length($args->{'newid'}) > $$scantron_config{'IDlength'}) {
  	    return ($line,1,'New value too large');
- Line 4709  sub scantron_fixup_scanline {
+ Line 5077  sub scantron_fixup_scanline {
  	    &scan_data($scan_data,"$whichline.user",
  		       $args->{'username'}.':'.$args->{'domain'});
  	}
- 	# CODE Field,
- 	#   args->{CODE_ignore_dup} is true if duplicates should be ignored.
- 	#   args->{CODE} is new code or 'use_unfound' if an unfound code should
- 	#                be used as is?
- 	#
      } elsif ($field eq 'CODE') {
  	if ($args->{'CODE_ignore_dup'}) {
  	    &scan_data($scan_data,"$whichline.CODE_ignore_dup",'1');
- Line 4729  sub scantron_fixup_scanline {
+ Line 5092  sub scantron_fixup_scanline {
  	    substr($line,$$scantron_config{'CODEstart'}-1,
  		   $$scantron_config{'CODElength'})=$args->{'CODE'};
  	}
- 	#
- 	# Edit the answer field.
- 	#     args->{'response'} - new answer or 'none' if blank.
- 	#     args->{'question'} - the question (number?)?.
- 	#
      } elsif ($field eq 'answer') {
  	my $length=$scantron_config->{'Qlength'};
  	my $off=$scantron_config->{'Qoff'};
- Line 4760  sub scantron_fixup_scanline {
+ Line 5118  sub scantron_fixup_scanline {
      }
      return $line;
  }
- # Edit or look up  an item in the scan_data hash.
- # Parameters:
+ =pod
- #   scan_data   - The hash.
- #   key         - shorthand of the key to edit (actual key is
+ =item scan_data
- #                 scatronfilename_key.
- #   data        - New value of the hash entry.
+     Edit or look up  an item in the scan_data hash.
- #   delete      - If defined, the entry is removed from the table.
- # Returns:
+   Arguments:
- #   The new value of the hash table field (undefined if deleted).
+     $scan_data  - The hash (see scantron_getfile)
- #
+     $key        - shorthand of the key to edit (actual key is
+                   scantronfilename_key).
+     $data        - New value of the hash entry.
+     $delete      - If true, the entry is removed from the hash.
+   Returns:
+     The new value of the hash table field (undefined if deleted).
+ =cut
  sub scan_data {
      my ($scan_data,$key,$value,$delete)=@_;
      my $filename=$env{'form.scantron_selectfile'};
- Line 4779  sub scan_data {
+ Line 5147  sub scan_data {
      if ($delete) { delete($scan_data->{$filename.'_'.$key}); }
      return $scan_data->{$filename.'_'.$key};
  }
- #
- #  Decode a line on the uploaded scantron file:
+ =pod
- #  Arguments:
- #    line             - The text of the  scantron file line to process
+ =item scantron_parse_scanline
- #    whichline        - Line number(?)
- #    scantron_config  - Hash describing the format of the scantron lines.
+   Decodes a scanline from the selected scantron file
- #    scan_data        - Hash being built up of the entire scantron file.
- #    justHeader       - True if should not process question answers but only
+  Arguments:
- #                       the stuff to the left of the answers.
+     line             - The text of the scantron file line to process
- # Returns:
+     whichline        - Line number
- #   Hash of data from the line?
+     scantron_config  - Hash describing the format of the scantron lines.
- #
+     scan_data        - Hash of extra information about the scanline
+                        (see scantron_getfile for more information)
+     just_header      - True if should not process question answers but only
+                        the stuff to the left of the answers.
+  Returns:
+    Hash containing the result of parsing the scanline
+    Keys are all proceeded by the string 'scantron.'
+        CODE    - the CODE in use for this scanline
+        useCODE - 1 if the CODE is invalid but it usage has been forced
+                  by the operator
+        CODE_ignore_dup - 1 if the CODE is a duplicated use when unique
+                             CODEs were selected, but the usage has been
+                             forced by the operator
+        ID  - student ID
+        PaperID - if used, the ID number printed on the sheet when the
+                  paper was scanned
+        FirstName - first name from the sheet
+        LastName  - last name from the sheet
+      if just_header was not true these key may also exist
+        missingerror - a list of bubble ranges that are considered to be answers
+                       to a single question that don't have any bubbles filled in.
+                       Of the form questionnumber:firstbubblenumber:count.
+        doubleerror  - a list of bubble ranges that are considered to be answers
+                       to a single question that have more than one bubble filled in.
+                       Of the form questionnumber::firstbubblenumber:count
+                 In the above, count is the number of bubble responses in the
+                 input line needed to represent the possible answers to the question.
+                 e.g. a radioresponse with 15 choices in an answer sheet with 10 choices
+                 per line would have count = 2.
+        maxquest     - the number of the last bubble line that was parsed
+        (<number> starts at 1)
+        <number>.answer - zero or more letters representing the selected
+                          letters from the scanline for the bubble line
+                          <number>.
+                          if blank there was either no bubble or there where
+                          multiple bubbles, (consult the keys missingerror and
+                          doubleerror if this is an error condition)
+ =cut
  sub scantron_parse_scanline {
-     my ($line,$whichline,$scantron_config,$scan_data,$justHeader)=@_;
+     my ($line,$whichline,$scantron_config,$scan_data,$just_header)=@_;
      my %record;
      my $questions=substr($line,$$scantron_config{'Qstart'}-1);  # Answers
      my $data=substr($line,0,$$scantron_config{'Qstart'}-1);     # earlier stuff
- Line 4825  sub scantron_parse_scanline {
+ Line 5239  sub scantron_parse_scanline {
      $record{'scantron.LastName'}=
  	substr($data,$$scantron_config{'LastName'}-1,
  	       $$scantron_config{'LastNamelength'});
-     if ($justHeader) { return \%record; }
+     if ($just_header) { return \%record; }
      my @alphabet=('A'..'Z');
      my $questnum=0;
+     my $ansnum  =1;		# Multiple 'answer lines'/question.
      while ($questions) {
+ 	my $answers_needed = $bubble_lines_per_response{$questnum};
+ 	my $answer_length  = $$scantron_config{'Qlength'} * $answers_needed;
  	$questnum++;
- 	my $currentquest=substr($questions,0,$$scantron_config{'Qlength'});
+ 	my $currentquest = substr($questions,0,$answer_length);
- 	substr($questions,0,$$scantron_config{'Qlength'})='';
+ 	$questions       = substr($questions,0,$answer_length)='';
- 	if (length($currentquest) < $$scantron_config{'Qlength'}) { next; }
+ 	if (length($currentquest) < $answer_length) { next; }
+ 	# Qon letter implies for each slot in currentquest we have:
+ 	#    ? or * for doubles a letter in A-Z for a bubble and
+         #    about anything else (esp. a value of Qoff for missing
+ 	#    bubbles.
  	if ($$scantron_config{'Qon'} eq 'letter') {
- 	    if ($currentquest eq '?'
- 		|| $currentquest eq '*') {
+ 	    if ($currentquest =~ /\?/
+ 		|| $currentquest =~ /\*/
+ 		|| (&occurence_count($currentquest, "[A-Z]") > 1)) {
  		push(@{$record{'scantron.doubleerror'}},$questnum);
- 		$record{"scantron.$questnum.answer"}='';
+ 		for (my $ans = 0; $ans < $answers_needed; $ans++) {
+ 		    $record{"scantron.$ansnum.answer"}='';
+ 		    $ansnum++;
+ 		}
  	    } elsif (!defined($currentquest)
- 		     || $currentquest eq $$scantron_config{'Qoff'}
+ 		     || (&occurence_count($currentquest, $$scantron_config{'Qoff'}) == length($currentquest))
- 		     || $currentquest !~ /^[A-Z]$/) {
+ 		     || (&occurence_count($currentquest, "[A-Z]") == 0)) {
- 		$record{"scantron.$questnum.answer"}='';
+ 		for (my $ans = 0; $ans < $answers_needed; $ans++ ) {
+ 		    $record{"scantron.$ansnum.answer"}='';
+ 		    $ansnum++;
+ 		}
  		if (!&scan_data($scan_data,"$whichline.no_bubble.$questnum")) {
  		    push(@{$record{"scantron.missingerror"}},$questnum);
+ 		    $ansnum += $answers_needed;
  		}
  	    } else {
- 		$record{"scantron.$questnum.answer"}=$currentquest;
+ 		for (my $ans = 0; $ans < $answers_needed; $ans++) {
+ 		    $record{"scantron.$ansnum.answer"} = substr($currentquest, $ans, 1);
+ 		    $ansnum++;
+ 		}
  	    }
+ 	# Qon 'number' implies each slot gives a digit that indexes the
+ 	#    the bubbles filled or Qoff or a non number for unbubbled lines.
+         #    and *? for double bubbles on a line.
+ 	#    these answers are also stored as letters.
  	} elsif ($$scantron_config{'Qon'} eq 'number') {
- 	    if ($currentquest eq '?'
+ 	    if ($currentquest =~ /\?/
- 		|| $currentquest eq '*') {
+ 		|| $currentquest =~ /\*/
+ 		|| (&occurence_count($currentquest, '\d') > 1)) {
  		push(@{$record{'scantron.doubleerror'}},$questnum);
- 		$record{"scantron.$questnum.answer"}='';
+ 		for (my $ans = 0; $ans < $answers_needed; $ans++) {
+ 		    $record{"scantron.$ansnum.answer"}='';
+ 		    $ansnum++;
+ 		}
  	    } elsif (!defined($currentquest)
- 		     || $currentquest eq $$scantron_config{'Qoff'}
+ 		     || (&occurence_count($currentquest,$$scantron_config{'Qoff'}) == length($currentquest))
- 		     || $currentquest !~ /^\d$/) {
+ 		     || (&occurence_count($currentquest, '\d') == 0)) {
- 		$record{"scantron.$questnum.answer"}='';
+ 		for (my $ans = 0; $ans < $answers_needed; $ans++ ) {
+ 		    $record{"scantron.$ansnum.answer"}='';
+ 		    $ansnum++;
+ 		}
  		if (!&scan_data($scan_data,"$whichline.no_bubble.$questnum")) {
  		    push(@{$record{"scantron.missingerror"}},$questnum);
+ 		    $ansnum += $answers_needed;
  		}
  	    } else {
- 		# wrap zero back to J
+ 		$currentquest = &digits_to_letters($currentquest);
- 		if ($currentquest eq '0') {
+ 		for (my $ans =0; $ans < $answers_needed; $ans++) {
- 		    $record{"scantron.$questnum.answer"}=
+ 		    $record{"scantron.$ansnum.answer"} = substr($currentquest, $ans, 1);
- 			$alphabet[9];
+ 		    $ansnum++;
- 		} else {
- 		    $record{"scantron.$questnum.answer"}=
- 			$alphabet[$currentquest-1];
  		}
  	    }
  	} else {
+ 	    # Otherwise there's a positional notation;
+ 	    # each bubble line requires Qlength items, and there are filled in
+ 	    # bubbles for each case where there 'Qon' characters.
+ 	    #
  	    my @array=split($$scantron_config{'Qon'},$currentquest,-1);
- 	    if (length($array[0]) eq $$scantron_config{'Qlength'}) {
- 		$record{"scantron.$questnum.answer"}='';
+ 	    # If the split only  giveas us one element.. the full length of the
+ 	    # answser string, no bubbles are filled in:
+ 	    if (length($array[0]) eq $$scantron_config{'Qlength'}*$answers_needed) {
+ 		for (my $ans = 0; $ans < $answers_needed; $ans++ ) {
+ 		    $record{"scantron.$ansnum.answer"}='';
+ 		    $ansnum++;
+ 		}
  		if (!&scan_data($scan_data,"$whichline.no_bubble.$questnum")) {
  		    push(@{$record{"scantron.missingerror"}},$questnum);
  		}
- 	    } else {
+ 	    } elsif (scalar(@array) lt 2) {
- 		$record{"scantron.$questnum.answer"}=
- 		    $alphabet[length($array[0])];
+ 		my $location      = [length($array[0])];
+ 		my $line_num      = $location / $$scantron_config{'Qlength'};
+ 		my $bubble        = $alphabet[$location % $$scantron_config{'Qlength'}];
+ 		for (my $ans = 0; $ans < $answers_needed; $ans++) {
+ 		    if ($ans eq $line_num) {
+ 			$record{"scantron.$ansnum.answer"} = $bubble;
+ 		    } else {
+ 			$record{"scantron.$ansnum.answer"} = ' ';
+ 		    }
+ 		    $ansnum++;
+ 		}
  	    }
- 	    if (scalar(@array) gt 2) {
+ 	    #  If there's more than one instance of a bubble character
+ 	    #  That's a double bubble; with positional notation we can
+ 	    #  record all the bubbles filled in as well as the
+ 	    #  fact this response consists of multiple bubbles.
+ 	    #
+ 	    else {
  		push(@{$record{'scantron.doubleerror'}},$questnum);
+ 		my $first_answer = $ansnum;
+ 		for (my $ans =0; $ans < $answers_needed; $ans++) {
+ 		    $record{"scantron.$ansnum.answer"} = '';
+ 		    $ans++;
+ 		}
  		my @ans=@array;
  		my $i=length($ans[0]);shift(@ans);
  		while ($#ans) {
  		    $i+=length($ans[0])+1;
- 		    $record{"scantron.$questnum.answer"}.=$alphabet[$i];
+ 		    my $line   = $i/$$scantron_config{'Qlength'} + $first_answer;
+ 		    my $bubble = $i%$$scantron_config{'Qlength'};
+ 		    $record{"scantron.$line.answer"}.=$alphabet[$bubble];
  		    shift(@ans);
  		}
  	    }
- Line 4898  sub scantron_parse_scanline {
+ Line 5395  sub scantron_parse_scanline {
      return \%record;
  }
+ =pod
+ =item scantron_add_delay
+    Adds an error message that occurred during the grading phase to a
+    queue of messages to be shown after grading pass is complete
+  Arguments:
+    $delayqueue  - arrary ref of hash ref of error messages
+    $scanline    - the scanline that caused the error
+    $errormesage - the error message
+    $errorcode   - a numeric code for the error
+  Side Effects:
+    updates the $delayqueue to have a new hash ref of the error
+ =cut
  sub scantron_add_delay {
      my ($delayqueue,$scanline,$errormessage,$errorcode)=@_;
      push(@$delayqueue,
- Line 4906  sub scantron_add_delay {
+ Line 5421  sub scantron_add_delay {
  	 );
  }
+ =pod
+ =item scantron_find_student
+    Finds the username for the current scanline
+   Arguments:
+    $scantron_record - hash result from scantron_parse_scanline
+    $scan_data       - hash of correction information
+                       (see &scantron_getfile() form more information)
+    $idmap           - hash from &username_to_idmap()
+    $line            - number of current scanline
+   Returns:
+    Either 'username:domain' or undef if unknown
+ =cut
  sub scantron_find_student {
      my ($scantron_record,$scan_data,$idmap,$line)=@_;
      my $scanID=$$scantron_record{'scantron.ID'};
- Line 4920  sub scantron_find_student {
+ Line 5453  sub scantron_find_student {
      return undef;
  }
+ =pod
+ =item scantron_filter
+    Filter sub for lonnavmaps, filters out hidden resources if ignore
+    hidden resources was selected
+ =cut
  sub scantron_filter {
      my ($curres)=@_;
- Line 4936  sub scantron_filter {
+ Line 5478  sub scantron_filter {
      return 0;
  }
+ =pod
+ =item scantron_process_corrections
+    Gets correction information out of submitted form data and corrects
+    the scanline
+ =cut
  sub scantron_process_corrections {
      my ($r) = @_;
      my %scantron_config=&get_scantron_config($env{'form.scantron_format'});
- Line 4993  sub scantron_process_corrections {
+ Line 5544  sub scantron_process_corrections {
      }
  }
+ =pod
+ =item reset_skipping_status
+    Forgets the current set of remember skipped scanlines (and thus
+    reverts back to considering all lines in the
+    scantron_skipped_<filename> file)
+ =cut
  sub reset_skipping_status {
      my ($scanlines,$scan_data)=&scantron_getfile();
      &scan_data($scan_data,'remember_skipping',undef,1);
      &scantron_putfile(undef,$scan_data);
  }
+ =pod
+ =item start_skipping
+    Marks a scanline to be skipped.
+ =cut
  sub start_skipping {
      my ($scan_data,$i)=@_;
      my %remembered=split(':',&scan_data($scan_data,'remember_skipping'));
- Line 5010  sub start_skipping {
+ Line 5579  sub start_skipping {
      &scan_data($scan_data,'remember_skipping',join(':',%remembered));
  }
+ =pod
+ =item should_be_skipped
+    Checks whether a scanline should be skipped.
+ =cut
  sub should_be_skipped {
      my ($scanlines,$scan_data,$i)=@_;
      if ($env{'form.scantron_options_redo'} !~ /^redo_/) {
- Line 5025  sub should_be_skipped {
+ Line 5602  sub should_be_skipped {
      return 1;
  }
+ =pod
+ =item remember_current_skipped
+    Discovers what scanlines are in the scantron_skipped_<filename>
+    file and remembers them into scan_data for later use.
+ =cut
  sub remember_current_skipped {
      my ($scanlines,$scan_data)=&scantron_getfile();
      my %to_remember;
- Line 5038  sub remember_current_skipped {
+ Line 5624  sub remember_current_skipped {
      &scantron_putfile(undef,$scan_data);
  }
+ =pod
+ =item check_for_error
+     Checks if there was an error when attempting to remove a specific
+     scantron_.. bubble sheet data file. Prints out an error if
+     something went wrong.
+ =cut
  sub check_for_error {
      my ($r,$result)=@_;
      if ($result ne 'ok' && $result ne 'not_found' ) {
- Line 5045  sub check_for_error {
+ Line 5641  sub check_for_error {
      }
  }
+ =pod
+ =item scantron_warning_screen
+    Interstitial screen to make sure the operator has selected the
+    correct options before we start the validation phase.
+ =cut
  sub scantron_warning_screen {
      my ($button_text)=@_;
      my $title=&Apache::lonnet::gettitle($env{'form.selectpage'});
- Line 5077  $CODElist
+ Line 5682  $CODElist
  STUFF
  }
+ =pod
+ =item scantron_do_warning
+    Check if the operator has picked something for all required
+    fields. Error out if something is missing.
+ =cut
  sub scantron_do_warning {
      my ($r)=@_;
      my ($symb)=&get_symb($r);
- Line 5108  STUFF
+ Line 5722  STUFF
      return '';
  }
+ =pod
+ =item scantron_form_start
+     html hidden input for remembering all selected grading options
+ =cut
  sub scantron_form_start {
      my ($max_bubble)=@_;
      my $result= <<SCANTRONFORM;
- Line 5122  sub scantron_form_start {
+ Line 5744  sub scantron_form_start {
    <input type="hidden" name="scantron_options_ignore" value="$env{'form.scantron_options_ignore'}" />
    <input type="hidden" name="scantron_options_hidden" value="$env{'form.scantron_options_hidden'}" />
  SCANTRONFORM
+   my $line = 0;
+     while (defined($env{"form.scantron.bubblelines.$line"})) {
+ 	&Apache::lonnet::logthis("Saving chunk for $line");
+        my $chunk =
+ 	   '<input type="hidden" name="scantron.bubblelines.'.$line.'" value="'.$env{"form.scantron.bubblelines.$line"}.'" />'."\n";
+        $chunk .=
+ 	   '<input type="hidden" name="scantron.first_bubble_line.'.$line.'" value="'.$env{"form.scantron.first_bubble_line.$line"}.'" />'."\n";
+        $result .= $chunk;
+        $line++;
+    }
      return $result;
  }
+ =pod
+ =item scantron_validate_file
+     Dispatch routine for doing validation of a bubble sheet data file.
+     Also processes any necessary information resets that need to
+     occur before validation begins (ignore previous corrections,
+     restarting the skipped records processing)
+ =cut
  sub scantron_validate_file {
      my ($r) = @_;
      my ($symb)=&get_symb($r);
- Line 5132  sub scantron_validate_file {
+ Line 5777  sub scantron_validate_file {
      my $default_form_data=&defaultFormData($symb);
      # do the detection of only doing skipped records first befroe we delete
-     # them  when doing the corrections reset
+     # them when doing the corrections reset
      if ($env{'form.scantron_options_redo'} ne 'redo_skipped_ready') {
  	&reset_skipping_status();
      }
- Line 5151  sub scantron_validate_file {
+ Line 5796  sub scantron_validate_file {
      if ($env{'form.scantron_corrections'}) {
  	&scantron_process_corrections($r);
      }
-     $r->print("<p>Gathering neccessary info.</p>");$r->rflush();
+     $r->print("<p>Gathering necessary info.</p>");$r->rflush();
      #get the student pick code ready
      $r->print(&Apache::loncommon::studentbrowser_javascript());
      my $max_bubble=&scantron_get_maxbubble();
- Line 5168  sub scantron_validate_file {
+ Line 5813  sub scantron_validate_file {
      }
      my $currentphase=$env{'form.validatepass'};
+     &Apache::lonnet::logthis("Phase: $currentphase");
      my $stop=0;
      while (!$stop && $currentphase < scalar(@validate_phases)) {
  	$r->print("<p> Validating ".$validate_phases[$currentphase]."</p>");
- Line 5208  STUFF
+ Line 5855  STUFF
      return '';
  }
+ =pod
+ =item scantron_remove_file
+    Removes the requested bubble sheet data file, makes sure that
+    scantron_original_<filename> is never removed
+ =cut
  sub scantron_remove_file {
      my ($which)=@_;
      my $cname=$env{'course.'.$env{'request.course.id'}.'.num'};
- Line 5222  sub scantron_remove_file {
+ Line 5880  sub scantron_remove_file {
      return &Apache::lonnet::removeuserfile($cname,$cdom,$file);
  }
+ =pod
+ =item scantron_remove_scan_data
+    Removes all scan_data correction for the requested bubble sheet
+    data file.  (In the case that both the are doing skipped records we need
+    to remember the old skipped lines for the time being so that element
+    persists for a while.)
+ =cut
  sub scantron_remove_scan_data {
      my $cname=$env{'course.'.$env{'request.course.id'}.'.num'};
      my $cdom=$env{'course.'.$env{'request.course.id'}.'.domain'};
- Line 5244  sub scantron_remove_scan_data {
+ Line 5914  sub scantron_remove_scan_data {
      return $result;
  }
+ =pod
+ =item scantron_getfile
+     Fetches the requested bubble sheet data file (all 3 versions), and
+     the scan_data hash
+   Arguments:
+     None
+   Returns:
+hash references
+      - first one has
+          orig      -
+          corrected -
+          skipped   -  each of which points to an array ref of the specified
+                       file broken up into individual lines
+          count     - number of scanlines
+      - second is the scan_data hash possible keys are
+        ($number refers to scanline numbered $number and thus the key affects
+         only that scanline
+         $bubline refers to the specific bubble line element and the aspects
+         refers to that specific bubble line element)
+        $number.user - username:domain to use
+        $number.CODE_ignore_dup
+                     - ignore the duplicate CODE error
+        $number.useCODE
+                     - use the CODE in the scanline as is
+        $number.no_bubble.$bubline
+                     - it is valid that there is no bubbled in bubble
+                       at $number $bubline
+        remember_skipping
+                     - a frozen hash containing keys of $number and values
+                       of either
+- we are on a 'do skipped records pass' and plan
+                             on processing this line
+- we are on a 'do skipped records pass' and this
+                             scanline has been marked to skip yet again
+ =cut
  sub scantron_getfile {
      #FIXME really would prefer a scantron directory
      my $cname=$env{'course.'.$env{'request.course.id'}.'.num'};
- Line 5276  sub scantron_getfile {
+ Line 5991  sub scantron_getfile {
      return (\%scanlines,\%scan_data);
  }
+ =pod
+ =item lonnet_putfile
+    Wrapper routine to call &Apache::lonnet::finishuserfileupload
+  Arguments:
+    $contents - data to store
+    $filename - filename to store $contents into
+  Returns:
+    result value from &Apache::lonnet::finishuserfileupload
+ =cut
  sub lonnet_putfile {
      my ($contents,$filename)=@_;
      my $docuname=$env{'course.'.$env{'request.course.id'}.'.num'};
- Line 5285  sub lonnet_putfile {
+ Line 6015  sub lonnet_putfile {
  }
+ =pod
+ =item scantron_putfile
+     Stores the current version of the bubble sheet data files, and the
+     scan_data hash. (Does not modify the original version only the
+     corrected and skipped versions.
+  Arguments:
+     $scanlines - hash ref that looks like the first return value from
+                  &scantron_getfile()
+     $scan_data - hash ref that looks like the second return value from
+                  &scantron_getfile()
+ =cut
  sub scantron_putfile {
      my ($scanlines,$scan_data) = @_;
      #FIXME really would prefer a scantron directory
- Line 5305  sub scantron_putfile {
+ Line 6051  sub scantron_putfile {
      &Apache::lonnet::put('nohist_scantrondata',$scan_data,$cdom,$cname);
  }
+ =pod
+ =item scantron_get_line
+    Returns the correct version of the scanline
+  Arguments:
+     $scanlines - hash ref that looks like the first return value from
+                  &scantron_getfile()
+     $scan_data - hash ref that looks like the second return value from
+                  &scantron_getfile()
+     $i         - number of the requested line (starts at 0)
+  Returns:
+    A scanline, (either the original or the corrected one if it
+    exists), or undef if the requested scanline should be
+    skipped. (Either because it's an skipped scanline, or it's an
+    unskipped scanline and we are not doing a 'do skipped scanlines'
+    pass.
+ =cut
  sub scantron_get_line {
      my ($scanlines,$scan_data,$i)=@_;
      if (&should_be_skipped($scanlines,$scan_data,$i)) { return undef; }
- Line 5313  sub scantron_get_line {
+ Line 6081  sub scantron_get_line {
      return $scanlines->{'orig'}[$i];
  }
+ =pod
+ =item scantron_todo_count
+     Counts the number of scanlines that need processing.
+  Arguments:
+     $scanlines - hash ref that looks like the first return value from
+                  &scantron_getfile()
+     $scan_data - hash ref that looks like the second return value from
+                  &scantron_getfile()
+  Returns:
+     $count - number of scanlines to process
+ =cut
  sub get_todo_count {
      my ($scanlines,$scan_data)=@_;
      my $count=0;
- Line 5324  sub get_todo_count {
+ Line 6109  sub get_todo_count {
      return $count;
  }
+ =pod
+ =item scantron_put_line
+     Updates the 'corrected' or 'skipped' versions of the bubble sheet
+     data file.
+  Arguments:
+     $scanlines - hash ref that looks like the first return value from
+                  &scantron_getfile()
+     $scan_data - hash ref that looks like the second return value from
+                  &scantron_getfile()
+     $i         - line number to update
+     $newline   - contents of the updated scanline
+     $skip      - if true make the line for skipping and update the
+                  'skipped' file
+ =cut
  sub scantron_put_line {
      my ($scanlines,$scan_data,$i,$newline,$skip)=@_;
      if ($skip) {
- Line 5334  sub scantron_put_line {
+ Line 6138  sub scantron_put_line {
      $scanlines->{'corrected'}[$i]=$newline;
  }
+ =pod
+ =item scantron_clear_skip
+    Remove a line from the 'skipped' file
+  Arguments:
+     $scanlines - hash ref that looks like the first return value from
+                  &scantron_getfile()
+     $scan_data - hash ref that looks like the second return value from
+                  &scantron_getfile()
+     $i         - line number to update
+ =cut
  sub scantron_clear_skip {
      my ($scanlines,$scan_data,$i)=@_;
      if (exists($scanlines->{'skipped'}[$i])) {
- Line 5343  sub scantron_clear_skip {
+ Line 6162  sub scantron_clear_skip {
      return 0;
  }
+ =pod
+ =item scantron_filter_not_exam
+    Filter routine used by &Apache::lonnavmaps::retrieveResources(), to
+    filter out resources that are not marked as 'exam' mode
+ =cut
  sub scantron_filter_not_exam {
      my ($curres)=@_;
- Line 5359  sub scantron_filter_not_exam {
+ Line 6187  sub scantron_filter_not_exam {
      return 0;
  }
+ =pod
+ =item scantron_validate_sequence
+     Validates the selected sequence, checking for resource that are
+     not set to exam mode.
+ =cut
  sub scantron_validate_sequence {
      my ($r,$currentphase) = @_;
- Line 5382  sub scantron_validate_sequence {
+ Line 6219  sub scantron_validate_sequence {
      return (0,$currentphase+1);
  }
+ =pod
+ =item scantron_validate_ID
+    Validates all scanlines in the selected file to not have any
+    invalid or underspecified student IDs
+ =cut
  sub scantron_validate_ID {
      my ($r,$currentphase) = @_;
- Line 5392  sub scantron_validate_ID {
+ Line 6238  sub scantron_validate_ID {
      #get scantron line setup
      my %scantron_config=&get_scantron_config($env{'form.scantron_format'});
      my ($scanlines,$scan_data)=&scantron_getfile();
+     &scantron_get_maxbubble();	# parse needs the bubble_lines.. array.
      my %found=('ids'=>{},'usernames'=>{});
      for (my $i=0;$i<=$scanlines->{'count'};$i++) {
- Line 5444  sub scantron_validate_ID {
+ Line 6292  sub scantron_validate_ID {
      return (0,$currentphase+1);
  }
+ =pod
+ =item scantron_get_correction
+    Builds the interface screen to interact with the operator to fix a
+    specific error condition in a specific scanline
+  Arguments:
+     $r           - Apache request object
+     $i           - number of the current scanline
+     $scan_record - hash ref as returned from &scantron_parse_scanline()
+     $scan_config - hash ref as returned from &get_scantron_config()
+     $line        - full contents of the current scanline
+     $error       - error condition, valid values are
+                    'incorrectCODE', 'duplicateCODE',
+                    'doublebubble', 'missingbubble',
+                    'duplicateID', 'incorrectID'
+     $arg         - extra information needed
+        For errors:
+          - duplicateID   - paper number that this studentID was seen before on
+          - duplicateCODE - array ref of the paper numbers this CODE was
+                            seen on before
+          - incorrectCODE - current incorrect CODE
+          - doublebubble  - array ref of the bubble lines that have double
+                            bubble errors
+          - missingbubble - array ref of the bubble lines that have missing
+                            bubble errors
+ =cut
  sub scantron_get_correction {
      my ($r,$i,$scan_record,$scan_config,$line,$error,$arg)=@_;
- Line 5546  ENDSCRIPT
+ Line 6424  ENDSCRIPT
  	$r->print($message);
  	$r->print("<p>Please indicate which bubble should be used for grading</p>");
  	foreach my $question (@{$arg}) {
- 	    my $selected=$$scan_record{"scantron.$question.answer"};
+ 	    my $selected  = &get_response_bubbles($scan_record, $question);
  	    &scantron_bubble_selector($r,$scan_config,$question,
  				      split('',$selected));
  	}
- Line 5558  ENDSCRIPT
+ Line 6437  ENDSCRIPT
  	$r->print('<input type="hidden" name="scantron_questions" value="'.
  		  join(',',@{$arg}).'" />');
  	foreach my $question (@{$arg}) {
- 	    my $selected=$$scan_record{"scantron.$question.answer"};
+ 	    my $selected = &get_response_bubbles($scan_record, $question);
  	    &scantron_bubble_selector($r,$scan_config,$question);
  	}
      } else {
- Line 5567  ENDSCRIPT
+ Line 6446  ENDSCRIPT
      $r->print("\n</li></ul>");
  }
- #
- #  Ask the grader to select the actual bubble
+ =pod
- #
- # Arguments:
+ =item scantron_bubble_selector
- #    r           - Apache request.
- #    scan_config - Hash of the scantron format selected.
+    Generates the html radiobuttons to correct a single bubble line
- #    quest       - Question being evaluated
+    possibly showing the existing the selected bubbles if known
- #    selected    - array of selected bubbles
- #    lines       - if present, number of bubble lines in questions.
+  Arguments:
+     $r           - Apache request object
+     $scan_config - hash from &get_scantron_config()
+     $quest       - number of the bubble line to make a corrector for
+     $selected    - array of letters of previously selected bubbles
+ =cut
  sub scantron_bubble_selector {
-     my ($r,$scan_config,$quest,@selected, $lines)=@_;
+     my ($r,$scan_config,$quest,@selected)=@_;
      my $max=$$scan_config{'Qlength'};
      my $scmode=$$scan_config{'Qon'};
      if ($scmode eq 'number' || $scmode eq 'letter') { $max=10; }
+     my $response = $quest-1;
+     my $lines = $bubble_lines_per_response{$response};
+     &Apache::lonnet::logthis("Question $quest, lines: $lines");
-     if (!defined($lines)) {
- 	$lines = 1;
-     }
      my $total_lines = $lines*2;
      my @alphabet=('A'..'Z');
      $r->print("<table border='1'><tr><td rowspan='".$total_lines."'>$quest</td>");
- Line 5637  sub scantron_bubble_selector {
+ Line 6525  sub scantron_bubble_selector {
      $r->print('</table>');
  }
+ =pod
+ =item num_matches
+    Counts the number of characters that are the same between the two arguments.
+  Arguments:
+    $orig - CODE from the scanline
+    $code - CODE to match against
+  Returns:
+    $count - integer count of the number of same characters between the
+             two arguments
+ =cut
  sub num_matches {
      my ($orig,$code) = @_;
      my @code=split(//,$code);
- Line 5648  sub num_matches {
+ Line 6552  sub num_matches {
      return $same;
  }
+ =pod
+ =item scantron_get_closely_matching_CODEs
+    Cycles through all CODEs and finds the set that has the greatest
+    number of same characters as the provided CODE
+  Arguments:
+    $allcodes - hash ref returned by &get_codes()
+    $CODE     - CODE from the current scanline
+  Returns:
+element list
+     - first elements is number of how closely matching the best fit is
+       (5 means best set has 5 matching characters)
+     - second element is an arrary ref containing the set of valid CODEs
+       that best fit the passed in CODE
+ =cut
  sub scantron_get_closely_matching_CODEs {
      my ($allcodes,$CODE)=@_;
      my @CODEs;
- Line 5658  sub scantron_get_closely_matching_CODEs
+ Line 6582  sub scantron_get_closely_matching_CODEs
      return ($#CODEs,$CODEs[-1]);
  }
+ =pod
+ =item get_codes
+    Builds a hash which has keys of all of the valid CODEs from the selected
+    set of remembered CODEs.
+  Arguments:
+   $old_name - name of the set of remembered CODEs
+   $cdom     - domain of the course
+   $cnum     - internal course name
+  Returns:
+   %allcodes - keys are the valid CODEs, values are all 1
+ =cut
  sub get_codes {
      my ($old_name, $cdom, $cnum) = @_;
      if (!$old_name) {
- Line 5680  sub get_codes {
+ Line 6621  sub get_codes {
      return %allcodes;
  }
+ =pod
+ =item scantron_validate_CODE
+    Validates all scanlines in the selected file to not have any
+    invalid or underspecified CODEs and that none of the codes are
+    duplicated if this was requested.
+ =cut
  sub scantron_validate_CODE {
      my ($r,$currentphase) = @_;
      my %scantron_config=&get_scantron_config($env{'form.scantron_format'});
- Line 5697  sub scantron_validate_CODE {
+ Line 6648  sub scantron_validate_CODE {
      my %allcodes=&get_codes();
+     &scantron_get_maxbubble();	# parse needs the lines per response array.
      my ($scanlines,$scan_data)=&scantron_getfile();
      for (my $i=0;$i<=$scanlines->{'count'};$i++) {
  	my $line=&scantron_get_line($scanlines,$scan_data,$i);
- Line 5731  sub scantron_validate_CODE {
+ Line 6684  sub scantron_validate_CODE {
      return (0,$currentphase+1);
  }
+ =pod
+ =item scantron_validate_doublebubble
+    Validates all scanlines in the selected file to not have any
+    bubble lines with multiple bubbles marked.
+ =cut
  sub scantron_validate_doublebubble {
      my ($r,$currentphase) = @_;
      #get student info
- Line 5740  sub scantron_validate_doublebubble {
+ Line 6702  sub scantron_validate_doublebubble {
      #get scantron line setup
      my %scantron_config=&get_scantron_config($env{'form.scantron_format'});
      my ($scanlines,$scan_data)=&scantron_getfile();
+     &scantron_get_maxbubble();	# parse needs the bubble line array.
      for (my $i=0;$i<=$scanlines->{'count'};$i++) {
  	my $line=&scantron_get_line($scanlines,$scan_data,$i);
  	if ($line=~/^[\s\cz]*$/) { next; }
- Line 5754  sub scantron_validate_doublebubble {
+ Line 6719  sub scantron_validate_doublebubble {
      return (0,$currentphase+1);
  }
+ =pod
+ =item scantron_get_maxbubble
+    Returns the maximum number of bubble lines that are expected to
+    occur. Does this by walking the selected sequence rendering the
+    resource and then checking &Apache::lonxml::get_problem_counter()
+    for what the current value of the problem counter is.
+    Caches the results to $env{'form.scantron_maxbubble'},
+    $env{'form.scantron.bubble_lines.n'} and
+    $env{'form.scantron.first_bubble_line.n'}
+    which are the total number of bubble, lines, the number of bubble
+    lines for reponse n and number of the first bubble line for response n.
+ =cut
  sub scantron_get_maxbubble {
+     &Apache::lonnet::logthis("get_max_bubble");
      if (defined($env{'form.scantron_maxbubble'}) &&
  	$env{'form.scantron_maxbubble'}) {
+ 	&Apache::lonnet::logthis("cached");
+ 	&restore_bubble_lines();
  	return $env{'form.scantron_maxbubble'};
      }
+     &Apache::lonnet::logthis("computing");
-     my $navmap=Apache::lonnavmaps::navmap->new();
+     my (undef, undef, $sequence) =
-     my (undef,undef,$sequence)=
  	&Apache::lonnet::decode_symb($env{'form.selectpage'});
+     my $navmap=Apache::lonnavmaps::navmap->new();
      my $map=$navmap->getResourceByUrl($sequence);
      my @resources=$navmap->retrieveResources($map,\&scantron_filter,1,0);
      &Apache::lonxml::clear_problem_counter();
+     my $uname       = $env{'form.student'};
+     my $udom        = $env{'form.userdom'};
+     my $cid         = $env{'request.course.id'};
+     my $total_lines = 0;
+     %bubble_lines_per_response = ();
+     %first_bubble_line         = ();
+     my $response_number = 0;
+     my $bubble_line     = 0;
      foreach my $resource (@resources) {
+ 	my $symb = $resource->symb();
+ 	&Apache::lonxml::clear_bubble_lines_for_part();
  	my $result=&Apache::lonnet::ssi($resource->src(),
- 					('symb' => $resource->symb()));
+ 					('symb' => $resource->symb()),
+ 					('grade_target' => 'analyze'),
+ 					('grade_courseid' => $cid),
+ 					('grade_domain' => $udom),
+ 					('grade_username' => $uname));
+ 	my (undef, $an) =
+ 	    split(/_HASH_REF__/,$result, 2);
+ 	my %analysis = &Apache::lonnet::str2hash($an);
+ 	foreach my $part_id (@{$analysis{'parts'}}) {
+ 	    my ($trash, $part) = split(/\./, $part_id);
+ 	    my $lines = $analysis{"$part_id.bubble_lines"}[0];
+ 	    # TODO - make this a persistent hash not an array.
+ 	    $first_bubble_line{$response_number}           = $bubble_line;
+ 	    $bubble_lines_per_response{$response_number}   = $lines;
+ 	    $response_number++;
+ 	    $bubble_line +=  $lines;
+ 	    $total_lines +=  $lines;
+ 	}
      }
      &Apache::lonnet::delenv('scantron\.');
-     $env{'form.scantron_maxbubble'} =
- 	&Apache::lonxml::get_problem_counter()-1;
+     &save_bubble_lines();
+     $env{'form.scantron_maxbubble'} =
+ 	$total_lines;
      return $env{'form.scantron_maxbubble'};
  }
+ =pod
+ =item scantron_validate_missingbubbles
+    Validates all scanlines in the selected file to not have any
+     answers that don't have bubbles that have not been verified
+     to be bubble free.
+ =cut
  sub scantron_validate_missingbubbles {
      my ($r,$currentphase) = @_;
      #get student info
- Line 5812  sub scantron_validate_missingbubbles {
+ Line 6848  sub scantron_validate_missingbubbles {
      return (0,$currentphase+1);
  }
+ =pod
+ =item scantron_process_students
+    Routine that does the actual grading of the bubble sheet information.
+    The parsed scanline hash is added to %env
+    Then foreach unskipped scanline it does an &Apache::lonnet::ssi()
+    foreach resource , with the form data of
+ 	'submitted'     =>'scantron'
+ 	'grade_target'  =>'grade',
+ 	'grade_username'=> username of student
+ 	'grade_domain'  => domain of student
+ 	'grade_courseid'=> of course
+ 	'grade_symb'    => symb of resource to grade
+     This triggers a grading pass. The problem grading code takes care
+     of converting the bubbled letter information (now in %env) into a
+     valid submission.
+ =cut
  sub scantron_process_students {
      my ($r) = @_;
      my (undef,undef,$sequence)=&Apache::lonnet::decode_symb($env{'form.selectpage'});
- Line 5846  SCANTRONFORM
+ Line 6906  SCANTRONFORM
      my $start=&Time::HiRes::time();
      my $i=-1;
      my ($uname,$udom,$started);
+     &scantron_get_maxbubble();	# Need the bubble lines array to parse.
      while ($i<$scanlines->{'count'}) {
   	($uname,$udom)=('','');
   	$i++;
- Line 5896  SCANTRONFORM
+ Line 6959  SCANTRONFORM
  	    }
  	    my $result=&Apache::lonnet::ssi($resource->src(),%form);
  	    if ($result ne '') {
- 		&Apache::lonnet::logthis("scantron grading error -> $result");
- 		&Apache::lonnet::logthis("scantron grading error info name $uname domain $udom course $env{'request.course.id'} url ".$resource->src());
  	    }
  	    if (&Apache::loncommon::connection_aborted($r)) { last; }
  	}
- Line 5916  SCANTRONFORM
+ Line 6977  SCANTRONFORM
      return '';
  }
+ =pod
+ =item scantron_upload_scantron_data
+     Creates the screen for adding a new bubble sheet data file to a course.
+ =cut
  sub scantron_upload_scantron_data {
      my ($r)=@_;
      $r->print(&Apache::loncommon::coursebrowser_javascript($env{'request.role.domain'}));
- Line 5952  UPLOAD
+ Line 7021  UPLOAD
      return '';
  }
+ =pod
+ =item scantron_upload_scantron_data_save
+    Adds a provided bubble information data file to the course if user
+    has the correct privileges to do so.
+ =cut
  sub scantron_upload_scantron_data_save {
      my($r)=@_;
      my ($symb)=&get_symb($r,1);
- Line 6007  sub scantron_upload_scantron_data_save {
+ Line 7085  sub scantron_upload_scantron_data_save {
      return '';
  }
+ =pod
+ =item valid_file
+    Validates that the requested bubble data file exists in the course.
+ =cut
  sub valid_file {
      my ($requested_file)=@_;
      foreach my $filename (sort(&scantron_filenames())) {
- Line 6015  sub valid_file {
+ Line 7101  sub valid_file {
      return 0;
  }
+ =pod
+ =item scantron_download_scantron_data
+    Shows a list of the three internal files (original, corrected,
+    skipped) for a specific bubble sheet data file that exists in the
+    course.
+ =cut
  sub scantron_download_scantron_data {
      my ($r)=@_;
      my $default_form_data=&defaultFormData(&get_symb($r,1));
- Line 6051  DOWNLOAD
+ Line 7147  DOWNLOAD
      return '';
  }
+ =pod
+ =back
+ =cut
  #-------- end of section for handling grading scantron forms -------
  #
  #-------------------------------------------------------------------
- Line 6081  sub savedState {
+ Line 7183  sub savedState {
      return \%savedState;
  }
- #--- Displays the main menu page -------
+ sub grading_menu {
- sub gradingmenu {
      my ($request) = @_;
      my ($symb)=&get_symb($request);
      if (!$symb) {return '';}
      my $probTitle = &Apache::lonnet::gettitle($symb);
+     my ($table,undef,$hdgrade) = &showResourceInfo($symb,$probTitle);
+     #
+     # Define menu data
+     $env{'form.probTitle'} = &Apache::lonnet::gettitle($symb);
+     my ($table) = &showResourceInfo($symb,$env{'form.probTitle'});
+     $request->print($table);
+     my %fields = ('symb'=>&Apache::lonenc::check_encrypt($symb),
+                   'handgrade'=>$hdgrade,
+                   'probTitle'=>$probTitle,
+                   'command'=>'submit_options',
+                   'saveState'=>"",
+                   'gradingMenu'=>1,
+                   'showgrading'=>"yes");
+     my $url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
+     my @menu = ({ url => $url,
+                      name => &mt('Manual Grading/View Submissions'),
+                      short_description =>
+     &mt('Start the process of hand grading submissions.'),
+                  });
+     $fields{'command'} = 'csvform';
+     $url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
+     push (@menu, { url => $url,
+                    name => &mt('Upload Scores'),
+                    short_description =>
+             &mt('Specify a file containing the class scores for current resource.')});
+     $fields{'command'} = 'processclicker';
+     $url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
+     push (@menu, { url => $url,
+                    name => &mt('Process Clicker'),
+                    short_description =>
+             &mt('Specify a file containing the clicker information for this resource.')});
+     $fields{'command'} = 'scantron_selectphase';
+     $url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
+     push (@menu, { url => $url,
+                    name => &mt('Grade Scantron Forms'),
+                    short_description =>
+             &mt('')});
+     $fields{'command'} = 'verify';
+     $url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
+     push (@menu, { url => "",
+                    jscript => ' onClick="javascript:checkChoice2(document.forms.gradingMenu,\'5\',\'verify\')" ',
+                    name => &mt('Verify Receipt'),
+                    short_description =>
+             &mt('')});
+     $fields{'command'} = 'manage';
+     $url = &Apache::lonhtmlcommon::build_url('/adm/helper/resettimes.helper',\%fields);
+     push (@menu, { url => $url,
+                    name => &mt('Manage Access Times'),
+                    short_description =>
+             &mt('')});
+     $fields{'command'} = 'view';
+     $url = &Apache::lonhtmlcommon::build_url('/adm/pickcode',\%fields);
+     push (@menu, { url => $url,
+                    name => &mt('View Saved CODEs'),
+                    short_description =>
+             &mt('')});
+     #
+     # Create the menu
+     my $Str;
+     # $Str .= '<h2>'.&mt('Please select a grading task').'</h2>';
+     $Str .= '<form method="post" action="" name="gradingMenu">';
+     $Str .= '<input type="hidden" name="command" value="" />'.
+     	'<input type="hidden" name="symb"        value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
+ 	'<input type="hidden" name="handgrade"   value="'.$hdgrade.'" />'."\n".
+ 	'<input type="hidden" name="probTitle"   value="'.$probTitle.'" ue="" />'."\n".
+ 	'<input type="hidden" name="saveState"   value="" />'."\n".
+ 	'<input type="hidden" name="gradingMenu" value="1" />'."\n".
+ 	'<input type="hidden" name="showgrading" value="yes" />'."\n";
+     foreach my $menudata (@menu) {
+         if ($menudata->{'name'} ne &mt('Verify Receipt')) {
+             $Str .='    <h3><a '.
+                 $menudata->{'jscript'}.
+                 ' href="'.
+                 $menudata->{'url'}.'" >'.
+                 $menudata->{'name'}."</a></h3>\n";
+         } else {
+             $Str .='    <h3><a '.
+                 $menudata->{'jscript'}.
+                 ' href="javascript:checkChoice2(document.forms.gradingMenu,\'5\',\'verify\')" >'.
+                 $menudata->{'name'}."</a></h3>\n";
+             $Str .= ('&nbsp;'x8).
+                     ' receipt: '.&Apache::lonnet::recprefix($env{'request.course.id'}).
+                     '-<input type="text" name="receipt" size="4" onChange="javascript:checkReceiptNo(this.form,\'OK\')" />';
+         }
+         $Str .= '    '.('&nbsp;'x8).$menudata->{'short_description'}.
+             "\n";
+     }
+     $Str .="</dl>\n";
+     $Str .="</form>\n";
      $request->print(<<GRADINGMENUJS);
  <script type="text/javascript" language="javascript">
      function checkChoice(formname,val,cmdx) {
- Line 6108  sub gradingmenu {
+ Line 7300  sub gradingmenu {
  	}
  	if (val < 7) formname.submit();
      }
+     function checkChoice2(formname,val,cmdx) {
+ 	if (val <= 2) {
+ 	    var cmd = radioSelection(formname.radioChoice);
+ 	    var cmdsave = cmd;
+ 	} else {
+ 	    cmd = cmdx;
+ 	    cmdsave = 'submission';
+ 	}
+ 	formname.command.value = cmd;
+ 	if (val < 5) formname.submit();
+ 	if (val == 5) {
+ 	    if (!checkReceiptNo(formname,'notOK')) { return false;}
+ 	    formname.submit();
+ 	}
+ 	if (val < 7) formname.submit();
+     }
      function checkReceiptNo(formname,nospace) {
  	var receiptNo = formname.receipt.value;
- Line 6126  sub gradingmenu {
+ Line 7334  sub gradingmenu {
  GRADINGMENUJS
      &commonJSfunctions($request);
      my $result='<h3>&nbsp;<span class="LC_info">Manual Grading/View Submission</span></h3>';
-     my ($table,undef,$hdgrade) = &showResourceInfo($symb,$probTitle);
      $result.=$table;
      my (undef,$sections) = &getclasslist('all','0');
      my $savedState = &savedState();
- Line 6138  GRADINGMENUJS
+ Line 7345  GRADINGMENUJS
      $result.='<form action="/adm/grades" method="post" name="gradingMenu">'."\n".
  	'<input type="hidden" name="symb"        value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
  	'<input type="hidden" name="handgrade"   value="'.$hdgrade.'" />'."\n".
- 	'<input type="hidden" name="probTitle"   value="'.$probTitle.'" />'."\n".
+ 	'<input type="hidden" name="probTitle"   value="'.$probTitle.'" ue="" />'."\n".
- 	'<input type="hidden" name="command"     value="" />'."\n".
  	'<input type="hidden" name="saveState"   value="" />'."\n".
  	'<input type="hidden" name="gradingMenu" value="1" />'."\n".
  	'<input type="hidden" name="showgrading" value="yes" />'."\n";
- Line 6150  GRADINGMENUJS
+ Line 7356  GRADINGMENUJS
  	'<tr bgcolor="#ffffe6" valign="top"><td>'."\n";
      $result.='<table width="100%" border="0">';
+     $result.='<tr bgcolor="#ffffe6" valign="top">'."\n";
+     $result.='<td><b>'.&mt('Sections').'</b></td>';
+ #    $result.='<td>Groups</td>';
+     $result.='<td><b>'.&mt('Access Status').'</td>'."\n";
+     $result.='</tr>';
      $result.='<tr bgcolor="#ffffe6" valign="top"><td>'."\n".
- 	'&nbsp;'.&mt('Select Section').': <select name="section">'."\n";
+ 	'&nbsp;<select name="section" multiple="multiple" size="3">'."\n";
      if (ref($sections)) {
  	foreach (sort (@$sections)) {
  	    $result.='<option value="'.$_.'" '.
- Line 6159  GRADINGMENUJS
+ Line 7370  GRADINGMENUJS
  	}
      }
      $result.= '<option value="all" '.($saveSec eq 'all' ? 'selected="selected"' : ''). '>all</option></select> &nbsp; ';
+     return $Str;
+ }
-     $result.=&mt('Student Status').':'.&Apache::lonhtmlcommon::StatusOptions($saveStatus,undef,1,undef);
+ #--- Displays the submissions first page -------
+ sub submit_options {
+     my ($request) = @_;
+     my ($symb)=&get_symb($request);
+     if (!$symb) {return '';}
+     my $probTitle = &Apache::lonnet::gettitle($symb);
+     $request->print(<<GRADINGMENUJS);
+ <script type="text/javascript" language="javascript">
+     function checkChoice(formname,val,cmdx) {
+ 	if (val <= 2) {
+ 	    var cmd = radioSelection(formname.radioChoice);
+ 	    var cmdsave = cmd;
+ 	} else {
+ 	    cmd = cmdx;
+ 	    cmdsave = 'submission';
+ 	}
+ 	formname.command.value = cmd;
+ 	formname.saveState.value = "saveCmd="+cmdsave+":saveSec="+pullDownSelection(formname.section)+
+ 	    ":saveSub="+pullDownSelection(formname.submitonly)+":saveStatus="+pullDownSelection(formname.Status);
+ 	if (val < 5) formname.submit();
+ 	if (val == 5) {
+ 	    if (!checkReceiptNo(formname,'notOK')) { return false;}
+ 	    formname.submit();
+ 	}
+ 	if (val < 7) formname.submit();
+     }
+     function checkReceiptNo(formname,nospace) {
+ 	var receiptNo = formname.receipt.value;
+ 	var checkOpt = false;
+ 	if (nospace == "OK" && isNaN(receiptNo)) {checkOpt = true;}
+ 	if (nospace == "notOK" && (isNaN(receiptNo) || receiptNo == "")) {checkOpt = true;}
+ 	if (checkOpt) {
+ 	    alert("Please enter a receipt number given by a student in the receipt box.");
+ 	    formname.receipt.value = "";
+ 	    formname.receipt.focus();
+ 	    return false;
+ 	}
+ 	return true;
+     }
+ </script>
+ GRADINGMENUJS
+     &commonJSfunctions($request);
+     my $result='<h3>&nbsp;<span class="LC_info">Manual Grading/View Submission</span></h3>';
+     my ($table,undef,$hdgrade) = &showResourceInfo($symb,$probTitle);
+     $result.=$table;
+     my (undef,$sections) = &getclasslist('all','0');
+     my $savedState = &savedState();
+     my $saveCmd = ($$savedState{'saveCmd'} eq '' ? 'submission' : $$savedState{'saveCmd'});
+     my $saveSec = ($$savedState{'saveSec'} eq '' ? 'all' : $$savedState{'saveSec'});
+     my $saveSub = ($$savedState{'saveSub'} eq '' ? 'all' : $$savedState{'saveSub'});
+     my $saveStatus = ($$savedState{'saveStatus'} eq '' ? 'Active' : $$savedState{'saveStatus'});
+     $result.='<form action="/adm/grades" method="post" name="gradingMenu">'."\n".
+ 	'<input type="hidden" name="symb"        value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
+ 	'<input type="hidden" name="handgrade"   value="'.$hdgrade.'" />'."\n".
+ 	'<input type="hidden" name="probTitle"   value="'.$probTitle.'" />'."\n".
+ 	'<input type="hidden" name="command"     value="" />'."\n".
+ 	'<input type="hidden" name="saveState"   value="" />'."\n".
+ 	'<input type="hidden" name="gradingMenu" value="1" />'."\n".
+ 	'<input type="hidden" name="showgrading" value="yes" />'."\n";
+     $result.='<table border="0"><tr><td bgcolor=#777777>'."\n".
+ 	'<table width="100%" border="0"><tr bgcolor="#e6ffff"><td>'."\n".
+ 	'&nbsp;<b>Select a Grading/Viewing Option</b></td></tr>'."\n".
+ 	'<tr bgcolor="#ffffe6" valign="top"><td>'."\n";
+     $result.='<table width="100%" border="0">';
+     $result.='<tr bgcolor="#ffffe6" valign="top">'."\n";
+     $result.='<td><b>'.&mt('Sections').'</b></td>';
+     $result.='<td><b>'.&mt('Groups').'</b></td>';
+     $result.='<td><b>'.&mt('Access Status').'</td>'."\n";
+     $result.='</tr>';
+     $result.='<tr bgcolor="#ffffe6" valign="top"><td>'."\n".
+ 	'&nbsp;<select name="section" multiple="multiple" size="3">'."\n";
+     if (ref($sections)) {
+ 	foreach (sort (@$sections)) {
+ 	    $result.='<option value="'.$_.'" '.
+ 		($saveSec eq $_ ? 'selected="selected"':'').'>'.$_.'</option>'."\n";
+ 	}
+     }
+     $result.= '<option value="all" '.($saveSec eq 'all' ? 'selected="selected"' : ''). '>all</option></select> &nbsp; ';
+     $result.= '</td><td>'."\n";
+     $result.= &Apache::lonstatistics::GroupSelect('group','multiple',3);
+     $result.='</td><td>'."\n";
+     $result.=&Apache::lonhtmlcommon::StatusOptions($saveStatus,undef,3,undef,'mult');
      $result.='</td></tr>';
-     $result.='<tr bgcolor="#ffffe6"valign="top"><td><label>'.
+     $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="3"><label>'.
  	'<input type="radio" name="radioChoice" value="submission" '.
  	($saveCmd eq 'submission' ? 'checked="checked"' : '').' /> '.'<b>'.&mt('Current Resource').':</b> '.&mt('For one or more students').
  	'</label> <select name="submitonly">'.
- Line 6179  GRADINGMENUJS
+ Line 7479  GRADINGMENUJS
  	'<option value="all" '.
  	($saveSub eq 'all' ? 'selected="selected"' : '').'>'.&mt('with any status').'</option></select></td></tr>'."\n";
-     $result.='<tr bgcolor="#ffffe6"valign="top"><td>'.
+     $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="2">'.
  	'<label><input type="radio" name="radioChoice" value="viewgrades" '.
  	($saveCmd eq 'viewgrades' ? 'checked="checked"' : '').' /> '.
  	'<b>Current Resource:</b> For all students in selected section or course</label></td></tr>'."\n";
-     $result.='<tr bgcolor="#ffffe6" valign="top"><td>'.
+     $result.='<tr bgcolor="#ffffe6" valign="top"><td colspan="2">'.
  	'<label><input type="radio" name="radioChoice" value="pickStudentPage" '.
  	($saveCmd eq 'pickStudentPage' ? 'checked="checked"' : '').' /> '.
  	'The <b>complete</b> set/page/sequence: For one student</label></td></tr>'."\n";
-     $result.='<tr bgcolor="#ffffe6"><td><br />'.
+     $result.='<tr bgcolor="#ffffe6"><td colspan="2"><br />'.
  	'<input type="button" onClick="javascript:checkChoice(this.form,\'2\');" value="Next->" />'.
  	'</td></tr></table>'."\n";
-     $result.='</td><td valign="top">';
+     $result.='</td>'; #<td valign="top">';
-     $result.='<table width="100%" border="0">';
+ #    $result.='<table width="100%" border="0">';
-     $result.='<tr bgcolor="#ffffe6"><td>'.
+ #    $result.='<tr bgcolor="#ffffe6"><td>'.
- 	'<input type="button" onClick="javascript:checkChoice(this.form,\'3\',\'csvform\');" value="'.&mt('Upload').'" />'.
+ #	'<input type="button" onClick="javascript:checkChoice(this.form,\'3\',\'csvform\');" value="'.&mt('Upload').'" />'.
- 	' '.&mt('scores from file').' </td></tr>'."\n";
+ #	' '.&mt('scores from file').' </td></tr>'."\n";
+ #
-     $result.='<tr bgcolor="#ffffe6"><td>'.
+ #    $result.='<tr bgcolor="#ffffe6"><td>'.
-         '<input type="button" onClick="javascript:checkChoice(this.form,\'6\',\'processclicker\');" value="'.&mt('Process').'" />'.
+ #        '<input type="button" onClick="javascript:checkChoice(this.form,\'6\',\'processclicker\');" value="'.&mt('Process').'" />'.
-         ' '.&mt('clicker file').' </td></tr>'."\n";
+ #        ' '.&mt('clicker file').' </td></tr>'."\n";
+ #
-     $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="2">'.
+ #    $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="2">'.
- 	'<input type="button" onClick="javascript:checkChoice(this.form,\'4\',\'scantron_selectphase\');'.
+ #	'<input type="button" onClick="javascript:checkChoice(this.form,\'4\',\'scantron_selectphase\');'.
- 	'" value="'.&mt('Grade').'" /> scantron forms</td></tr>'."\n";
+ #	'" value="'.&mt('Grade').'" /> scantron forms</td></tr>'."\n";
+ #
-     if ((&Apache::lonnet::allowed('mgr',$env{'request.course.id'})) && ($symb)) {
+ #    if ((&Apache::lonnet::allowed('mgr',$env{'request.course.id'})) && ($symb)) {
- 	$result.='<tr bgcolor="#ffffe6"valign="top"><td>'.
+ #	$result.='<tr bgcolor="#ffffe6"valign="top"><td>'.
- 	    '<input type="button" onClick="javascript:checkChoice(this.form,\'5\',\'verify\');" value="'.&mt('Verify').'" />'.
+ #	    '<input type="button" onClick="javascript:checkChoice(this.form,\'5\',\'verify\');" value="'.&mt('Verify').'" />'.
- 	    ' '.&mt('receipt').': '.
+ #	    ' '.&mt('receipt').': '.
- 	    &Apache::lonnet::recprefix($env{'request.course.id'}).
+ #	    &Apache::lonnet::recprefix($env{'request.course.id'}).
- 	    '-<input type="text" name="receipt" size="4" onChange="javascript:checkReceiptNo(this.form,\'OK\')" />'.
+ #	    '-<input type="text" name="receipt" size="4" onChange="javascript:checkReceiptNo(this.form,\'OK\')" />'.
- 	    '</td></tr>'."\n";
+ #	    '</td></tr>'."\n";
-     }
+ #    }
-     $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="2">'.
+ #    $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="2">'.
- 	'<input type="button" onClick="javascript:this.form.action=\'/adm/helper/resettimes.helper\';this.form.submit();'.
+ #	'<input type="button" onClick="javascript:this.form.action=\'/adm/helper/resettimes.helper\';this.form.submit();'.
- 	'" value="'.&mt('Manage').'" /> access times.</td></tr>'."\n";
+ #	'" value="'.&mt('Manage').'" /> access times.</td></tr>'."\n";
-     $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="2">'.
+ #    $result.='<tr bgcolor="#ffffe6"valign="top"><td colspan="2">'.
- 	'<input type="button" onClick="javascript:this.form.command.value=\'codelist\';this.form.action=\'/adm/pickcode\';this.form.submit();'.
+ #	'<input type="button" onClick="javascript:this.form.command.value=\'codelist\';this.form.action=\'/adm/pickcode\';this.form.submit();'.
- 	'" value="'.&mt('View').'" /> saved CODEs.</td></tr>'."\n";
+ #	'" value="'.&mt('View').'" /> saved CODEs.</td></tr>'."\n";
+ #
-     $result.='</table>'."\n".
+ #    $result.='</table>'."\n".'</td>';
- 	'</td></tr></table>'."\n".
+     $result.= '</tr></table>'."\n".
  	'</td></tr></table></form>'."\n";
      return $result;
  }
- Line 6259  sub gather_clicker_ids {
+ Line 7559  sub gather_clicker_ids {
      # Set up a couple variables.
      my $username_idx = &Apache::loncoursedata::CL_SNAME();
      my $domain_idx   = &Apache::loncoursedata::CL_SDOM();
+     my $status_idx   = &Apache::loncoursedata::CL_STATUS();
      foreach my $student (keys(%$classlist)) {
+         if ($classlist->{$student}->[$status_idx] ne 'Active') { next; }
          my $username = $classlist->{$student}->[$username_idx];
          my $domain   = $classlist->{$student}->[$domain_idx];
          my $clickers =
- Line 6398  function sanitycheck() {
+ Line 7699  function sanitycheck() {
  <input type="hidden" name="saveState"  value="$env{'form.saveState'}" />
  <input type="file" name="upfile" size="50" />
  <br /><label>$type: $selectform</label>
- <br /><label>$attendance: <input type="radio" name="gradingmechanism" value="attendance" $checked{'attendance'} onClick="sanitycheck()" /></label>
+ <br /><label><input type="radio" name="gradingmechanism" value="attendance" $checked{'attendance'} onClick="sanitycheck()" />$attendance </label>
- <br /><label>$personnel: <input type="radio" name="gradingmechanism" value="personnel" $checked{'personnel'} onClick="sanitycheck()" /></label>
+ <br /><label><input type="radio" name="gradingmechanism" value="personnel" $checked{'personnel'} onClick="sanitycheck()" />$personnel</label>
- <br /><label>$specific: <input type="radio" name="gradingmechanism" value="specific" $checked{'specific'} onClick="sanitycheck()" /></label>
+ <br /><label><input type="radio" name="gradingmechanism" value="specific" $checked{'specific'} onClick="sanitycheck()" />$specific </label>
  <input type="text" name="specificid" value="$env{'form.specificid'}" size="20" />
  <input type="hidden" name="waschecked" value="$env{'form.gradingmechanism'}" />
  <br /><label>$pcorrect: <input type="text" name="pcorrect" size="4" value="$env{'form.pcorrect'}" onChange="sanitycheck()" /></label>
- Line 6503  ENDHEADER
+ Line 7804  ENDHEADER
      }
      $result.='<br />'.&mt('Found [_1] question(s)',$number).'<br />'.
               '<input type="hidden" name="number" value="'.$number.'" />'.
+              &mt('Awarding [_1] percent for corrion(s)',$number).'<br />'.
+              '<input type="hidden" name="number" value="'.$number.'" />'.
               &mt('Awarding [_1] percent for correct and [_2] percent for incorrect responses',
                   $env{'form.pcorrect'},$env{'form.pincorrect'}).
               '<br />';
- Line 6522  ENDHEADER
+ Line 7825  ENDHEADER
            $result.="\n".'<input type="hidden" name="correct:'.$correct_count.':'.$correct_ids{$id}.'" value="'.$responses{$id}.'" />';
            $correct_count++;
         } elsif ($clicker_ids{$id}) {
-           $result.="\n".'<input type="hidden" name="student:'.$clicker_ids{$id}.'" value="'.$responses{$id}.'" />';
+           if ($clicker_ids{$id}=~/\,/) {
-           $student_count++;
+ # More than one user with the same clicker!
+              $result.="\n<hr />".&mt('Clicker registered more than once').": <tt>".$id."</tt><br />";
+              $result.="\n".'<input type="hidden" name="unknown:'.$id.'" value="'.$responses{$id}.'" />'.
+                            "<select name='multi".$id."'>";
+              foreach my $reguser (sort(split(/\,/,$clicker_ids{$id}))) {
+                  $result.="<option value='".$reguser."'>".&Apache::loncommon::plainname(split(/\:/,$reguser)).' ('.$reguser.')</option>';
+              }
+              $result.='</select>';
+              $unknown_count++;
+           } else {
+ # Good: found one and only one user with the right clicker
+              $result.="\n".'<input type="hidden" name="student:'.$clicker_ids{$id}.'" value="'.$responses{$id}.'" />';
+              $student_count++;
+           }
         } else {
            $result.="\n<hr />".&mt('Unregistered Clicker')." <tt>".$id."</tt><br />";
            $result.="\n".'<input type="hidden" name="unknown:'.$id.'" value="'.$responses{$id}.'" />'.
- Line 6543  ENDHEADER
+ Line 7859  ENDHEADER
            $result.='<br /><span class="LC_warning">'.&mt("Found [_1] entries for grading!",$correct_count).'</span>';
         }
      }
+     if ($number<1) {
+        $errormsg.="Found no questions.";
+     }
      if ($errormsg) {
         $result.='<br /><span class="LC_error">'.&mt($errormsg).'</span>';
      } else {
- Line 6671  ENDHEADER
+ Line 7990  ENDHEADER
            my $id=$1;
            if (($env{'form.uname'.$id}) && ($env{'form.udom'.$id})) {
               $user=$env{'form.uname'.$id}.':'.$env{'form.udom'.$id};
+           } elsif ($env{'form.multi'.$id}) {
+              $user=$env{'form.multi'.$id};
            }
         }
         if ($user) {
- Line 6716  ENDHEADER
+ Line 8037  ENDHEADER
  sub handler {
      my $request=$_[0];
-     &reset_perm();
+     &reset_caches();
      if ($env{'browser.mathml'}) {
  	&Apache::loncommon::content_type($request,'text/xml');
      } else {
- Line 6728  sub handler {
+ Line 8049  sub handler {
      my $symb=&get_symb($request,1);
      my @commands=&Apache::loncommon::get_env_multiple('form.command');
      my $command=$commands[0];
      if ($#commands > 0) {
  	&Apache::lonnet::logthis("grades got multiple commands ".join(':',@commands));
      }
      $request->print(&Apache::loncommon::start_page('Grading'));
      if ($symb eq '' && $command eq '') {
  	if ($env{'user.adv'}) {
- Line 6771  sub handler {
+ Line 8095  sub handler {
  	} elsif ($command eq 'processGroup' && $perm{'vgr'}) {
  	    &processGroup($request);
  	} elsif ($command eq 'gradingmenu' && $perm{'vgr'}) {
- 	    $request->print(&gradingmenu($request));
+ 	    $request->print(&grading_menu($request));
+ 	} elsif ($command eq 'submit_options' && $perm{'vgr'}) {
+ 	    $request->print(&submit_options($request));
  	} elsif ($command eq 'viewgrades' && $perm{'vgr'}) {
  	    $request->print(&viewgrades($request));
  	} elsif ($command eq 'handgrade' && $perm{'mgr'}) {
- Line 6806  sub handler {
+ Line 8132  sub handler {
  	} elsif ($command eq 'csvuploadassign' && $perm{'mgr'} ) {
  	    $request->print(&csvuploadassign($request));
  	} elsif ($command eq 'scantron_selectphase' && $perm{'mgr'}) {
+ 	    &Apache::lonnet::logthis("Selecting pyhase");
  	    $request->print(&scantron_selectphase($request));
   	} elsif ($command eq 'scantron_warning' && $perm{'mgr'}) {
   	    $request->print(&scantron_do_warning($request));
- Line 6829  sub handler {
+ Line 8156  sub handler {
  	}
      }
      $request->print(&Apache::loncommon::end_page());
+     &reset_caches();
      return '';
  }

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

Removed from v.1.422
changed lines
	Added in v.1.453