Annotation of loncom/interface/lonpdfupload.pm, revision 1.22

1.1       onken       1: # The LearningOnline Network with CAPA
1.12      bisitz      2: # PDF Form Upload Handler
1.1       onken       3: #
1.22    ! golterma    4: # $Id: lonpdfupload.pm,v 1.21 2011/11/02 15:14:21 bisitz Exp $
1.1       onken       5: #
                      6: # Copyright Michigan State University Board of Trustees
                      7: #
                      8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      9: #
                     10: # LON-CAPA is free software; you can redistribute it and/or modify
                     11: # it under the terms of the GNU General Public License as published by
                     12: # the Free Software Foundation; either version 2 of the License, or
                     13: # (at your option) any later version.
                     14: #
                     15: # LON-CAPA is distributed in the hope that it will be useful,
                     16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     18: # GNU General Public License for more details.
                     19: #
                     20: # You should have received a copy of the GNU General Public License
                     21: # along with LON-CAPA; if not, write to the Free Software
                     22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     23: #
                     24: # /home/httpd/html/adm/gpl.txt
                     25: #
                     26: # http://www.lon-capa.org/
                     27: #
                     28: package Apache::lonpdfupload;
                     29: 
                     30: use lib '/home/httpd/lib/perl';
                     31: use Apache::Constants qw(:common :http);
1.15      raeburn    32: use Apache::lonnet;
1.1       onken      33: use Apache::lonhtmlcommon();
                     34: use Apache::loncommon();
1.18      raeburn    35: use Apache::lonnavmaps();
1.1       onken      36: use Apache::lonlocal;
1.16      raeburn    37: use File::MMagic;
1.2       onken      38: use CAM::PDF;
1.18      raeburn    39: use LONCAPA qw(:DEFAULT :match);
1.1       onken      40: 
                     41: use strict;
                     42: 
                     43: sub handler() {
1.2       onken      44:     my $r = shift;
1.15      raeburn    45:     &Apache::loncommon::content_type($r,'text/html');
                     46:     $r->send_http_header;
                     47:     return OK if $r->header_only;
1.13      bisitz     48: 
1.16      raeburn    49:     #  Needs to be in a course
                     50:     if (!$env{'request.course.fn'}) {
                     51:         # Not in a course
                     52:         $env{'user.error.msg'}="/adm/pdfupload:bre:0:0:Cannot upload PDF forms unless in a course";
                     53:         return HTTP_NOT_ACCEPTABLE;
                     54:     }
                     55: 
1.13      bisitz     56:     # Breadcrumbs
1.15      raeburn    57:     my $brcrum = [{'href' => '/adm/pdfupload',
1.13      bisitz     58:                    'text' => 'Upload PDF Form'}];
1.16      raeburn    59:     if ($env{'form.Uploaded'} && $env{'form.file'}) {
                     60:         push(@{$brcrum},{'href'  => '',
                     61:                          'text'  => 'PDF upload result'});
                     62:     }
1.13      bisitz     63: 
                     64:     $r->print(&Apache::loncommon::start_page('Upload PDF Form',
                     65:                                              undef,
                     66:                                              {'bread_crumbs' => $brcrum,})
                     67:     );
1.2       onken      68: 
1.16      raeburn    69:     if ($env{'request.course.id'}) {
                     70:         my $permission = $env{'course.'.$env{'request.course.id'}.'.canuse_pdfforms'};
                     71:         if ($permission eq '') {
                     72:             my %domdefs = &Apache::lonnet::get_domain_defaults($env{'course.'.$env{'request.course.id'}.'.domain'});
                     73:             $permission = $domdefs{'canuse_pdfforms'};
                     74:         }
                     75:         unless ($permission) {
                     76:             $r->print('<p class="LC_warning">'.
                     77:                       &mt('Upload of PDF forms is not permitted for this course.').
                     78:                       '</p>'.
                     79:                       &Apache::loncommon::end_page());
                     80:             return OK;
                     81:         }
                     82:     } else {
                     83:         $r->print('<p class="LC_warning">'.
1.18      raeburn    84:                   &mt('Could not determine identity of this course.').' '.
                     85:                   &mt('You may need to [_1]re-select[_2] the course.','<a href="/adm/roles">','</a>').
1.16      raeburn    86:                   '</p>'.
                     87:                   &Apache::loncommon::end_page());
                     88:         return OK;
                     89:     }
                     90: 
1.2       onken      91:     # if a file was upload
                     92:     if($env{'form.Uploaded'} && $env{'form.file'}) {
1.16      raeburn    93:         my $mm = new File::MMagic;
                     94:         my $mime_type = $mm->checktype_contents($env{'form.file'});
                     95:         if ($mime_type eq 'application/pdf') {
                     96:             $r->print(&processPDF);
                     97:         } else {
                     98:             $r->print('<p class="LC_error">'
                     99:                      .&mt("The uploaded file does not appear to be a PDF file.")
                    100:                      .'</p>');
                    101:         }
1.2       onken     102:     } else { 
                    103:         # print upload form
                    104:         $r->print(&get_javascripts);
                    105:         $r->print(&get_uploadform);
                    106:     }
                    107: 
                    108:     #link to course-content
1.6       bisitz    109:     $r->print('<hr />'
                    110:              .'<p>'."\n"
1.5       bisitz    111:              .'<a href="/adm/navmaps">'."\n"
1.14      raeburn   112:              .&mt('Course Contents')."\n"
1.5       bisitz    113:              .'</a>'."\n"
                    114:              .'</p>'."\n"
                    115:     );
1.1       onken     116: 
1.2       onken     117:     #&dumpenv($r); #debug -> prints the environment
1.7       onken     118:     $r->print(&Apache::loncommon::end_page());
1.1       onken     119:     return OK;
1.2       onken     120: }
1.1       onken     121: 
                    122: sub get_javascripts() {
1.2       onken     123:     
1.6       bisitz    124:     my $message = &mt('Please choose a PDF-File.');
1.1       onken     125: 
1.2       onken     126:     # simple test if the upload ends with ".pdf"
                    127:     # it's only for giving a message to the user
                    128:     my $result .= <<END
                    129:   <script type="text/javascript">
1.18      raeburn   130: // <![CDATA[
1.1       onken     131:     function checkFilename(form) {
                    132:         var fileExt = form.file.value;
1.21      bisitz    133:         fileExt = fileExt.match(/[.]pdf\$/gi);
1.1       onken     134:         if(fileExt) {
                    135:             return true;
                    136:         }
1.2       onken     137:         alert("$message");
1.1       onken     138:         return false;
                    139:     }
1.18      raeburn   140: // ]]>
1.2       onken     141:   </script>
1.1       onken     142: END
                    143: ;
                    144:     return $result; 
                    145: }
                    146: 
1.2       onken     147: 
1.1       onken     148: sub get_uploadform() {
1.4       onken     149:     
                    150:     my %lt = &Apache::lonlocal::texthash(
1.6       bisitz    151:                  'title'  => 'Upload a PDF Form with filled Form Fields', 
                    152:                  'chFile' => 'File',
                    153:                  'submit' => 'Upload',
1.4       onken     154:              );
                    155: 
1.5       bisitz    156:     my $result = 
                    157:         '<br />'
1.18      raeburn   158:        .'<form method="post" enctype="multipart/form-data" onsubmit="return checkFilename(this);" action="">'
1.5       bisitz    159:        .&Apache::lonhtmlcommon::start_pick_box()
                    160:        .&Apache::lonhtmlcommon::row_headline()
                    161:        .'<h2>'.$lt{'title'}.'</h2>'
                    162:        .&Apache::lonhtmlcommon::row_closure()
                    163:        .&Apache::lonhtmlcommon::row_title($lt{'chFile'})
                    164:        .'<input type="file" name="file" id="filename" />'
                    165:        .&Apache::lonhtmlcommon::row_closure(1)
                    166:        .&Apache::lonhtmlcommon::end_pick_box()
1.13      bisitz    167:        .'<p>'
1.5       bisitz    168:        .'<input type="submit" name="Uploaded" value="'.$lt{'submit'}.'" />'
1.13      bisitz    169:        .'</p>'
1.5       bisitz    170:        .'</form>'
1.6       bisitz    171:        .'<br />';
1.5       bisitz    172: 
1.1       onken     173:   return $result;
                    174: }
                    175: 
                    176: sub processPDF {
1.2       onken     177:     my $result = ();  # message for Browser
                    178:     my @pdfdata = (); # answers from PDF-Forms
1.1       onken     179:     
1.2       onken     180:     @pdfdata = &get_pdf_data(); # get answers from PDF-Form
1.1       onken     181:     
                    182:     if (scalar @pdfdata) {    
1.2       onken     183:         &grade_pdf(@pdfdata);
1.1       onken     184:     } else {
1.6       bisitz    185:         $result .= '<p class="LC_error">'
                    186:                   .&mt("Can't find any valid PDF formfields.")
                    187:                   .'</p>';
1.1       onken     188:     }
                    189: }
                    190: 
                    191: sub get_pdf_data() {
                    192:     my @data = ();
1.2       onken     193:     my $pdf = CAM::PDF->new($env{'form.file'});
                    194: 
1.19      onken     195:     if($pdf) {
                    196:         my @formFields = $pdf->getFormFieldList(); #get names of formfields
                    197: 
                    198:         foreach my $field (@formFields) {
                    199:             my $dict = $pdf->getFormFieldDict($pdf->getFormField($field)); # get formfield dictonary
1.1       onken     200: 
1.19      onken     201:             # this is necessary because CAM::PDF has a problem with formfieldnames which include a
                    202:             # dot in fieldnames. So a fieldname like "i.am.aFormfield" will offer three fieldnames
                    203:             # "i", "i.am" and "i.am.aFormfield". The fragmentary names keep no values and will be ignored.
                    204:             if($dict->{'V'}) {
                    205:                 push(@data, $field."?". $dict->{'V'}{'value'}); #binding fieldname with value
                    206:             }
1.2       onken     207:         }
1.19      onken     208:     }
1.1       onken     209:     return @data;
                    210: }
                    211: 
                    212: sub grade_pdf {
                    213:     my @pdfdata = @_;
1.18      raeburn   214:     my ($result,$meta,%grades,%problems,%foreigncourse,$debug);
                    215: 
                    216:     my $navmap = Apache::lonnavmaps::navmap->new();
                    217:     if (!defined($navmap)) {
                    218:         $result = '<h3>'.&mt('Verification of PDF form items failed').'</h3>'.
                    219:                   '<div class="LC_error">'.
                    220:                   &mt('Unable to retrieve information about course contents').' '.
                    221:                   &mt('You may need to [_1]re-select[_2] the course.','<a href="/adm/roles">','</a>').
                    222:                   '</div>';
                    223:         return $result;
                    224:     }
                    225:     my %restitles;
                    226:     foreach my $res ($navmap->retrieveResources()) {
                    227:         my $symb = $res->symb; 
                    228:         $restitles{$symb} = $res->compTitle();
                    229:     }
1.1       onken     230:    
                    231:     $debug  .= "Found: ". scalar @pdfdata." Entries \n";
1.4       onken     232: 
1.1       onken     233:     foreach my $entry (sort(@pdfdata)) {
                    234:         if ($entry =~ /^meta.*/) {
1.2       onken     235:             $debug .= 'found: metadata -> '.$entry . "<br />";
                    236:             my ($label, $value) = ($entry =~ /^([^?]*)\?(.*)/);
1.1       onken     237:             my ($domain, $user) = split('&', $value);
1.4       onken     238:             $user =~ s/(.*)\n/$1/; #TODO is that equals to chomp?
1.1       onken     239:             if($user ne $env{'user.name'} or  $domain ne $env{'user.domain'}) {
1.12      bisitz    240:                 return '<p class="LC_error">'
                    241:                       .&mt('Wrong username ([_1]) found in PDF file. Expected username: [_2]'
                    242:                           ,$user.':'.$domain
                    243:                           ,$env{'user.domain'}.':'.$env{'user.name'})
                    244:                       .'</p>';
1.1       onken     245:             }
                    246: 
1.17      raeburn   247:         } elsif ($entry =~ /^upload.*/)  {
1.1       onken     248:             $debug .= 'found: a problem -> '.$entry;
1.2       onken     249:             my ($label, $value) = ($entry =~ /^([^?]*)\?(.*)/);
1.1       onken     250:             my ($symb, $part, $type, $HWVAL) = split('&', $label);
1.17      raeburn   251:             my ($map,$id,$resource)=&Apache::lonnet::decode_symb($symb);
1.18      raeburn   252:             if ($map =~ m{^uploaded/($match_domain)/($match_courseid)/default(_?\d*)\.(page|sequence)}) {
                    253:                 my $mapcid = $1.'_'.$2;
                    254:                 if ($mapcid ne $env{'request.course.id'}) {
                    255:                     push(@{$foreigncourse{$mapcid}},$symb);
                    256:                 }
                    257:             }
                    258:             next unless (exists($restitles{$symb}));
1.1       onken     259:             $value =~ s/(.*)\n/$1/; 
                    260: 
1.6       bisitz    261:             #filter incorrect radiobuttons (Bug in CABAReT Stage)
1.17      raeburn   262:             if ($type eq 'radiobuttonresponse' && $value eq 'Off' ) {
1.1       onken     263:                 next;
                    264:             }
                    265:  
                    266:             my $submit = $part;
                    267:             $submit =~ s/part_(.*)/submit_$1/;
1.17      raeburn   268:             if ($problems{$symb.$part}) {
1.1       onken     269:                  $problems{$symb.$part}{$HWVAL} = $value;
                    270:             } else {
                    271:                  $problems{$symb.$part} =  { 'resource' => $resource,
1.11      onken     272:                                         'symb' => $symb,
1.1       onken     273:                                         'submitted' => $part,
                    274:                                         $submit => 'Answer',
                    275:                                         $HWVAL => $value};
                    276:             }
                    277:         } else {
                    278:             $debug .= 'found: -> '.$entry;
                    279:             next;
                    280:         }
                    281:     }
1.4       onken     282:     #$result .= $debug;
1.1       onken     283: 
1.18      raeburn   284:     $result .= '<h3>'.&mt('Result of PDF Form upload').'</h3>';
1.17      raeburn   285: 
                    286:     if (keys(%problems) > 0) {
                    287:         $result .= &Apache::loncommon::start_data_table()
                    288:                   .&Apache::loncommon::start_data_table_header_row()
                    289:                   .'<th>'.&mt('Problem Name').'</th>'
                    290:                   .'<th>'.&mt('Grading').'</th>'
                    291:                   .&Apache::loncommon::start_data_table_header_row()
                    292:                   .&Apache::loncommon::end_data_table_header_row();
                    293: 
                    294:         foreach my $key (sort(keys(%problems))) {
                    295:             my %problem = %{$problems{$key}};
                    296:             my ($problemname, $grade) = &grade_problem(%problem);
                    297: 
                    298:             $result .= &Apache::loncommon::start_data_table_row();
1.18      raeburn   299:             $result .= '<td><a href="/res/'.$problem{'resource'}.
                    300:                        '?symb='.
                    301:                        &HTML::Entities::encode($problem{'symb'},'"&<>').
1.22    ! golterma  302:                        '">'.$problemname.'</a></td><td><span class="';
1.17      raeburn   303:             if ($grade eq "EXACT_ANS" || $grade eq "APPROX_ANS") {
1.18      raeburn   304:                 $result .= 'LC_answer_correct';
1.22    ! golterma  305:             } elsif ($grade eq "DRAFT") {
        !           306:                 $result .= 'LC_answer_not_charged_try';
        !           307:             } else {
1.18      raeburn   308:                 $result .= 'LC_answer_charged_try';
1.17      raeburn   309:             }
1.18      raeburn   310:             $result .= '">';
1.17      raeburn   311:             $grade = &parse_grade_answer($grade);
1.18      raeburn   312:             $result .= $grade.'</span></td>';
1.17      raeburn   313:             $result .= &Apache::loncommon::end_data_table_row();
1.1       onken     314:         }
1.17      raeburn   315:         $result .= &Apache::loncommon::end_data_table();
                    316:     } else {
                    317:         $result .= '<p class="LC_warning">'.
                    318:                    &mt('As no gradable form items were found, no submissions have been recorded.').
                    319:                    '</p>';
1.4       onken     320:     }
1.18      raeburn   321:     if (keys(%foreigncourse)) {
                    322:         my ($numother,$othercrsmsg);
                    323:         foreach my $cid (sort(keys(%foreigncourse))) {
                    324:             my %coursehash = &Apache::lonnet::coursedescription($cid,
                    325:                                                           {'one_time' => 1});
                    326:             if (ref($foreigncourse{$cid}) eq 'ARRAY') {
                    327:                 if ($numother) {
                    328:                     $othercrsmsg .= '</li><li>';
                    329:                 }
                    330:                 $othercrsmsg .= '<b>'.$coursehash{'description'}.'</b><ul>'."\n";
                    331:                 foreach my $symb (@{$foreigncourse{$cid}}) {
                    332:                     my ($map,$id,$resource)=&Apache::lonnet::decode_symb($symb);
                    333:                     $othercrsmsg .= '<li>'.$resource.'</li>';
                    334:                 }
                    335:                 $othercrsmsg .= '</ul>';
                    336:                 $numother ++;
                    337:             }
                    338:         }
                    339:         if ($numother) {
                    340:             $result .= '<div class="LC_warning">';
                    341:             if ($numother > 1) {
                    342:                 $result .= &mt('Your uploaded PDF form contained the following resource(s) from [_1] different courses:','<b>'.$numother.'</b>')."\n".'<ul><li>'.
                    343:                            $othercrsmsg.'</li></ul>';
                    344:             } else {
                    345:                 $result .= &mt('Your uploaded PDF form contained the following resource(s) from a different course:').' '.$othercrsmsg.
                    346:                            &mt('Did you download the PDF form from another course and upload it to the wrong course?'); 
                    347:             }
                    348:             $result .= '</div>';
                    349:         }
                    350:     }
1.1       onken     351: 
1.18      raeburn   352:     return $result;
1.1       onken     353: }
                    354: 
                    355: sub grade_problem {
                    356:     my %problem = @_;
1.7       onken     357:     my ($title, $part) = ();
1.1       onken     358: 
1.7       onken     359:     &Apache::loncommon::ssi_with_retries('/res/'.$problem{'resource'}, 5, %problem);
1.1       onken     360: 
1.7       onken     361:     $title = &Apache::lonnet::gettitle($problem{'symb'});    
                    362:     $part = $problem{submitted};
1.1       onken     363:     $part =~ s/part_(.*)/$1/;
1.7       onken     364:     unless($part eq '0') {
                    365:         #add information about part number
                    366:         $title .= " - Part $part";
                    367:     }
1.1       onken     368:  
                    369:     my %problemhash = &Apache::lonnet::restore($problem{'symb'});
                    370:     my $grade = $problemhash{"resource.$part.award"};
                    371: 
1.7       onken     372:     return ($title, $grade);    
1.1       onken     373: }
                    374: 
1.8       onken     375: sub parse_grade_answer {
                    376:     my ($shortcut) = @_;
                    377:      my %answerhash = ('EXACT_ANS' => &mt('You are correct.'),
1.10      onken     378:                        'APPROX_ANS' => &mt('You are correct.'),
1.8       onken     379:                        'INCORRECT' => &mt('You are incorrect'),
1.22    ! golterma  380:                        'DRAFT' => &mt('Copy saved but not submitted.'),
1.8       onken     381:      );
                    382: 
                    383:     foreach my $key (keys %answerhash) {
                    384:         if($shortcut eq $key) {
                    385:             return $answerhash{$shortcut};
                    386:         }  
                    387:     }
                    388:     return &mt('See course contents for further information.');
                    389: 
                    390: }
                    391: 
                    392: 
1.1       onken     393: sub dumpenv  {
                    394:     my $r = shift;
                    395: 
                    396:     $r->print ("<br />-------------------<br />");
                    397:     foreach my $key (sort (keys %env)) {
                    398:         $r->print ("<br />$key -> $env{$key}");
                    399:     }
                    400:     $r->print ("<br />-------------------<br />");
                    401:     $r->print ("<br />-------------------<br />");
                    402:     foreach my $key (sort (keys %ENV)) {
                    403:         $r->print ("<br />$key -> $ENV{$key}");
                    404:     }
                    405:     $r->print ("<br />-------------------<br />");
                    406:     
                    407: }	
                    408: 
                    409: 1;
                    410: __END__
                    411: 

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