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.528.2.12 and 1.560

version 1.528.2.12, 2009/03/21 20:02:28	version 1.560, 2009/03/19 21:00:42
Line 26	Line 26
# http://www.lon-capa.org/	# http://www.lon-capa.org/
#	#



package Apache::grades;	package Apache::grades;
use strict;	use strict;
use Apache::style;	use Apache::style;
Line 58 my $ssi_error_resource;	Line 60 my $ssi_error_resource;
my $ssi_error_message;	my $ssi_error_message;


# Do an ssi with retries:
# While I'd love to factor out this with the vesrion in lonprintout,
# that would either require a data coupling between modules, which I refuse to perpetuate
# (there's quite enough of that already), or would require the invention of another infrastructure
# I'm not quite ready to invent (e.g. an ssi_with_retry object).
#
# At least the logic that drives this has been pulled out into loncommon.


#
# ssi_with_retries - Does the server side include of a resource.
# if the ssi call returns an error we'll retry it up to
# the number of times requested by the caller.
# If we still have a proble, no text is appended to the
# output and we set some global variables.
# to indicate to the caller an SSI error occurred.
# All of this is supposed to deal with the issues described
# in LonCAPA BZ 5631 see:
# http://bugs.lon-capa.org/show_bug.cgi?id=5631
# by informing the user that this happened.
#
# Parameters:
# resource - The resource to include. This is passed directly, without
# interpretation to lonnet::ssi.
# form - The form hash parameters that guide the interpretation of the resource
#
# retries - Number of retries allowed before giving up completely.
# Returns:
# On success, returns the rendered resource identified by the resource parameter.
# Side Effects:
# The following global variables can be set:
# ssi_error - If an unrecoverable error occurred this becomes true.
# It is up to the caller to initialize this to false
# if desired.
# ssi_error_resource - If an unrecoverable error occurred, this is the value
# of the resource that could not be rendered by the ssi
# call.
# ssi_error_message - The error string fetched from the ssi response
# in the event of an error.
#
sub ssi_with_retries {	sub ssi_with_retries {
my ($resource, $retries, %form) = @_;	my ($resource, $retries, %form) = @_;
my ($content, $response) = &Apache::loncommon::ssi_with_retries($resource, $retries, %form);	my ($content, $response) = &Apache::loncommon::ssi_with_retries($resource, $retries, %form);
Line 256 sub showResourceInfo {	Line 218 sub showResourceInfo {
}	}
my $display_part=&get_display_part($partID,$symb);	my $display_part=&get_display_part($partID,$symb);
$result.='<td><b>'.&mt('Part').': </b>'.$display_part.	$result.='<td><b>'.&mt('Part').': </b>'.$display_part.
' <span class="LC_internal_info">'.$resID.'</span></td>'.	' <span class="LC_internal_info">'.$resID.'</span></td>'.
'<td><b>'.&mt('Type').': </b>'.$responsetype.'</td></tr>';	'<td><b>'.&mt('Type').': </b>'.$responsetype.'</td></tr>';
# '<td>'.&mt('<b>Handgrade: </b>[_1]',$handgrade).'</td></tr>';	# '<td>'.&mt('<b>Handgrade: </b>[_1]',$handgrade).'</td></tr>';
}	}
}	}
Line 272 sub reset_caches {	Line 234 sub reset_caches {

{	{
my %analyze_cache;	my %analyze_cache;
	my %analyze_cache_formkeys;

sub reset_analyze_cache {	sub reset_analyze_cache {
undef(%analyze_cache);	undef(%analyze_cache);
	undef(%analyze_cache_formkeys);
}	}

sub get_analyze {	sub get_analyze {
my ($symb,$uname,$udom,$no_increment)=@_;	my ($symb,$uname,$udom,$no_increment,$add_to_hash)=@_;
my $key = "$symb\0$uname\0$udom";	my $key = "$symb\0$uname\0$udom";
return $analyze_cache{$key} if (exists($analyze_cache{$key}));	if (exists($analyze_cache{$key})) {
	my $getupdate = 0;
	if (ref($add_to_hash) eq 'HASH') {
	foreach my $item (keys(%{$add_to_hash})) {
	if (ref($analyze_cache_formkeys{$key}) eq 'HASH') {
	if (!exists($analyze_cache_formkeys{$key}{$item})) {
	$getupdate = 1;
	last;
	}
	} else {
	$getupdate = 1;
	}
	}
	}
	if (!$getupdate) {
	return $analyze_cache{$key};
	}
	}

my (undef,undef,$url)=&Apache::lonnet::decode_symb($symb);	my (undef,undef,$url)=&Apache::lonnet::decode_symb($symb);
$url=&Apache::lonnet::clutter($url);	$url=&Apache::lonnet::clutter($url);
my $subresult=&ssi_with_retries($url, $ssi_retries,	my %form = ('grade_target' => 'analyze',
('grade_target' => 'analyze',	'grade_domain' => $udom,
'grade_domain' => $udom,	'grade_symb' => $symb,
'grade_symb' => $symb,	'grade_courseid' => $env{'request.course.id'},
'grade_courseid' =>	'grade_username' => $uname,
$env{'request.course.id'},	'grade_noincrement' => $no_increment);
'grade_username' => $uname,	if (ref($add_to_hash)) {
'grade_noincrement' => $no_increment));	%form = (%form,%{$add_to_hash});
	}
	my $subresult=&ssi_with_retries($url, $ssi_retries,%form);
(undef,$subresult)=split(/_HASH_REF__/,$subresult,2);	(undef,$subresult)=split(/_HASH_REF__/,$subresult,2);
my %analyze=&Apache::lonnet::str2hash($subresult);	my %analyze=&Apache::lonnet::str2hash($subresult);
	if (ref($add_to_hash) eq 'HASH') {
	$analyze_cache_formkeys{$key} = $add_to_hash;
	} else {
	$analyze_cache_formkeys{$key} = {};
	}
return $analyze_cache{$key} = \%analyze;	return $analyze_cache{$key} = \%analyze;
}	}

Line 308 sub reset_caches {	Line 296 sub reset_caches {
my $analyze = &get_analyze($symb,$uname,$udom);	my $analyze = &get_analyze($symb,$uname,$udom);
my $foils = &get_order($partid,$respid,$symb,$uname,$udom);	my $foils = &get_order($partid,$respid,$symb,$uname,$udom);
if (ref($foils) eq 'ARRAY') {	if (ref($foils) eq 'ARRAY') {
foreach my $foil (@{$foils}) {	foreach my $foil (@{$foils}) {
if ($analyze->{"$partid.$respid.foil.value.$foil"} eq 'true') {	if ($analyze->{"$partid.$respid.foil.value.$foil"} eq 'true') {
return $foil;	return $foil;
	}
	}
	}
	}

	sub scantron_partids_tograde {
	my ($resource,$cid,$uname,$udom,$check_for_randomlist) = @_;
	my (%analysis,@parts);
	if (ref($resource)) {
	my $symb = $resource->symb();
	my $add_to_form;
	if ($check_for_randomlist) {
	$add_to_form = { 'check_parts_withrandomlist' => 1,};
	}
	my $analyze = &get_analyze($symb,$uname,$udom,undef,$add_to_form);
	if (ref($analyze) eq 'HASH') {
	%analysis = %{$analyze};
	}
	if (ref($analysis{'parts'}) eq 'ARRAY') {
	foreach my $part (@{$analysis{'parts'}}) {
	my ($id,$respid) = split(/\./,$part);
	if (!&Apache::loncommon::check_if_partid_hidden($id,$symb,$udom,$uname)) {
	push(@parts,$part);
	}
}	}
}	}
}	}
	return (\%analysis,\@parts);
}	}

}	}

#--- Clean response type for display	#--- Clean response type for display
Line 740 sub verifyreceipt {	Line 754 sub verifyreceipt {

my $title.=	my $title.=
'<h3><span class="LC_info">'.	'<h3><span class="LC_info">'.
&mt('Verifying Receipt No. [_1]',$receipt).	&mt('Verifying Receipt No. [_1]',$receipt).
'</span></h3>'."\n".	'</span></h3>'."\n".
'<h4>'.&mt('<b>Resource: </b>[_1]',$env{'form.probTitle'}).	'<h4>'.&mt('<b>Resource: </b>[_1]',$env{'form.probTitle'}).
'</h4>'."\n";	'</h4>'."\n";
Line 824 sub listStudents {	Line 838 sub listStudents {
$env{'form.probTitle'} = $env{'form.probTitle'} eq '' ?	$env{'form.probTitle'} = $env{'form.probTitle'} eq '' ?
&Apache::lonnet::gettitle($symb) : $env{'form.probTitle'};	&Apache::lonnet::gettitle($symb) : $env{'form.probTitle'};

my $result='<h3><span class="LC_info"> '.	my $result='<h3><span class="LC_info"> '
&mt("$viewgrade Submissions for a Student or a Group of Students")	.&mt("$viewgrade Submissions for a Student or a Group of Students")
.'</span></h3>';	.'</span></h3>';

my ($table,undef,$hdgrade,$partlist,$handgrade) = &showResourceInfo($symb,$env{'form.probTitle'},($env{'form.showgrading'} eq 'yes'));	my ($table,undef,$hdgrade,$partlist,$handgrade) = &showResourceInfo($symb,$env{'form.probTitle'},($env{'form.showgrading'} eq 'yes'));

my %lt = &Apache::lonlocal::texthash (	my %lt = &Apache::lonlocal::texthash (
'multiple' => 'Please select a student or group of students before clicking on the Next button.',	'multiple' => 'Please select a student or group of students before clicking on the Next button.',
'single' => 'Please select the student before clicking on the Next button.',	'single' => 'Please select the student before clicking on the Next button.',
);	);
$request->print(<<LISTJAVASCRIPT);	$request->print(<<LISTJAVASCRIPT);
<script type="text/javascript" language="javascript">	<script type="text/javascript" language="javascript">
function checkSelect(checkBox) {	function checkSelect(checkBox) {
Line 1151 sub processGroup {	Line 1165 sub processGroup {
#--- Javascript to handle the submission page functionality ---	#--- Javascript to handle the submission page functionality ---
sub sub_page_js {	sub sub_page_js {
my $request = shift;	my $request = shift;
my $alertmsg = &mt('A number equal or greater than 0 is expected. Entered value = ');	my $alertmsg = &mt('A number equal or greater than 0 is expected. Entered value = ');
$request->print(<<SUBJAVASCRIPT);	$request->print(<<SUBJAVASCRIPT);
<script type="text/javascript" language="javascript">	<script type="text/javascript" language="javascript">
function updateRadio(formname,id,weight) {	function updateRadio(formname,id,weight) {
Line 1708 sub gradeBox {	Line 1722 sub gradeBox {
$line.='<option value="reset status">'.&mt('reset status').'</option></select>'."\n";	$line.='<option value="reset status">'.&mt('reset status').'</option></select>'."\n";


	#&mt('<td><b>Part:</b></td><td>[_1]</td><td><b>Points:</b></td><td>[_2]</td><td>or</td><td>[_3]</td>',$display_part,$radio,$line);
$result .=	$result .=
'<td><b>'.&mt('Part').':</b></td><td>'.$display_part.'</td><td><b>'.&mt('Points').':</b></td><td>'.$radio.'</td><td>'.&mt('or').'</td><td>'.$line.'</td>';	'<td><b>'.&mt('Part').':</b></td><td>'.$display_part.'</td><td><b>'.&mt('Points').':</b></td><td>'.$radio.'</td><td>'.&mt('or').'</td><td>'.$line.'</td>'.

$result.='</tr></table>'."\n";	$result.='</tr></table>'."\n";
$result.='<input type="hidden" name="stores'.$counter.'_'.$partid.'" value="" />'."\n".	$result.='<input type="hidden" name="stores'.$counter.'_'.$partid.'" value="" />'."\n".
Line 2369 sub get_last_submission {	Line 2384 sub get_last_submission {
}	}
if (!@string) {	if (!@string) {
$string[0] =	$string[0] =
'<span class="LC_warning">Nothing submitted - no attempts.</span>';	'<span class="LC_warning">'.&mt('Nothing submitted - no attempts.').'</span>';
}	}
return (\@string,\$timestamp);	return (\@string,\$timestamp);
}	}
Line 3213 sub viewgrades {	Line 3228 sub viewgrades {

my ($common_header,$specific_header);	my ($common_header,$specific_header);
if ($env{'form.section'} eq 'all') {	if ($env{'form.section'} eq 'all') {
$common_header = &mt('Assign Common Grade to Class');	$common_header = &mt('Assign Common Grade to Class');
$specific_header = &mt('Assign Grade to Specific Students in Class');	$specific_header = &mt('Assign Grade to Specific Students in Class');
} elsif ($env{'form.section'} eq 'none') {	} elsif ($env{'form.section'} eq 'none') {
$common_header = &mt('Assign Common Grade to Students in no Section');	$common_header = &mt('Assign Common Grade to Students in no Section');
$specific_header = &mt('Assign Grade to Specific Students in no Section');	$specific_header = &mt('Assign Grade to Specific Students in no Section');
} else {	} else {
my $section_display = join (", ",&Apache::loncommon::get_env_multiple('form.section'));	my $section_display = join (", ",&Apache::loncommon::get_env_multiple('form.section'));
$common_header = &mt('Assign Common Grade to Students in Section(s) [_1]',$section_display);	$common_header = &mt('Assign Common Grade to Students in Section(s) [_1]',$section_display);
$specific_header = &mt('Assign Grade to Specific Students in Section(s) [_1]',$section_display);	$specific_header = &mt('Assign Grade to Specific Students in Section(s) [_1]',$section_display);
}	}
$result.= '<h3>'.$common_header.'</h3>'.&Apache::loncommon::start_data_table();	$result.= '<h3>'.$common_header.'</h3>'.&Apache::loncommon::start_data_table();
#radio buttons/text box for assigning points for a section or class.	#radio buttons/text box for assigning points for a section or class.
Line 3270 sub viewgrades {	Line 3285 sub viewgrades {

$result.=	$result.=
&Apache::loncommon::start_data_table_row()."\n".	&Apache::loncommon::start_data_table_row()."\n".
'<td><b>'.&mt('Part').':</b></td><td>'.$display_part.'</td><td><b>'.&mt('Points').':</b></td><td>'.$radio.'</td><td>'.&mt('or').'</td><td>'.$line.'</td>'.	'<td><b>'.&mt('Part').':</b></td><td>'.$display_part.'</td><td><b>'.&mt('Points').':</b></td><td>'.$radio.'</td><td>'.&mt('or').'</td><td>'.$line.'</td>'.
&Apache::loncommon::end_data_table_row()."\n";	&Apache::loncommon::end_data_table_row()."\n";
$ctsparts++;	$ctsparts++;
}	}
Line 3291 sub viewgrades {	Line 3306 sub viewgrades {
my @partids = ();	my @partids = ();
foreach my $part (@parts) {	foreach my $part (@parts) {
my $display=&Apache::lonnet::metadata($url,$part.'.display');	my $display=&Apache::lonnet::metadata($url,$part.'.display');
my $narrowtext = &mt('Tries').'<br />';	my $narrowtext = &mt('Tries');
$display =~ s{^Number of Attempts}{$narrowtext}; # makes the column narrower	$display =~ s\|^Number of Attempts\|$narrowtext <br />\|; # makes the column narrower
if (!$display) { $display = &Apache::lonnet::metadata($url,$part.'.name'); }	if (!$display) { $display = &Apache::lonnet::metadata($url,$part.'.name'); }
my ($partid) = &split_part_type($part);	my ($partid) = &split_part_type($part);
push(@partids,$partid);	push(@partids,$partid);
my $display_part=&get_display_part($partid,$symb);	my $display_part=&get_display_part($partid,$symb);
if ($display =~ /^Partial Credit Factor/) {	if ($display =~ /^Partial Credit Factor/) {
$result.='<th>'.	$result.='<th>'.
&mt('Score Part: [_1] (weight = [_2])',	&mt('Score Part: [_1]<br /> (weight = [_2])',
$display_part.'<br />',$weight{$partid}).'</th>'."\n";	$display_part,$weight{$partid}).'</th>'."\n";
next;	next;

} else {	} else {
if ($display =~ /Problem Status/) {	if ($display =~ /Problem Status/) {
my $grade_status_mt = &mt('Grade Status').'<br />';	my $grade_status_mt = &mt('Grade Status');
$display =~ s{Problem Status}{$grade_status_mt};	$display =~ s{Problem Status}{$grade_status_mt<br />};
}	}
my $part_mt = &mt('Part:');	my $part_mt = &mt('Part:');
$display =~s{\[Part: \Q$partid\E\]}{$part_mt $display_part};	$display =~s{\[Part: \Q$partid\E\]}{$part_mt $display_part};
Line 3465 sub editgrades {	Line 3480 sub editgrades {
my $display=&Apache::lonnet::metadata($url,$stores.'.display');	my $display=&Apache::lonnet::metadata($url,$stores.'.display');
$display =~ s/\[Part: \Q$part\E\]//;	$display =~ s/\[Part: \Q$part\E\]//;
my $narrowtext = &mt('Tries');	my $narrowtext = &mt('Tries');
$display =~ s{Number of Attempts}{$narrowtext};	$display =~ s/Number of Attempts/$narrowtext/;
$header .= '<th align="center">'.&mt('Old').' '.$display.'</th>'.	$header .= '<th align="center">'.&mt('Old').' '.$display.'</th>'.
'<th align="center">'.&mt('New').' '.$display.'</th>';	'<th align="center">'.&mt('New').' '.$display.'</th>';
$columns{$partid}+=2;	$columns{$partid}+=2;
Line 3779 ENDPICK	Line 3794 ENDPICK
sub csvupload_fields {	sub csvupload_fields {
my ($symb) = @_;	my ($symb) = @_;
my (@parts) = &getpartlist($symb);	my (@parts) = &getpartlist($symb);
my @fields=(['ID','Student ID'],	my @fields=(['ID','Student/Employee ID'],
['username','Student Username'],	['username','Student Username'],
['domain','Student Domain']);	['domain','Student Domain']);
my (undef,undef,$url) = &Apache::lonnet::decode_symb($symb);	my (undef,undef,$url) = &Apache::lonnet::decode_symb($symb);
Line 3835 sub upcsvScores_form {	Line 3850 sub upcsvScores_form {
$result.='<br /><table width="100%" border="0"><tr><td bgcolor="#777777">'."\n";	$result.='<br /><table width="100%" border="0"><tr><td bgcolor="#777777">'."\n";
$result.='<table width="100%" border="0"><tr bgcolor="#e6ffff"><td>'."\n";	$result.='<table width="100%" border="0"><tr bgcolor="#e6ffff"><td>'."\n";
$result.=' <b>'.&mt('Specify a file containing the class scores for current resource.').	$result.=' <b>'.&mt('Specify a file containing the class scores for current resource.').
'.</b></td></tr>'."\n";	'</b></td></tr>'."\n";
$result.='<tr bgcolor=#ffffe6><td>'."\n";	$result.='<tr bgcolor=#ffffe6><td>'."\n";
my $upload=&mt("Upload Scores");	my $upload=&mt("Upload Scores");
my $upfile_select=&Apache::loncommon::upfile_select_html();	my $upfile_select=&Apache::loncommon::upfile_select_html();
Line 4129 LISTJAVASCRIPT	Line 4144 LISTJAVASCRIPT
$ctr++;	$ctr++;
}	}
$select.= '</select>';	$select.= '</select>';
$result.=' <b>'.&mt('Problems from').":</b> $select<br />\n";	$result.=' <b>'.&mt('Problems from').':</b> '.$select."<br />\n";

$ctr=0;	$ctr=0;
foreach (@$titles) {	foreach (@$titles) {
Line 4144 LISTJAVASCRIPT	Line 4159 LISTJAVASCRIPT
my $options =	my $options =
'<label><input type="radio" name="vProb" value="no" checked="checked" /> '.&mt('no').' </label>'."\n".	'<label><input type="radio" name="vProb" value="no" checked="checked" /> '.&mt('no').' </label>'."\n".
'<label><input type="radio" name="vProb" value="yes" /> '.&mt('yes').' </label>'."<br />\n";	'<label><input type="radio" name="vProb" value="yes" /> '.&mt('yes').' </label>'."<br />\n";
$result.=' <b>'.&mt('View Problem Text').": </b> $options";	$result.=' <b>'.&mt('View Problem Text').': </b>'.$options;

$options =	$options =
'<label><input type="radio" name="lastSub" value="none" /> '.&mt('none').' </label>'."\n".	'<label><input type="radio" name="lastSub" value="none" /> '.&mt('none').' </label>'."\n".
'<label><input type="radio" name="lastSub" value="datesub" checked="checked" /> '.&mt('by dates and submissions').'</label>'."\n".	'<label><input type="radio" name="lastSub" value="datesub" checked="checked" /> '.&mt('by dates and submissions').'</label>'."\n".
'<label><input type="radio" name="lastSub" value="all" /> '.&mt('all details').' </label>'."\n";	'<label><input type="radio" name="lastSub" value="all" /> '.&mt('all details').' </label>'."\n";
$result.=' >b>'.&mt('Submissions').": </b>$options";	$result.=' <b>'.&mt('Submissions').': </b>'.$options;

$result.=&build_section_inputs();	$result.=&build_section_inputs();
my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));	my $stu_status = join(':',&Apache::loncommon::get_env_multiple('form.Status'));
Line 4159 LISTJAVASCRIPT	Line 4174 LISTJAVASCRIPT
'<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'}.'" />'."<br />\n";	'<input type="hidden" name="saveState" value="'.$env{'form.saveState'}.'" />'."<br />\n";

$result.=' <b>'.&mt('Use CODE').': </b> <input type="text" name="CODE" value="" /><br />'."\n";	$result.=' <b>'.&mt('Use CODE').': </b> <input type="text" name="CODE" value="" /> <br />'."\n";

$result.=' <input type="button" '.	$result.=' <input type="button" '.
'onClick="javascript:checkPickOne(this.form);" value="'.&mt('Next').' →" /><br />'."\n";	'onClick="javascript:checkPickOne(this.form);" value="'.&mt('Next').' →" /><br />'."\n";
Line 4201 LISTJAVASCRIPT	Line 4216 LISTJAVASCRIPT
}	}
$studentTable.=&Apache::loncommon::end_data_table()."\n";	$studentTable.=&Apache::loncommon::end_data_table()."\n";
$studentTable.='<input type="button" '.	$studentTable.='<input type="button" '.
'onClick="javascript:checkPickOne(this.form);" value="'.&mt('Next->').'" /></form>'."\n";	'onClick="javascript:checkPickOne(this.form);" value="'.&mt('Next').' →" /></form>'."\n";

$studentTable.=&show_grading_menu_form($symb);	$studentTable.=&show_grading_menu_form($symb);
$request->print($studentTable);	$request->print($studentTable);
Line 4692 Next each scanline is checked for any er	Line 4707 Next each scanline is checked for any er
bubbles' (it's an error because it may have been mis-scanned	bubbles' (it's an error because it may have been mis-scanned
because too light bubbling), 'double bubble' (each bubble line should	because too light bubbling), 'double bubble' (each bubble line should
have no more that one letter picked), invalid or duplicated CODE,	have no more that one letter picked), invalid or duplicated CODE,
invalid student ID	invalid student/employee ID

If the CODE option is used that determines the randomization of the	If the CODE option is used that determines the randomization of the
homework problems, either way the student ID is looked up into a	homework problems, either way the student/employee ID is looked up into a
username:domain.	username:domain.

During the validation phase the instructor can choose to skip scanlines.	During the validation phase the instructor can choose to skip scanlines.
Line 4765 sub getSequenceDropDown {	Line 4780 sub getSequenceDropDown {
}	}

my %bubble_lines_per_response; # no. bubble lines for each response.	my %bubble_lines_per_response; # no. bubble lines for each response.
# index is "symb.part_id"	# key is zero-based index - 0, 1, 2 ...

my %first_bubble_line; # First bubble line no. for each bubble.	my %first_bubble_line; # First bubble line no. for each bubble.

Line 4806 sub restore_bubble_lines {	Line 4821 sub restore_bubble_lines {
$env{"form.scantron.responsetype.$line"};	$env{"form.scantron.responsetype.$line"};
$line++;	$line++;
}	}

}	}

# Given the parsed scanline, get the response for	# Given the parsed scanline, get the response for
Line 4815 sub restore_bubble_lines {	Line 4829 sub restore_bubble_lines {
sub get_response_bubbles {	sub get_response_bubbles {
my ($parsed_line, $response) = @_;	my ($parsed_line, $response) = @_;


my $bubble_line = $first_bubble_line{$response-1} +1;	my $bubble_line = $first_bubble_line{$response-1} +1;
my $bubble_lines= $bubble_lines_per_response{$response-1};	my $bubble_lines= $bubble_lines_per_response{$response-1};

Line 5171 sub scantron_selectphase {	Line 5184 sub scantron_selectphase {
'<td> '.$format_selector.' </td>'."\n".	'<td> '.$format_selector.' </td>'."\n".
&Apache::loncommon::end_data_table_row()."\n".	&Apache::loncommon::end_data_table_row()."\n".
&Apache::loncommon::start_data_table_row()."\n".	&Apache::loncommon::start_data_table_row()."\n".
	'<td> '.&mt('Options').' </td>'."\n".
	'<td> <label><input type="checkbox" name="scantron_options_hidden" value="ignore_hidden"/> '.&mt('Skip hidden resources').'</label></td>'.
	&Apache::loncommon::end_data_table_row()."\n".
	&Apache::loncommon::start_data_table_row()."\n".
'<td colspan="2">'."\n".	'<td colspan="2">'."\n".
'<input type="hidden" name="command" value="checksubmissions" />'."\n".	'<input type="hidden" name="command" value="checksubmissions" />'."\n".
'<input type="submit" value="'.&mt('Review Scantron Data and Submission Records').'" />'."\n".	'<input type="submit" value="'.&mt('Review Scantron Data and Submission Records').'" />'."\n".
Line 5214 sub scantron_selectphase {	Line 5231 sub scantron_selectphase {
CODEstart - (only matter if a CODE exists) column in the line where	CODEstart - (only matter if a CODE exists) column in the line where
the CODE starts	the CODE starts
CODElength - length of the CODE	CODElength - length of the CODE
IDstart - column where the student ID number starts	IDstart - column where the student/employee ID number starts
IDlength - length of the student ID info	IDlength - length of the student/employee ID info
Qstart - column where the information from the bubbled	Qstart - column where the information from the bubbled
'questions' start	'questions' start
Qlength - number of columns comprising a single bubble line from	Qlength - number of columns comprising a single bubble line from
Line 5275 sub get_scantron_config {	Line 5292 sub get_scantron_config {

=item username_to_idmap	=item username_to_idmap

creates a hash keyed by student id with values of the corresponding	creates a hash keyed by student/employee ID with values of the corresponding
student username:domain.	student username:domain.

Arguments:	Arguments:
Line 5314 sub username_to_idmap {	Line 5331 sub username_to_idmap {
$whichline - line number of the passed in scanline	$whichline - line number of the passed in scanline
$field - type of change to process	$field - type of change to process
(either	(either
'ID' -> correct the student ID number	'ID' -> correct the student/employee ID number
'CODE' -> correct the CODE	'CODE' -> correct the CODE
'answer' -> fixup the submitted answers)	'answer' -> fixup the submitted answers)

Line 5488 sub digits_to_letters {	Line 5505 sub digits_to_letters {
CODE_ignore_dup - 1 if the CODE is a duplicated use when unique	CODE_ignore_dup - 1 if the CODE is a duplicated use when unique
CODEs were selected, but the usage has been	CODEs were selected, but the usage has been
forced by the operator	forced by the operator
ID - student ID	ID - student/employee ID
PaperID - if used, the ID number printed on the sheet when the	PaperID - if used, the ID number printed on the sheet when the
paper was scanned	paper was scanned
FirstName - first name from the sheet	FirstName - first name from the sheet
Line 6214 sub scantron_validate_file {	Line 6231 sub scantron_validate_file {
}	}
}	}
if (!$stop) {	if (!$stop) {
my $warning=&scantron_warning_screen('Start Grading');	my $warning=&scantron_warning_screen('Start Grading');
$r->print(&mt('Validation process complete.').'<br />'.	$r->print(&mt('Validation process complete.').'<br />'.
$warning.	$warning.
&mt('Perform verification for each student after storage of submissions?').	&mt('Perform verification for each student after storage of submissions?').
' <span class="LC_nobreak"><label>'.	' <span class="LC_nobreak"><label>'.
Line 6223 sub scantron_validate_file {	Line 6240 sub scantron_validate_file {
(' 'x3).'<label>'.	(' 'x3).'<label>'.
'<input type="radio" name="verifyrecord" value="0" checked="checked" />'.&mt('No').	'<input type="radio" name="verifyrecord" value="0" checked="checked" />'.&mt('No').
'</label></span><br />'.	'</label></span><br />'.
&mt('Grading will take longer if you use verification.').'<br />'. &mt("Alternatively, the 'Review scantron data' utility (see grading menu) can be used for all students after grading is complete.").'<br /><br />'.	&mt('Grading will take longer if you use verification.').'<br />'.
	&mt("Alternatively, the 'Review scantron data' utility (see grading menu) can be used for all students after grading is complete.").'<br /><br />'.
'<input type="submit" name="submit" value="'.&mt('Start Grading').'" />'.	'<input type="submit" name="submit" value="'.&mt('Start Grading').'" />'.
'<input type="hidden" name="command" value="scantron_process" />'."\n");	'<input type="hidden" name="command" value="scantron_process" />'."\n");
} else {	} else {
$r->print('<input type="hidden" name="command" value="scantron_validate" />');	$r->print('<input type="hidden" name="command" value="scantron_validate" />');
$r->print("<input type='hidden' name='validatepass' value='".$currentphase."' />");	$r->print("<input type='hidden' name='validatepass' value='".$currentphase."' />");
}	}
if ($stop) {	if ($stop) {
if ($validate_phases[$currentphase] eq 'sequence') {	if ($validate_phases[$currentphase] eq 'sequence') {
$r->print('<input type="submit" name="submit" value="'.&mt('Ignore').' →" />');	$r->print('<input type="submit" name="submit" value="'.&mt('Ignore').' → " />');
$r->print(' '.&mt('this error').' <br />');	$r->print(' '.&mt('this error').' <br />');

$r->print(" <p>".&mt("Or click the 'Grading Menu' button to start over.")."</p>");	$r->print(" <p>".&mt("Or click the 'Grading Menu' button to start over.")."</p>");
Line 6618 sub scantron_validate_sequence {	Line 6636 sub scantron_validate_sequence {
return (0,$currentphase+1);	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 {	sub scantron_validate_ID {
my ($r,$currentphase) = @_;	my ($r,$currentphase) = @_;
Line 6691 sub scantron_validate_ID {	Line 6702 sub scantron_validate_ID {
return (0,$currentphase+1);	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 {	sub scantron_get_correction {
my ($r,$i,$scan_record,$scan_config,$line,$error,$arg)=@_;	my ($r,$i,$scan_record,$scan_config,$line,$error,$arg)=@_;
Line 6833 ENDSCRIPT	Line 6815 ENDSCRIPT
".&mt("[_1]Select[_2] a CODE from the list of all CODEs and use it.",	".&mt("[_1]Select[_2] a CODE from the list of all CODEs and use it.",
"<a target='_blank' href='$href'>","</a>")."	"<a target='_blank' href='$href'>","</a>")."
</label>	</label>
".&mt('Selected CODE is [_1]','<input readonly="readonly" type="text" size="8" name="scantron_CODE_selectedvalue" onfocus="javascript:change_radio(\'use_found\')" onchange="javascript:change_radio(\'use_found\')" />'));	".&mt("Selected CODE is [_1]",'<input readonly="readonly" type="text" size="8" name="scantron_CODE_selectedvalue" onfocus="javascript:change_radio(\'use_found\')" onchange="javascript:change_radio(\'use_found\')" />'));
$r->print("\n<br />");	$r->print("\n<br />");
}	}
$r->print("	$r->print("
Line 7290 sub scantron_validate_doublebubble {	Line 7272 sub scantron_validate_doublebubble {
return (0,$currentphase+1);	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'},
$env{'form.scantron.first_bubble_line.n'} and
$env{"form.scantron.sub_bubblelines.n"}
which are the total number of bubble, lines, the number of bubble
lines for response n and number of the first bubble line for response n,
and a comma separated list of numbers of bubble lines for sub-questions
(for optionresponse, matchresponse, and rankresponse items), for response n.

=cut

sub scantron_get_maxbubble {	sub scantron_get_maxbubble {
if (defined($env{'form.scantron_maxbubble'}) &&	if (defined($env{'form.scantron_maxbubble'}) &&
Line 7326 sub scantron_get_maxbubble {	Line 7289 sub scantron_get_maxbubble {

&Apache::lonxml::clear_problem_counter();	&Apache::lonxml::clear_problem_counter();

my $uname = $env{'form.student'};	my $uname = $env{'user.name'};
my $udom = $env{'form.userdom'};	my $udom = $env{'user.domain'};
my $cid = $env{'request.course.id'};	my $cid = $env{'request.course.id'};
my $total_lines = 0;	my $total_lines = 0;
%bubble_lines_per_response = ();	%bubble_lines_per_response = ();
%first_bubble_line = ();	%first_bubble_line = ();
%subdivided_bubble_lines = ();	%subdivided_bubble_lines = ();
%responsetype_per_response = ();	%responsetype_per_response = ();

my $response_number = 0;	my $response_number = 0;
my $bubble_line = 0;	my $bubble_line = 0;
foreach my $resource (@resources) {	foreach my $resource (@resources) {
my ($analysis,$parts) = &scantron_partids_tograde($resource,$cid,$uname,$udom);	my ($analysis,$parts) = &scantron_partids_tograde($resource,$cid,$uname,$udom);
if ((ref($analysis) eq 'HASH') && (ref($parts) eq 'ARRAY')) {	if ((ref($analysis) eq 'HASH') && (ref($parts) eq 'ARRAY')) {
foreach my $part_id (@{$parts}) {	foreach my $part_id (@{$parts}) {

my $lines;	my $lines;

# TODO - make this a persistent hash not an array.	# TODO - make this a persistent hash not an array.
Line 7402 sub scantron_get_maxbubble {	Line 7364 sub scantron_get_maxbubble {
return $env{'form.scantron_maxbubble'};	return $env{'form.scantron_maxbubble'};
}	}

sub scantron_partids_tograde {
my ($resource,$cid,$uname,$udom) = @_;
my (%analysis,@parts);

if (ref($resource)) {
my $symb = $resource->symb();
my $result=&ssi_with_retries($resource->src(), $ssi_retries,
('symb' => $symb,
'grade_target' => 'analyze',
'grade_courseid' => $cid,
'grade_domain' => $udom,
'grade_username' => $uname));
my (undef, $an) = split(/_HASH_REF__/,$result, 2);
%analysis = &Apache::lonnet::str2hash($an);

if (ref($analysis{'parts'}) eq 'ARRAY') {
foreach my $part (@{$analysis{'parts'}}) {
my ($id,$respid) = split(/\./,$part);
if (!&Apache::loncommon::check_if_partid_hidden($id,$symb,$udom,$uname)) {
push(@parts,$part);
}
}
}
}
return (\%analysis,\@parts);
}

=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 {	sub scantron_validate_missingbubbles {
my ($r,$currentphase) = @_;	my ($r,$currentphase) = @_;
#get student info	#get student info
Line 7492 sub scantron_validate_missingbubbles {	Line 7417 sub scantron_validate_missingbubbles {
return (0,$currentphase+1);	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 {	sub scantron_process_students {
my ($r) = @_;	my ($r) = @_;
Line 7533 sub scantron_process_students {	Line 7435 sub scantron_process_students {
my $navmap=Apache::lonnavmaps::navmap->new();	my $navmap=Apache::lonnavmaps::navmap->new();
my $map=$navmap->getResourceByUrl($sequence);	my $map=$navmap->getResourceByUrl($sequence);
my @resources=$navmap->retrieveResources($map,\&scantron_filter,1,0);	my @resources=$navmap->retrieveResources($map,\&scantron_filter,1,0);
	my (%grader_partids_by_symb,%grader_randomlists_by_symb);
my ($uname,$udom,%partids_by_symb);	&graders_resources_pass(\@resources,\%grader_partids_by_symb,
	\%grader_randomlists_by_symb);
foreach my $resource (@resources) {	foreach my $resource (@resources) {
my $ressymb = $resource->symb();	my $ressymb = $resource->symb();
my ($analysis,$parts) =	my ($analysis,$parts) =
&scantron_partids_tograde($resource,$env{'request.course.id'},$uname,$udom);	&scantron_partids_tograde($resource,$env{'request.course.id'},
$partids_by_symb{$ressymb} = $parts;	$env{'user.name'},$env{'user.domain'},1);
	$grader_partids_by_symb{$ressymb} = $parts;
	if (ref($analysis) eq 'HASH') {
	if (ref($analysis->{'parts_withrandomlist'}) eq 'ARRAY') {
	$grader_randomlists_by_symb{$ressymb} =
	$analysis->{'parts_withrandomlist'};
	}
	}
}	}
# $r->print("geto ".scalar(@resources)."<br />");
	my ($uname,$udom);
my $result= <<SCANTRONFORM;	my $result= <<SCANTRONFORM;
<form method="post" enctype="multipart/form-data" action="/adm/grades" name="scantronupload">	<form method="post" enctype="multipart/form-data" action="/adm/grades" name="scantronupload">
<input type="hidden" name="command" value="scantron_configphase" />	<input type="hidden" name="command" value="scantron_configphase" />
Line 7550 SCANTRONFORM	Line 7461 SCANTRONFORM
$r->print($result);	$r->print($result);

my @delayqueue;	my @delayqueue;
my (%completedstudents,,%scandata);	my (%completedstudents,%scandata);

my $lock=&Apache::lonnet::set_lock(&mt('Grading bubblesheet exam'));	my $lock=&Apache::lonnet::set_lock(&mt('Grading bubblesheet exam'));
my $count=&get_todo_count($scanlines,$scan_data);	my $count=&get_todo_count($scanlines,$scan_data);
Line 7565 SCANTRONFORM	Line 7476 SCANTRONFORM
my $started;	my $started;

&scantron_get_maxbubble(); # Need the bubble lines array to parse.	&scantron_get_maxbubble(); # Need the bubble lines array to parse.


# If an ssi failed in scantron_get_maxbubble, put an error message out to	# If an ssi failed in scantron_get_maxbubble, put an error message out to
# the user and return.	# the user and return.
Line 7606 SCANTRONFORM	Line 7516 SCANTRONFORM
}	}
($uname,$udom)=split(/:/,$uname);	($uname,$udom)=split(/:/,$uname);

	my %partids_by_symb;
	foreach my $resource (@resources) {
	my $ressymb = $resource->symb();
	if ((exists($grader_randomlists_by_symb{$ressymb})) \|\|
	(ref($grader_partids_by_symb{$ressymb}) ne 'ARRAY')) {
	my ($analysis,$parts) =
	&scantron_partids_tograde($resource,$env{'request.course.id'},$uname,$udom);
	$partids_by_symb{$ressymb} = $parts;
	} else {
	$partids_by_symb{$ressymb} = $grader_partids_by_symb{$ressymb};
	}
	}

&Apache::lonxml::clear_problem_counter();	&Apache::lonxml::clear_problem_counter();
&Apache::lonnet::appenv($scan_record);	&Apache::lonnet::appenv($scan_record);

if (&scantron_clear_skip($scanlines,$scan_data,$i)) {	if (&scantron_clear_skip($scanlines,$scan_data,$i)) {
&scantron_putfile($scanlines,$scan_data);	&scantron_putfile($scanlines,$scan_data);
}	}

my $scancode;	my $scancode;
if ((exists($scan_record->{'scantron.CODE'})) &&	if ((exists($scan_record->{'scantron.CODE'})) &&
(&Apache::lonnet::validCODE($scan_record->{'scantron.CODE'}))) {	(&Apache::lonnet::validCODE($scan_record->{'scantron.CODE'}))) {
Line 7622 SCANTRONFORM	Line 7545 SCANTRONFORM
}	}

if (&grade_student_bubbles($r,$uname,$udom,$scan_record,$scancode,	if (&grade_student_bubbles($r,$uname,$udom,$scan_record,$scancode,
@resources) eq 'ssi_error') {	\@resources,\%partids_by_symb) eq 'ssi_error') {
$ssi_error = 0; # So end of handler error message does not trigger.	$ssi_error = 0; # So end of handler error message does not trigger.
$r->print("</form>");	$r->print("</form>");
&ssi_print_error($r);	&ssi_print_error($r);
Line 7640 SCANTRONFORM	Line 7563 SCANTRONFORM
my $studentrecord = '';	my $studentrecord = '';
my $counter = -1;	my $counter = -1;
foreach my $resource (@resources) {	foreach my $resource (@resources) {
	my $ressymb = $resource->symb();
($counter,my $recording) =	($counter,my $recording) =
&verify_scantron_grading($resource,$udom,$uname,$env{'request.course.id'},	&verify_scantron_grading($resource,$udom,$uname,$env{'request.course.id'},
$counter,$studentdata,\%partids_by_symb,	$counter,$studentdata,$partids_by_symb{$ressymb},
\%scantron_config,\%lettdig,$numletts);	\%scantron_config,\%lettdig,$numletts);
$studentrecord .= $recording;	$studentrecord .= $recording;
}	}
if ($studentrecord ne $studentdata) {	if ($studentrecord ne $studentdata) {
&Apache::lonxml::clear_problem_counter();	&Apache::lonxml::clear_problem_counter();
if (&grade_student_bubbles($r,$uname,$udom,$scan_record,$scancode,	if (&grade_student_bubbles($r,$uname,$udom,$scan_record,$scancode,
\@resources) eq 'ssi_error') {	\@resources,\%partids_by_symb) eq 'ssi_error') {
$ssi_error = 0; # So end of handler error message does not trigger.	$ssi_error = 0; # So end of handler error message does not trigger.
$r->print("</form>");	$r->print("</form>");
&ssi_print_error($r);	&ssi_print_error($r);
Line 7661 SCANTRONFORM	Line 7585 SCANTRONFORM
$counter = -1;	$counter = -1;
$studentrecord = '';	$studentrecord = '';
foreach my $resource (@resources) {	foreach my $resource (@resources) {
	my $ressymb = $resource->symb();
($counter,my $recording) =	($counter,my $recording) =
&verify_scantron_grading($resource,$udom,$uname,$env{'request.course.id'},	&verify_scantron_grading($resource,$udom,$uname,$env{'request.course.id'},
$counter,$studentdata,\%partids_by_symb,	$counter,$studentdata,$partids_by_symb{$ressymb},
\%scantron_config,\%lettdig,$numletts);	\%scantron_config,\%lettdig,$numletts);
$studentrecord .= $recording;	$studentrecord .= $recording;
}	}
Line 7697 SCANTRONFORM	Line 7622 SCANTRONFORM
}	}
}	}
}	}
if (&Apache::loncommon::connection_aborted($r)) { last; }	if (&Apache::loncommon::connection_aborted($r)) { last; }
} continue {	} continue {
&Apache::lonxml::clear_problem_counter();	&Apache::lonxml::clear_problem_counter();
&Apache::lonnet::delenv('scantron.');	&Apache::lonnet::delenv('scantron.');
Line 7712 SCANTRONFORM	Line 7637 SCANTRONFORM
return '';	return '';
}	}

sub grade_student_bubbles {	sub graders_resources_pass {
my ($r,$uname,$udom,$scan_record,$scancode,@resources) = @_;	my ($resources,$grader_partids_by_symb,$grader_randomlists_by_symb) = @_;
foreach my $resource (@resources) {	if ((ref($resources) eq 'ARRAY') && (ref($grader_partids_by_symb)) &&
my %form = ('submitted' => 'scantron',	(ref($grader_randomlists_by_symb) eq 'HASH')) {
'grade_target' => 'grade',	foreach my $resource (@{$resources}) {
'grade_username'=> $uname,	my $ressymb = $resource->symb();
'grade_domain' => $udom,	my ($analysis,$parts) =
'grade_courseid'=> $env{'request.course.id'},	&scantron_partids_tograde($resource,$env{'request.course.id'},
'grade_symb' => $resource->symb(),	$env{'user.name'},$env{'user.domain'},1);
'CODE' => $scancode);	$grader_partids_by_symb->{$ressymb} = $parts;
my $result=&ssi_with_retries($resource->src(),$ssi_retries,%form);	if (ref($analysis) eq 'HASH') {
return 'ssi_error' if ($ssi_error);	if (ref($analysis->{'parts_withrandomlist'}) eq 'ARRAY') {
last if (&Apache::loncommon::connection_aborted($r));	$grader_randomlists_by_symb->{$ressymb} =
	$analysis->{'parts_withrandomlist'};
	}
	}
	}
}	}
return;	return;
}	}

=pod	sub grade_student_bubbles {
	my ($r,$uname,$udom,$scan_record,$scancode,$resources,$parts) = @_;
=item scantron_upload_scantron_data	if (ref($resources) eq 'ARRAY') {
	my $count = 0;
Creates the screen for adding a new bubble sheet data file to a course.	foreach my $resource (@{$resources}) {
	my $ressymb = $resource->symb();
=cut	my %form = ('submitted' => 'scantron',
	'grade_target' => 'grade',
	'grade_username' => $uname,
	'grade_domain' => $udom,
	'grade_courseid' => $env{'request.course.id'},
	'grade_symb' => $ressymb,
	'CODE' => $scancode
	);
	if (ref($parts) eq 'HASH') {
	if (ref($parts->{$ressymb}) eq 'ARRAY') {
	foreach my $part (@{$parts->{$ressymb}}) {
	$form{'scantron_questnum_start.'.$part} =
	1+$env{'form.scantron.first_bubble_line.'.$count};
	$count++;
	}
	}
	}
	my $result=&ssi_with_retries($resource->src(),$ssi_retries,%form);
	return 'ssi_error' if ($ssi_error);
	last if (&Apache::loncommon::connection_aborted($r));
	}
	}
	return;
	}

sub scantron_upload_scantron_data {	sub scantron_upload_scantron_data {
my ($r)=@_;	my ($r)=@_;
Line 7777 sub scantron_upload_scantron_data {	Line 7729 sub scantron_upload_scantron_data {
return '';	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 {	sub scantron_upload_scantron_data_save {
my($r)=@_;	my($r)=@_;
Line 7846 sub scantron_upload_scantron_data_save {	Line 7790 sub scantron_upload_scantron_data_save {
return '';	return '';
}	}

=pod

=item valid_file

Validates that the requested bubble data file exists in the course.

=cut

sub valid_file {	sub valid_file {
my ($requested_file)=@_;	my ($requested_file)=@_;
foreach my $filename (sort(&scantron_filenames())) {	foreach my $filename (sort(&scantron_filenames())) {
Line 7862 sub valid_file {	Line 7798 sub valid_file {
return 0;	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 {	sub scantron_download_scantron_data {
my ($r)=@_;	my ($r)=@_;
my $default_form_data=&defaultFormData(&get_symb($r,1));	my $default_form_data=&defaultFormData(&get_symb($r,1));
Line 7930 sub checkscantron_results {	Line 7856 sub checkscantron_results {
my %idmap=&Apache::grades::username_to_idmap($classlist);	my %idmap=&Apache::grades::username_to_idmap($classlist);
my $navmap=Apache::lonnavmaps::navmap->new();	my $navmap=Apache::lonnavmaps::navmap->new();
my $map=$navmap->getResourceByUrl($sequence);	my $map=$navmap->getResourceByUrl($sequence);
my @resources=$navmap->retrieveResources($map,undef,1,0);	my @resources=$navmap->retrieveResources($map,\&scantron_filter,1,0);
my ($uname,$udom,%partids_by_symb);	my (%grader_partids_by_symb,%grader_randomlists_by_symb);
foreach my $resource (@resources) {	&graders_resources_pass(\@resources,\%grader_partids_by_symb, \%grader_randomlists_by_symb);
my $ressymb = $resource->symb();
my ($analysis,$parts) =	my ($uname,$udom);
&scantron_partids_tograde($resource,$env{'request.course.id'},$uname,$udom);
$partids_by_symb{$ressymb} = $parts;
}
my (%scandata,%lastname,%bylast);	my (%scandata,%lastname,%bylast);
$r->print('	$r->print('
<form method="post" enctype="multipart/form-data" action="/adm/grades" name="checkscantron">'."\n");	<form method="post" enctype="multipart/form-data" action="/adm/grades" name="checkscantron">'."\n");
Line 7951 sub checkscantron_results {	Line 7874 sub checkscantron_results {
'inline',undef,'checkscantron');	'inline',undef,'checkscantron');
my ($username,$domain,$started);	my ($username,$domain,$started);

&Apache::grades::scantron_get_maxbubble(); # Need the bubble lines array to parse.	&scantron_get_maxbubble(); # Need the bubble lines array to parse.

&Apache::lonhtmlcommon::Update_PrgWin($r,\%prog_state,	&Apache::lonhtmlcommon::Update_PrgWin($r,\%prog_state,
'Processing first student');	'Processing first student');
Line 7992 sub checkscantron_results {	Line 7915 sub checkscantron_results {
($username,$domain)=split(/:/,$uname);	($username,$domain)=split(/:/,$uname);
my $counter = -1;	my $counter = -1;
foreach my $resource (@resources) {	foreach my $resource (@resources) {
	my $parts;
	my $ressymb = $resource->symb();
	if ((exists($grader_randomlists_by_symb{$ressymb})) \|\|
	(ref($grader_partids_by_symb{$ressymb}) ne 'ARRAY')) {
	(my $analysis,$parts) =
	&scantron_partids_tograde($resource,$env{'request.course.id'},$username,$domain);
	} else {
	$parts = $grader_partids_by_symb{$ressymb};
	}
($counter,my $recording) =	($counter,my $recording) =
&verify_scantron_grading($resource,$domain,$username,$cid,$counter,	&verify_scantron_grading($resource,$domain,$username,$cid,$counter,
$scandata{$pid},\%partids_by_symb,	$scandata{$pid},$parts,
\%scantron_config,\%lettdig,$numletts);	\%scantron_config,\%lettdig,$numletts);
$record{$pid} .= $recording;	$record{$pid} .= $recording;
}	}
Line 8059 sub checkscantron_results {	Line 7991 sub checkscantron_results {
}	}

sub verify_scantron_grading {	sub verify_scantron_grading {
my ($resource,$domain,$username,$cid,$counter,$scandata,$partids_by_symb,	my ($resource,$domain,$username,$cid,$counter,$scandata,$partids,
$scantron_config,$lettdig,$numletts) = @_;	$scantron_config,$lettdig,$numletts) = @_;
my ($record,%expected,%startpos);	my ($record,%expected,%startpos);
return ($counter,$record) if (!ref($resource));	return ($counter,$record) if (!ref($resource));
return ($counter,$record) if (!$resource->is_problem());	return ($counter,$record) if (!$resource->is_problem());
my $symb = $resource->symb();	my $symb = $resource->symb();
return ($counter,$record) if (ref($partids_by_symb) ne 'HASH');	return ($counter,$record) if (ref($partids) ne 'ARRAY');
return ($counter,$record) if (ref($partids_by_symb->{$symb}) ne 'ARRAY');	foreach my $part_id (@{$partids}) {
foreach my $part_id (@{$partids_by_symb->{$symb}}) {
$counter ++;	$counter ++;
$expected{$part_id} = 0;	$expected{$part_id} = 0;
if ($env{"form.scantron.sub_bubblelines.$counter"}) {	if ($env{"form.scantron.sub_bubblelines.$counter"}) {
Line 8160 sub verify_scantron_grading {	Line 8091 sub verify_scantron_grading {
}	}
}	}
}	}
foreach my $part_id (@{$partids_by_symb->{$symb}}) {	foreach my $part_id (@{$partids}) {
if ($recorded{$part_id} eq '') {	if ($recorded{$part_id} eq '') {
for (my $i=0; $i<$expected{$part_id}; $i++) {	for (my $i=0; $i<$expected{$part_id}; $i++) {
for (my $j=0; $j<$scantron_config->{'Qlength'}; $j++) {	for (my $j=0; $j<$scantron_config->{'Qlength'}; $j++) {
Line 8174 sub verify_scantron_grading {	Line 8105 sub verify_scantron_grading {
return ($counter,$record);	return ($counter,$record);
}	}

sub letter_to_digits {	sub letter_to_digits {
my %lettdig = (	my %lettdig = (
A => 1,	A => 1,
B => 2,	B => 2,
Line 8190 sub letter_to_digits {	Line 8121 sub letter_to_digits {
return %lettdig;	return %lettdig;
}	}

=pod

=back

=cut

#-------- end of section for handling grading scantron forms -------	#-------- end of section for handling grading scantron forms -------
#	#
Line 8241 sub grading_menu {	Line 8167 sub grading_menu {
'saveState'=>"",	'saveState'=>"",
'gradingMenu'=>1,	'gradingMenu'=>1,
'showgrading'=>"yes");	'showgrading'=>"yes");
my $url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
my @menu = ({ url => $url,	my $url1 = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
name => &mt('Manual Grading/View Submissions'),
short_description =>
&mt('Start the process of hand grading submissions.'),
});
$fields{'command'} = 'csvform';	$fields{'command'} = 'csvform';
$url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);	my $url2 = &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';	$fields{'command'} = 'processclicker';
$url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);	my $url3 = &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';	$fields{'command'} = 'scantron_selectphase';
$url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);	my $url4 = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
push(@menu, { url => $url,
name => &mt('Grade/Manage/Review Scantron Forms'),	my @menu = ({ categorytitle=>'Course Grading',
short_description =>	items =>[
&mt('Grade scantron exams, upload/download scantron data files, and review previously graded scantron exams.')});	{ linktext => 'Manual Grading/View Submissions',
$fields{'command'} = 'verify';	url => $url1,
$url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);	permission => 'F',
push(@menu, { url => "",	icon => 'edit-find-replace.png',
name => &mt('Verify Receipt'),	linktitle => 'Start the process of hand grading submissions.'
short_description =>	},
&mt('')});	{ linktext => 'Upload Scores',
	url => $url2,
	permission => 'F',
	icon => 'uploadscores.png',
	linktitle => 'Specify a file containing the class scores for current resource.'
	},
	{ linktext => 'Process Clicker',
	url => $url3,
	permission => 'F',
	icon => 'addClickerInfoFile.png',
	linktitle => 'Specify a file containing the clicker information for this resource.'
	},
	{ linktext => 'Grade/Manage/Review Scantron Forms',
	url => $url4,
	permission => 'F',
	icon => 'stat.png',
	linktitle => 'Grade scantron exams, upload/download scantron data files, and review previously graded scantron exams.'
	}
	]
	});

	#$fields{'command'} = 'verify';
	#$url = &Apache::lonhtmlcommon::build_url('grades/',\%fields);
#	#
# Create the menu	# Create the menu
my $Str;	my $Str;
Line 8284 sub grading_menu {	Line 8223 sub grading_menu {
'<input type="hidden" name="gradingMenu" value="1" />'."\n".	'<input type="hidden" name="gradingMenu" value="1" />'."\n".
'<input type="hidden" name="showgrading" value="yes" />'."\n";	'<input type="hidden" name="showgrading" value="yes" />'."\n";

foreach my $menudata (@menu) {	$Str .= Apache::lonhtmlcommon::generate_menu(@menu);
if ($menudata->{'name'} ne &mt('Verify Receipt')) {	#$menudata->{'jscript'}
$Str .=' <h3><a '.	$Str .='<hr /><input type="button" value="'.&mt('Verify Receipt').'" '.
$menudata->{'jscript'}.	' onClick="javascript:checkChoice(document.forms.gradingMenu,\'5\',\'verify\')" '.
' href="'.	' /> '.
$menudata->{'url'}.'" >'.	&Apache::lonnet::recprefix($env{'request.course.id'}).
$menudata->{'name'}."</a></h3>\n";	'-<input type="text" name="receipt" size="4" onChange="javascript:checkReceiptNo(this.form,\'OK\')" />';
} else {
$Str .='<hr /><input type="button" value="'.&mt('Verify Receipt').'" '.
$menudata->{'jscript'}.
' onClick="javascript:checkChoice(document.forms.gradingMenu,\'5\',\'verify\')" '.
' /> '.
&Apache::lonnet::recprefix($env{'request.course.id'}).
'-<input type="text" name="receipt" size="4" onChange="javascript:checkReceiptNo(this.form,\'OK\')" />';
}
$Str .= ' '.(' 'x8).$menudata->{'short_description'}.
"\n";
}
$Str .="</form>\n";	$Str .="</form>\n";
my $receiptalert = &mt("Please enter a receipt number given by a student in the receipt box.");	my $receiptalert = &mt("Please enter a receipt number given by a student in the receipt box.");
$request->print(<<GRADINGMENUJS);	$request->print(<<GRADINGMENUJS);
Line 8331 sub grading_menu {	Line 8260 sub grading_menu {
if (nospace == "OK" && isNaN(receiptNo)) {checkOpt = true;}	if (nospace == "OK" && isNaN(receiptNo)) {checkOpt = true;}
if (nospace == "notOK" && (isNaN(receiptNo) \|\| receiptNo == "")) {checkOpt = true;}	if (nospace == "notOK" && (isNaN(receiptNo) \|\| receiptNo == "")) {checkOpt = true;}
if (checkOpt) {	if (checkOpt) {
alert("$receiptalert$receiptalert");	alert("$receiptalert");
formname.receipt.value = "";	formname.receipt.value = "";
formname.receipt.focus();	formname.receipt.focus();
return false;	return false;
Line 8399 GRADINGMENUJS	Line 8328 GRADINGMENUJS
my $saveSub = ($$savedState{'saveSub'} eq '' ? 'all' : $$savedState{'saveSub'});	my $saveSub = ($$savedState{'saveSub'} eq '' ? 'all' : $$savedState{'saveSub'});
my $saveStatus = ($$savedState{'saveStatus'} eq '' ? 'Active' : $$savedState{'saveStatus'});	my $saveStatus = ($$savedState{'saveStatus'} eq '' ? 'Active' : $$savedState{'saveStatus'});

	# Preselect sections
	my $selsec="";
	if (ref($sections)) {
	foreach my $section (sort(@$sections)) {
	$selsec.='<option value="'.$section.'" '.
	($saveSec eq $section ? 'selected="selected"':'').'>'.$section.'</option>'."\n";
	}
	}

$result.='<form action="/adm/grades" method="post" name="gradingMenu">'."\n".	$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="symb" value="'.&Apache::lonenc::check_encrypt($symb).'" />'."\n".
'<input type="hidden" name="handgrade" value="'.$hdgrade.'" />'."\n".	'<input type="hidden" name="handgrade" value="'.$hdgrade.'" />'."\n".
Line 8409 GRADINGMENUJS	Line 8347 GRADINGMENUJS
'<input type="hidden" name="showgrading" value="yes" />'."\n";	'<input type="hidden" name="showgrading" value="yes" />'."\n";

$result.='	$result.='
<div class="LC_grade_select_mode">	<h2>
<div class="LC_grade_select_mode_current">	'.&mt('Grade Current Resource').'
<h2>	</h2>
'.&mt('Grade Current Resource').'	<div>
</h2>	'.$table.'
<div class="LC_grade_select_mode_body">	</div>
<div class="LC_grades_resource_info">
'.$table.'	<div class="LC_columnSection">
</div>
<div class="LC_grade_select_mode_selector">	<fieldset>
<div class="LC_grade_select_mode_selector_header">	<legend>
'.&mt('Sections').'	'.&mt('Sections').'
</div>	</legend>
<div class="LC_grade_select_mode_selector_body">	<select name="section" multiple="multiple" size="5">'."\n";
<select name="section" multiple="multiple" size="5">'."\n";	$result.= $selsec;
if (ref($sections)) {
foreach my $section (sort(@$sections)) {
$result.='<option value="'.$section.'" '.
($saveSec eq $section ? 'selected="selected"':'').'>'.$section.'</option>'."\n";
}
}
$result.= '<option value="all" '.($saveSec eq 'all' ? 'selected="selected"' : ''). '>all</option></select>   ';	$result.= '<option value="all" '.($saveSec eq 'all' ? 'selected="selected"' : ''). '>all</option></select>   ';
$result.='	$result.='
</div>	</fieldset>
</div>
<div class="LC_grade_select_mode_selector">	<fieldset>
<div class="LC_grade_select_mode_selector_header">	<legend>
'.&mt('Groups').'	'.&mt('Groups').'
</div>	</legend>
<div class="LC_grade_select_mode_selector_body">	'.&Apache::lonstatistics::GroupSelect('group','multiple',5).'
'.&Apache::lonstatistics::GroupSelect('group','multiple',5).'	</fieldset>
</div>
</div>	<fieldset>
<div class="LC_grade_select_mode_selector">	<legend>
<div class="LC_grade_select_mode_selector_header">	'.&mt('Access Status').'
'.&mt('Access Status').'	</legend>
</div>	'.&Apache::lonhtmlcommon::StatusOptions($saveStatus,undef,5,undef,'mult').'
<div class="LC_grade_select_mode_selector_body">	</fieldset>
'.&Apache::lonhtmlcommon::StatusOptions($saveStatus,undef,5,undef,'mult').'
</div>	<fieldset>
</div>	<legend>
<div class="LC_grade_select_mode_selector">	'.&mt('Submission Status').'
<div class="LC_grade_select_mode_selector_header">	</legend>
'.&mt('Submission Status').'	<select name="submitonly" size="5">
</div>
<div class="LC_grade_select_mode_selector_body">
<select name="submitonly" size="5">
<option value="yes" '. ($saveSub eq 'yes' ? 'selected="selected"' : '').'>'.&mt('with submissions').'</option>	<option value="yes" '. ($saveSub eq 'yes' ? 'selected="selected"' : '').'>'.&mt('with submissions').'</option>
<option value="queued" '. ($saveSub eq 'queued' ? 'selected="selected"' : '').'>'.&mt('in grading queue').'</option>	<option value="queued" '. ($saveSub eq 'queued' ? 'selected="selected"' : '').'>'.&mt('in grading queue').'</option>
<option value="graded" '. ($saveSub eq 'graded' ? 'selected="selected"' : '').'>'.&mt('with ungraded submissions').'</option>	<option value="graded" '. ($saveSub eq 'graded' ? 'selected="selected"' : '').'>'.&mt('with ungraded submissions').'</option>
<option value="incorrect" '.($saveSub eq 'incorrect' ? 'selected="selected"' : '').'>'.&mt('with incorrect submissions').'</option>	<option value="incorrect" '.($saveSub eq 'incorrect' ? 'selected="selected"' : '').'>'.&mt('with incorrect submissions').'</option>
<option value="all" '. ($saveSub eq 'all' ? 'selected="selected"' : '').'>'.&mt('with any status').'</option>	<option value="all" '. ($saveSub eq 'all' ? 'selected="selected"' : '').'>'.&mt('with any status').'</option>
</select>	</select>
</div>	</fieldset>
</div>
<div class="LC_grade_select_mode_type_body">	</div>
<div class="LC_grade_select_mode_type">
	<br />
	<div>
	<div>
<label>	<label>
<input type="radio" name="radioChoice" value="submission" '.	<input type="radio" name="radioChoice" value="submission" '.
($saveCmd eq 'submission' ? 'checked="checked"' : '').' /> '.	($saveCmd eq 'submission' ? 'checked="checked"' : '').' /> '.
&mt('Select individual students to grade and view submissions.').'	&mt('Select individual students to grade and view submissions.').'
</label>	</label>
</div>	</div>
<div class="LC_grade_select_mode_type">	<div>
<label>	<label>
<input type="radio" name="radioChoice" value="viewgrades" '.	<input type="radio" name="radioChoice" value="viewgrades" '.
($saveCmd eq 'viewgrades' ? 'checked="checked"' : '').' /> '.	($saveCmd eq 'viewgrades' ? 'checked="checked"' : '').' /> '.
&mt('Grade all selected students in a grading table.').'	&mt('Grade all selected students in a grading table.').'
</label>	</label>
</div>	</div>
<div class="LC_grade_select_mode_type">	<div>
<input type="button" onClick="javascript:checkChoice(this.form,\'2\');" value="'.&mt('Next').' →" />	<input type="button" onClick="javascript:checkChoice(this.form,\'2\');" value="'.&mt('Next').' →" />
</div>	</div>
</div>	</div>
</div>
</div>
<div class="LC_grade_select_mode_page">
<h2>	<h2>
'.&mt('Grade Complete Folder for One Student').'	'.&mt('Grade Complete Folder for One Student').'
</h2>	</h2>
<div class="LC_grades_select_mode_body">	<div>
<div class="LC_grade_select_mode_type_body">	<div>
<div class="LC_grade_select_mode_type">
<label>	<label>
<input type="radio" name="radioChoice" value="pickStudentPage" '.	<input type="radio" name="radioChoice" value="pickStudentPage" '.
($saveCmd eq 'pickStudentPage' ? 'checked="checked"' : '').' /> '.	($saveCmd eq 'pickStudentPage' ? 'checked="checked"' : '').' /> '.
&mt('The <b>complete</b> page/sequence/folder: For one student').'	&mt('The <b>complete</b> page/sequence/folder: For one student').'
</label>	</label>
</div>	</div>
<div class="LC_grade_select_mode_type">	<div>
<input type="button" onClick="javascript:checkChoice(this.form,\'2\');" value="'.&mt('Next').' →" />	<input type="button" onClick="javascript:checkChoice(this.form,\'2\');" value="'.&mt('Next').' →" />
</div>	</div>
</div>
</div>	</div>
</div>
</div>
</form>';	</form>';
$result .= &show_grading_menu_form($symb);	$result .= &show_grading_menu_form($symb);
return $result;	return $result;
Line 8604 sub process_clicker {	Line 8531 sub process_clicker {
$result.='<br /><table width="100%" border="0"><tr><td bgcolor="#777777">'."\n";	$result.='<br /><table width="100%" border="0"><tr><td bgcolor="#777777">'."\n";
$result.='<table width="100%" border="0"><tr bgcolor="#e6ffff"><td>'."\n";	$result.='<table width="100%" border="0"><tr bgcolor="#e6ffff"><td>'."\n";
$result.=' <b>'.&mt('Specify a file containing the clicker information for this resource.').	$result.=' <b>'.&mt('Specify a file containing the clicker information for this resource.').
'.</b></td></tr>'."\n";	'</b></td></tr>'."\n";
$result.='<tr bgcolor=#ffffe6><td>'."\n";	$result.='<tr bgcolor=#ffffe6><td>'."\n";
# Attempt to restore parameters from last session, set defaults if not present	# Attempt to restore parameters from last session, set defaults if not present
my %Saveable_Parameters=&clicker_grading_parameters();	my %Saveable_Parameters=&clicker_grading_parameters();
Line 9065 sub handler {	Line 8992 sub handler {
}	}

$ssi_error = 0;	$ssi_error = 0;
$request->print(&Apache::loncommon::start_page('Grading'));	my $brcrum = [{href=>"/adm/grades",text=>"Grading"}];
	$request->print(&Apache::loncommon::start_page('Grading',undef,
	{'bread_crumbs' => $brcrum}));
if ($symb eq '' && $command eq '') {	if ($symb eq '' && $command eq '') {
if ($env{'user.adv'}) {	if ($env{'user.adv'}) {
if (($env{'form.codeone'}) && ($env{'form.codetwo'}) &&	if (($env{'form.codeone'}) && ($env{'form.codetwo'}) &&
Line 9177 sub handler {	Line 9106 sub handler {
1;	1;

__END__;	__END__;


	=head1 NAME

	Apache::grades

	=head1 SYNOPSIS

	Handles the viewing of grades.

	This is part of the LearningOnline Network with CAPA project
	described at http://www.lon-capa.org.

	=head1 OVERVIEW

	Do an ssi with retries:
	While I'd love to factor out this with the vesrion in lonprintout,
	that would either require a data coupling between modules, which I refuse to perpetuate (there's quite enough of that already), or would require the invention of another infrastructure
	I'm not quite ready to invent (e.g. an ssi_with_retry object).

	At least the logic that drives this has been pulled out into loncommon.



	ssi_with_retries - Does the server side include of a resource.
	if the ssi call returns an error we'll retry it up to
	the number of times requested by the caller.
	If we still have a proble, no text is appended to the
	output and we set some global variables.
	to indicate to the caller an SSI error occurred.
	All of this is supposed to deal with the issues described
	in LonCAPA BZ 5631 see:
	http://bugs.lon-capa.org/show_bug.cgi?id=5631
	by informing the user that this happened.

	Parameters:
	resource - The resource to include. This is passed directly, without
	interpretation to lonnet::ssi.
	form - The form hash parameters that guide the interpretation of the resource

	retries - Number of retries allowed before giving up completely.
	Returns:
	On success, returns the rendered resource identified by the resource parameter.
	Side Effects:
	The following global variables can be set:
	ssi_error - If an unrecoverable error occurred this becomes true.
	It is up to the caller to initialize this to false
	if desired.
	ssi_error_resource - If an unrecoverable error occurred, this is the value
	of the resource that could not be rendered by the ssi
	call.
	ssi_error_message - The error string fetched from the ssi response
	in the event of an error.


	=head1 HANDLER SUBROUTINE

	ssi_with_retries()

	=head1 SUBROUTINES

	=over

	=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

	=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'},
	$env{'form.scantron.first_bubble_line.n'} and
	$env{"form.scantron.sub_bubblelines.n"}
	which are the total number of bubble, lines, the number of bubble
	lines for response n and number of the first bubble line for response n,
	and a comma separated list of numbers of bubble lines for sub-questions
	(for optionresponse, matchresponse, and rankresponse items), for response n.


	=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.

	=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.

	=item scantron_upload_scantron_data() :

	Creates the screen for adding a new bubble sheet data file to a course.

	=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.

	=item valid_file() :

	Validates that the requested bubble data file exists in the course.

	=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.

	=item scantron_validate_ID() :

	Validates all scanlines in the selected file to not have any
	invalid or underspecified student/employee IDs

	=back

	=cut

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

Removed from v.1.528.2.12
changed lines
	Added in v.1.560