Annotation of loncom/interface/slotrequest.pm, revision 1.5

1.1       albertel    1: # The LearningOnline Network with CAPA
                      2: # Handler for requesting to have slots added to a students record
                      3: #
1.5     ! albertel    4: # $Id: slotrequest.pm,v 1.4 2005/06/04 08:17:06 albertel Exp $
1.1       albertel    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: ###
                     29: 
                     30: package Apache::slotrequest;
                     31: 
                     32: use strict;
                     33: use Apache::Constants qw(:common :http :methods);
                     34: use Apache::loncommon();
                     35: use Apache::lonlocal;
                     36: use Apache::lonnet;
                     37: 
                     38: sub fail {
                     39:     my ($r,$code)=@_;
1.2       albertel   40:     if ($code eq 'not_valid') {
                     41: 	$r->print('<p>'.&mt('Unable to understand what resource you wanted to sign up for.').'</p>'.$env{'form.symb'});
                     42: 
                     43:     }
                     44:     $r->print('<p><a href="/adm/flip?postdata=return:">'.
                     45: 	      &mt('Return to last resource').'</a></p>');
1.1       albertel   46:     &end_page($r);
                     47: }
                     48: 
                     49: sub start_page {
                     50:     my ($r)=@_;
                     51:     my $html=&Apache::lonxml::xmlbegin();
                     52:     $r->print($html.'<head><title>'.
                     53: 	      &mt('Request another Worktime').'</title></head>');
                     54:     $r->print(&Apache::loncommon::bodytag('Requesting another Worktime'));
                     55: }
                     56: 
                     57: sub end_page {
                     58:     my ($r)=@_;
                     59:     $r->print(&Apache::loncommon::endbodytag().'</html>');
                     60: }
                     61: 
1.2       albertel   62: =pod
                     63: 
                     64:  slot_reservations db
                     65:    - keys are 
                     66:     - slotname\0id -> value is an hashref of
                     67:                          name -> user@domain of holder
                     68:                          timestamp -> timestamp of reservation
                     69:                          symb -> symb of resource that it is reserved for
                     70: 
                     71: =cut
                     72: 
                     73: sub get_course {
                     74:     (undef,my $courseid)=&Apache::lonxml::whichuser();
                     75:     my $cdom=$env{'course.'.$courseid.'.domain'};
                     76:     my $cnum=$env{'course.'.$courseid.'.num'};
                     77:     return ($cnum,$cdom);
                     78: }
                     79: 
                     80: sub get_reservation_ids {
                     81:     my ($slot_name)=@_;
                     82:     
                     83:     my ($cnum,$cdom)=&get_course();
                     84: 
                     85:     my %consumed=&Apache::lonnet::dump('slot_reservations',$cdom,$cnum,
                     86: 				       "^$slot_name\0");
                     87:     
                     88:     my ($tmp)=%consumed;
                     89:     if ($tmp=~/^error: 2 / ) {
                     90: 	return 0;
                     91:     }
                     92:     return keys(%consumed);
                     93: }
                     94: 
                     95: sub space_available {
                     96:     my ($slot_name,$slot)=@_;
                     97:     my $max=$slot->{'maxspace'};
                     98: 
                     99:     if (!defined($max)) { return 1; }
                    100: 
                    101:     my $consumed=scalar(&get_reservation_ids($slot_name));
                    102:     if ($consumed < $max) {
                    103: 	return 1
                    104:     }
                    105:     return 0;
                    106: }
1.3       albertel  107: 
1.4       albertel  108: sub check_for_reservation {
                    109:     my ($symb)=@_;
                    110:     my $student = &Apache::lonnet::EXT("resource.0.availablestudent", $symb,
                    111: 				       $env{'user.domain'}, $env{'user.name'});
                    112: 
                    113:     my $course = &Apache::lonnet::EXT("resource.0.available", $symb,
                    114: 				    $env{'user.domain'}, $env{'user.name'});
                    115:     my @slots = (split(/:/,$student), split(/:/, $course));
                    116: 
                    117:     &Apache::lonxml::debug(" slot list is ".join(':',@slots));
                    118: 
                    119:     my ($cnum,$cdom)=&get_course();
                    120:     my %slots=&Apache::lonnet::get('slots', [@slots], $cdom, $cnum);
                    121: 
                    122:     foreach my $slot_name (@slots) {
                    123: 	next if (!defined($slots{$slot_name}) ||
                    124: 		 !ref($slots{$slot_name}));
                    125: 	&Apache::lonxml::debug(time." $slot_name ".
                    126: 			       $slots{$slot_name}->{'starttime'}." -- ".
                    127: 			       $slots{$slot_name}->{'startreserve'});
                    128: 	if ($slots{$slot_name}->{'starttime'} > time &&
                    129: 	    $slots{$slot_name}->{'startreserve'} < time) {
                    130: 	    # between start of reservation times and start of slot
                    131: 	    return($slot_name, $slots{$slot_name});
                    132: 	}
                    133:     }
                    134:     return (undef,undef);
                    135: }
                    136: 
1.5     ! albertel  137: sub check_for_conflict {
        !           138:     my ($symb,$new_slot_name)=@_;
        !           139:     my $student = &Apache::lonnet::EXT("resource.0.availablestudent", $symb,
        !           140: 				       $env{'user.domain'}, $env{'user.name'});
        !           141:     my $course = &Apache::lonnet::EXT("resource.0.available", $symb,
        !           142: 				      $env{'user.domain'}, $env{'user.name'});
        !           143:     my @slots = (split(/:/,$student), split(/:/, $course));
        !           144:     my ($cnum,$cdom)=&get_course();
        !           145:     my %slots=&Apache::lonnet::get('slots', [@slots], $cdom, $cnum);
        !           146:     foreach my $slot_name (@slots) {
        !           147: 	next if (!defined($slots{$slot_name}) ||
        !           148: 		 !ref($slots{$slot_name}));
        !           149: 
        !           150:         next if (!defined($slots{$slot_name}->{'uniqueperiod'}) ||
        !           151: 		 !ref($slots{$slot_name}->{'uniqueperiod'}));
        !           152: 	my ($start,$end)=@{$slots{$slot_name}->{'uniqueperiod'}};
        !           153: 	if ($start<time && time < $end) {
        !           154: 	    return $slot_name;
        !           155: 	}
        !           156:     }
        !           157:     return undef;
        !           158: 
        !           159: }
        !           160: 
1.3       albertel  161: # FIXME - depends on the parameter for the resource to be correct
1.5     ! albertel  162: #         to prevent multiple reservations
1.3       albertel  163: 
1.2       albertel  164: sub make_reservation {
                    165:     my ($slot_name,$slot,$symb)=@_;
1.3       albertel  166: 
                    167:     my ($cnum,$cdom)=&get_course();
                    168: 
                    169:     my $value=&Apache::lonnet::EXT("resource.0.availablestudent",$symb,
                    170: 				   $env{'user.domain'},$env{'user.name'});
                    171:     &Apache::lonxml::debug("value is  $value<br />");
                    172:     foreach my $other_slot (split(/:/, $value)) {
                    173: 	if ($other_slot eq $slot_name) {
                    174: 	    my %consumed=&Apache::lonnet::dump('slot_reservations', $cdom,
                    175: 					       $cnum, "^$slot_name\0");   
                    176: 
                    177: 	    my $me=$env{'user.name'}.'@'.$env{'user.domain'};
                    178: 	    foreach my $key (keys(%consumed)) {
                    179: 		if ($consumed{$key}->{'name'} eq $me) {
                    180: 		    my $num=(split('\0',$key))[1];
                    181: 		    return -$num;
                    182: 		}
                    183: 	    }
                    184: 	}
                    185:     }
                    186: 
1.2       albertel  187:     my $max=$slot->{'maxspace'};
1.3       albertel  188:     if (!defined($max)) { $max=99999; }
1.2       albertel  189: 
                    190:     my (@ids)=&get_reservation_ids($slot_name);
                    191: 
                    192:     # FIXME we could end up having holes... 
                    193:     my $last=0;
                    194:     foreach my $id (@ids) {
                    195: 	my $num=(split('\0',$id))[1];
                    196: 	if ($num > $last) { $last=$num; }
                    197:     }
                    198:     
                    199:     my $wanted=$last+1;
1.3       albertel  200:     &Apache::lonxml::debug("wanted $wanted<br />");
1.2       albertel  201:     if ($wanted >= $max) {
                    202: 	# full up
                    203: 	return -1;
                    204:     }
                    205:     
                    206:     my %reservation=('name'      => $env{'user.name'}.'@'.$env{'user.domain'},
                    207: 		     'timestamp' => time,
                    208: 		     'symb'      => $symb);
                    209: 
                    210:     my $success=&Apache::lonnet::newput('slot_reservations',
                    211: 					{"$slot_name\0$wanted" =>
                    212: 					     \%reservation},
1.3       albertel  213: 					$cdom, $cnum);
                    214: 
1.2       albertel  215:     if ($success eq 'ok') {
1.3       albertel  216: 	#FIXME need to set the parm
                    217: 	my $new_value=$slot_name;
                    218: 	if ($value) {
                    219: 	    $new_value=$value.':'.$new_value;
                    220: 	}
                    221: 	my $result=&Apache::lonparmset::storeparm_by_symb($symb,
                    222: 						      '0_availablestudent',
                    223: 						       1, $new_value, 'string',
                    224: 						       $env{'user.name'},
                    225: 					               $env{'user.domain'});
                    226: 	&Apache::lonxml::debug("hrrm $result");
1.2       albertel  227: 	return $wanted;
                    228:     }
1.3       albertel  229: 
1.2       albertel  230:     # someone else got it
1.3       albertel  231:     return undef;
                    232: }
                    233: 
1.5     ! albertel  234: sub release_slot {
        !           235:     my ($r,$symb)=@_;
        !           236:     # get parameter string, check for existance, rebuild string with the slot
        !           237: 
        !           238:     # get slot reservations, check if user has one, if so remove reservation
        !           239: 
        !           240:     # store new parameter string
        !           241: }
        !           242: 
1.3       albertel  243: sub get_slot {
                    244:     my ($r,$symb)=@_;
                    245: 
1.5     ! albertel  246:     my $slot_name=&check_for_conflict($symb,$env{'form.slotname'});
        !           247:     if ($slot_name) {
        !           248: 	my %slot=&Apache::lonnet::get_slot($slot_name);
        !           249: 	my $description=&get_description($env{'form.slotname'},\%slot);
        !           250: 	$r->print("<p>Already have a reservation: $description</p>");
        !           251: 	$r->print('<p><a href="/adm/flip?postdata=return:">'.
        !           252: 		  &mt('Return to last resource').'</a></p>');
        !           253: 	# FIXME add button to free current reservation adn get new one
        !           254: 	return;
        !           255:     }
1.3       albertel  256:     my %slot=&Apache::lonnet::get_slot($env{'form.slotname'});
                    257:     my $reserved=&make_reservation($env{'form.slotname'},
                    258: 				   \%slot,$symb);
                    259:     my $description=&get_description($env{'form.slotname'},\%slot);
                    260:     if ($reserved > -1) {
                    261: 	$r->print("<p>Success: $description</p>");
                    262: 	$r->print('<p><a href="/adm/flip?postdata=return:">'.
                    263: 		  &mt('Return to last resource').'</a></p>');
                    264: 	return;
                    265:     } elsif ($reserved < 0) {
                    266: 	$r->print("<p>Already reserved: $description</p>");
                    267: 	$r->print('<p><a href="/adm/flip?postdata=return:">'.
                    268: 		  &mt('Return to last resource').'</a></p>');
                    269: 	return;
                    270:     }
                    271: 
                    272:     my %lt=('request'=>"Request another attempt",
                    273: 	    'try'    =>'Try again');
                    274:     %lt=&Apache::lonlocal::texthash(%lt);
                    275: 
                    276:     $r->print(<<STUFF);
                    277: <p> <font color="red">Failed</font> to reserve a spot for $description. </p>
                    278: <p>
                    279: <form method="POST" action="/adm/slotrequest">
                    280:    <input type="submit" name="Try Again" value="$lt{'try'}" />
                    281:    <input type="hidden" name="symb" value="$env{'form.symb'}" />
                    282:    <input type="hidden" name="slotname" value="$env{'form.slotname'}" />
                    283:    <input type="hidden" name="command" value="get" />
                    284: </form>
                    285: ?
                    286: </p>
                    287: <p>
                    288: or
                    289: <form method="POST" action="/adm/slotrequest">
                    290:     <input type="hidden" name="symb" value="$env{'form.symb'}" />
                    291:     <input type="submit" name="requestattempt" value="$lt{'request'}" />
                    292: </form>
                    293: </p>
                    294: or
                    295: STUFF
                    296:     $r->print('<p><a href="/adm/flip?postdata=return:">'.
                    297: 	      &mt('Return to last resource').'</a></p>');
                    298:     return;
                    299: }
                    300: 
                    301: sub allowed_slot {
                    302:     my ($slot_name,$slot,$symb)=@_;
                    303:     #already started
                    304:     if ($slot->{'starttime'} < time) {
1.5     ! albertel  305: 	# all open slot to be schedulable
        !           306: 	#return 0;
1.3       albertel  307:     }
1.5     ! albertel  308:     &Apache::lonxml::debug("$slot_name starttime good");
1.3       albertel  309:     #already ended
                    310:     if ($slot->{'endtime'} < time) {
                    311: 	return 0;
                    312:     }
1.5     ! albertel  313:     &Apache::lonxml::debug("$slot_name endtime good");
1.3       albertel  314:     # not allowed to pick this one
                    315:     if (defined($slot->{'type'})
                    316: 	&& $slot->{'type'} ne 'schedulable_student') {
                    317: 	return 0;
                    318:     }
1.5     ! albertel  319:     &Apache::lonxml::debug("$slot_name type good");
1.3       albertel  320:     # not allowed for this resource
                    321:     if (defined($slot->{'symb'})
                    322: 	&& $slot->{'symb'} ne $symb) {
                    323: 	return 0;
                    324:     }
1.5     ! albertel  325:     &Apache::lonxml::debug("$slot_name symb good");
1.3       albertel  326:     return 1;
1.2       albertel  327: }
                    328: 
1.3       albertel  329: sub get_description {
                    330:     my ($slot_name,$slot)=@_;
                    331:     my $description=$slot->{'description'};
                    332:     if (!defined($description)) {
1.4       albertel  333: 	$description=&mt('[_1] From [_2] to [_3]',$slot_name,
1.3       albertel  334: 			 &Apache::lonlocal::locallocaltime($slot->{'starttime'}),
                    335: 			 &Apache::lonlocal::locallocaltime($slot->{'endtime'}));
                    336:     }
                    337:     return $description;
                    338: }
1.2       albertel  339: 
                    340: sub show_choices {
                    341:     my ($r,$symb)=@_;
                    342: 
                    343:     my ($cnum,$cdom)=&get_course();
                    344:     my %slots=&Apache::lonnet::dump('slots',$cdom,$cnum);
1.3       albertel  345:     my $available;
1.2       albertel  346:     $r->print('<table border="1">');
1.5     ! albertel  347:     &Apache::lonxml::debug("Checking Slots");
        !           348:     my ($got_slot)=&check_for_reservation($symb);
1.2       albertel  349:     foreach my $slot (sort 
                    350: 		      { return $slots{$a}->{'starttime'} <=> $slots{$b}->{'starttime'} }
                    351: 		      (keys(%slots)))  {
1.5     ! albertel  352: 
        !           353: 	&Apache::lonxml::debug("Checking Slot $slot");
1.3       albertel  354: 	next if (!&allowed_slot($slot,$slots{$slot}));
                    355: 
                    356: 	$available++;
                    357: 
                    358: 	my $description=&get_description($slot,$slots{$slot});
1.2       albertel  359: 
                    360: 	my $form=&mt('Unavailable');
1.3       albertel  361: 	if (&space_available($slot,$slots{$slot},$symb)) {
1.5     ! albertel  362: 	    my $text=&mt('Select');
        !           363: 	    my $command='get';
        !           364: 	    if ($slot eq $got_slot) {
        !           365: 		$text=&mt('Free Reservation');
        !           366: 		$command='release';
        !           367: 	    }
1.3       albertel  368: 	    my $escsymb=&Apache::lonnet::escape($symb);
1.2       albertel  369: 	    $form=<<STUFF;
1.3       albertel  370:    <form method="POST" action="/adm/slotrequest">
1.5     ! albertel  371:      <input type="submit" name="Select" value="$text" />
1.3       albertel  372:      <input type="hidden" name="symb" value="$escsymb" />
                    373:      <input type="hidden" name="slotname" value="$slot" />
1.5     ! albertel  374:      <input type="hidden" name="command" value="$command" />
1.2       albertel  375:    </form>
                    376: STUFF
                    377: 	}
                    378: 	$r->print(<<STUFF);
                    379: <tr>
                    380:  <td>$form</td>
                    381:  <td>$description</td>
                    382: </tr>
                    383: STUFF
                    384:     }
1.3       albertel  385: 
                    386:     if (!$available) {
1.5     ! albertel  387: 	$r->print('<tr><td>No available times. <a href="/adm/flip?postdata=return:">'.
1.3       albertel  388: 		  &mt('Return to last resource').'</a></td></tr>');
                    389:     }
1.2       albertel  390:     $r->print('</table>');
                    391: }
                    392: 
1.5     ! albertel  393: sub show_table {
        !           394:     my ($r,$symb)=@_;
        !           395: 
        !           396:     my ($cnum,$cdom)=&get_course();
        !           397:     my %slots=&Apache::lonnet::dump('slots',$cdom,$cnum);
        !           398:     my $available;
        !           399:     $r->print('<table border="1">');
        !           400:     foreach my $slot (sort 
        !           401: 		      { return $slots{$a}->{'starttime'} <=> $slots{$b}->{'starttime'} }
        !           402: 		      (keys(%slots)))  {
        !           403: 	if (defined($slots{$slot}->{'type'})
        !           404: 	    && $slots{$slot}->{'type'} ne 'schedulable_student') {
        !           405: 	    next;
        !           406: 	}
        !           407: 	my $description=&get_description($slot,$slots{$slot});
        !           408: 	my %consumed=&Apache::lonnet::dump('slot_reservations',$cdom,$cnum,
        !           409: 					   "^$slot\0");
        !           410: 	my $ids;
        !           411: 	foreach my $entry (sort(keys(%consumed))) {
        !           412: 	    my (undef,$id)=split("\0",$entry);
        !           413: 	    $ids.= $id.'-> '.$consumed{$entry}->{'name'}.'<br />';
        !           414: 	}
        !           415: 	my $start=localtime($slots{$slot}->{'starttime'});
        !           416: 	my $end=localtime($slots{$slot}->{'endtime'});
        !           417: 	$r->print(<<STUFF);
        !           418: <tr>
        !           419:  <td>$slot</td>
        !           420:  <td>$description</td>
        !           421:  <td>$start</td>
        !           422:  <td>$end</td>
        !           423:  <td>$slots{$slot}->{'maxspace'}</td>
        !           424:  <td>$ids</td>
        !           425: </tr>
        !           426: STUFF
        !           427:     }
        !           428:     $r->print('</table>');
        !           429: }
        !           430: 
1.1       albertel  431: sub handler {
                    432:     my $r=shift;
                    433: 
                    434:     &start_page($r);
1.2       albertel  435:     my $symb=&Apache::lonnet::unescape($env{'form.symb'});
1.1       albertel  436:     my (undef,undef,$res)=&Apache::lonnet::decode_symb($symb);
1.2       albertel  437:     if ($res !~ /\.task$/) {
1.1       albertel  438: 	&fail($r,'not_valid');
                    439: 	return OK;
                    440:     }
1.5     ! albertel  441:  
        !           442:     if ($env{'form.command'} eq 'showslots') {
        !           443: 	&show_table($r,$symb);
        !           444:     } elsif ($env{'form.requestattempt'}) {
1.2       albertel  445: 	&show_choices($r,$symb);
1.5     ! albertel  446:     } elsif ($env{'form.command'} eq 'release') {
        !           447: 	&release_slot($r,$symb);
1.3       albertel  448:     } elsif ($env{'form.command'} eq 'get') {
                    449: 	&get_slot($r,$symb);
1.2       albertel  450:     }
1.1       albertel  451:     &end_page($r);
                    452:     return OK;
                    453: }
1.3       albertel  454: 
                    455: 1;
                    456: __END__

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