File:
[LON-CAPA] /
loncom /
interface /
Attic /
londropadd.pm
Revision
1.51:
download - view:
text,
annotated -
select for diffs
Wed Sep 18 14:17:47 2002 UTC (21 years, 11 months ago) by
matthew
Branches:
MAIN
CVS tags:
HEAD
Rewrote &get_current_classlist to call routines in loncoursedata.
Renamed &menu_phase_two_drop to &print_drop_menu and modified to use new
data from &get_current_classlist.
Modified &print_html_classlist and &print_csv_classlist to deal with new
&get_current_classlist.
Rewrote &show_classlist to take data from &get_current_classlist.
Not all of the error detecting code is reimplemented yet.
Modifying a single students status is not working yet.
Sorting of students by various fields (table headings) needs to be implemented.
1: # The LearningOnline Network with CAPA
2: # Handler to drop and add students in courses
3: #
4: # $Id: londropadd.pm,v 1.51 2002/09/18 14:17:47 matthew Exp $
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: # (Handler to set parameters for assessments
29: #
30: # (Handler to resolve ambiguous file locations
31: #
32: # (TeX Content Handler
33: #
34: ###############################################################
35: ###############################################################
36:
37: package Apache::londropadd;
38:
39: use strict;
40: use Apache::lonnet();
41: use Apache::loncommon();
42: use Apache::lonhtmlcommon();
43: use Apache::Constants qw(:common :http REDIRECT);
44:
45: ###############################################################
46: ###############################################################
47: sub header {
48: my $bodytag=&Apache::loncommon::bodytag('Enrollment Manager');
49: return(<<ENDHEAD);
50: <html>
51: <head>
52: <title>LON-CAPA Enrollment Manager</title>
53: </head>
54: $bodytag
55: <form method="post" enctype="multipart/form-data"
56: action="/adm/dropadd" name="studentform">
57: ENDHEAD
58: }
59:
60: ###############################################################
61: ###############################################################
62: # Drop student from all sections of a course, except optional $csec
63: sub modifystudent {
64: my ($udom,$unam,$courseid,$csec,$desiredhost)=@_;
65: # if $csec is undefined, drop the student from all the courses matching
66: # this one. If $csec is defined, drop them from all other sections of
67: # this course and add them to section $csec
68: $courseid=~s/\_/\//g;
69: $courseid=~s/^(\w)/\/$1/;
70: my %roles = &Apache::lonnet::dump('roles',$udom,$unam);
71: my ($tmp) = keys(%roles);
72: # Bail out if we were unable to get the students roles
73: return "$1" if ($tmp =~ /^(con_lost|error|no_such_host)/i);
74: # Go through the roles looking for enrollment in this course
75: my $result = '';
76: foreach my $course (keys(%roles)) {
77: if ($course=~/^$courseid(?:\/)*(?:\s+)*(\w+)*\_st$/) {
78: # We are in this course
79: my $section=$1;
80: $section='' if ($course eq $courseid.'_st');
81: if ( ((!$section) && (!$csec)) || ($section ne $csec) ) {
82: my (undef,$end,$start)=split(/\_/,$roles{$course});
83: my $now=time;
84: # if this is an active role
85: if (!($start && ($now<$start)) || !($end && ($now>$end))) {
86: my $reply=&Apache::lonnet::modifystudent
87: ($udom,$unam,'','','','','','','',
88: $section,time,undef,undef,$desiredhost);
89: $result .= $reply.':';
90: }
91: }
92: }
93: }
94: if ($result eq '') {
95: $result eq 'Unable to find section for this student';
96: } else {
97: $result =~ s/(ok:)+/ok/g;
98: }
99: return $result;
100: }
101:
102: ###############################################################
103: ###############################################################
104: # build a domain and server selection form
105: sub domain_form {
106: my ($defdom) = @_;
107: # Set up domain and server selection forms
108: #
109: # Get the domains
110: my @domains = &Apache::loncommon::get_domains();
111: # build up the menu information to be passed to
112: # &Apache::loncommon::linked_select_forms
113: my %select_menus;
114: foreach my $dom (@domains) {
115: # set up the text for this domain
116: $select_menus{$dom}->{'text'}= $dom;
117: # we want a choice of 'default' as the default in the second menu
118: $select_menus{$dom}->{'default'}= 'default';
119: $select_menus{$dom}->{'select2'}->{'default'} = 'default';
120: # Now build up the other items in the second menu
121: my %servers = &Apache::loncommon::get_library_servers($dom);
122: foreach my $server (keys(%servers)) {
123: $select_menus{$dom}->{'select2'}->{$server}
124: = "$server $servers{$server}";
125: }
126: }
127: my $result = &Apache::loncommon::linked_select_forms
128: ('studentform',' with home server ',$defdom,
129: 'lcdomain','lcserver',\%select_menus);
130: return $result;
131: }
132:
133: ###############################################################
134: ###############################################################
135: # Menu Phase One
136: sub print_main_menu {
137: my $r=shift;
138: $r->print(<<END);
139: <p>
140: <font size="+1">
141: <a href="/adm/dropadd?action=upload">Upload a course list</a>
142: </font>
143: </p><p>
144: <font size="+1">
145: <a href="/adm/dropadd?action=enrollstudent">Enroll a single student</a>
146: </font>
147: </p><p>
148: <font size="+1">
149: <a href="/adm/dropadd?action=modifystudent">Modify student data</a>
150: </font>
151: </p><p>
152: <font size="+1">
153: <a href="/adm/dropadd?action=classlist">View Classlist</a>
154: </font>
155: </p><p>
156: <font size="+1">
157: <a href="/adm/dropadd?action=drop">Drop Students</a>
158: </font>
159: </p>
160: END
161: }
162:
163: ###############################################################
164: ###############################################################
165: sub print_upload_manager_header {
166: my ($r,$datatoken,$distotal,$krbdefdom)=@_;
167: my $javascript;
168: if (! exists($ENV{'form.upfile_associate'})) {
169: $ENV{'form.upfile_associate'} = 'forward';
170: }
171: if ($ENV{'form.associate'} eq 'Reverse Association') {
172: if ( $ENV{'form.upfile_associate'} ne 'reverse' ) {
173: $ENV{'form.upfile_associate'} = 'reverse';
174: } else {
175: $ENV{'form.upfile_associate'} = 'forward';
176: }
177: }
178: if ($ENV{'form.upfile_associate'} eq 'reverse') {
179: $javascript=&upload_manager_javascript_reverse_associate();
180: } else {
181: $javascript=&upload_manager_javascript_forward_associate();
182: }
183: my $javascript_validations=&javascript_validations($krbdefdom);
184: $r->print(<<ENDPICK);
185: <h3>Uploading Class List</h3>
186: <hr>
187: <h3>Identify fields</h3>
188: Total number of records found in file: $distotal <hr />
189: Enter as many fields as you can. The system will inform you and bring you back
190: to this page if the data selected is insufficient to run your class.<hr />
191: <input type="button" value="Reverse Association" onClick="javascript:this.form.associate.value='Reverse Association';submit(this.form);" />
192: <input type="hidden" name="action" value="upload" />
193: <input type="hidden" name="state" value="got_file" />
194: <input type="hidden" name="associate" value="" />
195: <input type="hidden" name="datatoken" value="$datatoken" />
196: <input type="hidden" name="fileupload" value="$ENV{'form.fileupload'}" />
197: <input type="hidden" name="upfiletype" value="$ENV{'form.upfiletype'}" />
198: <input type="hidden" name="upfile_associate"
199: value="$ENV{'form.upfile_associate'}" />
200: <hr />
201: <script type="text/javascript" language="Javascript">
202: $javascript
203: $javascript_validations
204: </script>
205: ENDPICK
206: }
207:
208: ###############################################################
209: ###############################################################
210: sub javascript_validations {
211: my ($krbdefdom)=@_;
212: my %param = ( formname => 'studentform',
213: kerb_def_dom => $krbdefdom );
214: my $authheader = &Apache::loncommon::authform_header(%param);
215: return (<<ENDPICK);
216: function verify_message (vf,founduname,foundpwd,foundname,foundid,foundsec) {
217: var foundatype=0;
218: var message='';
219: if (founduname==0) {
220: alert('You need to specify the username field');
221: return;
222: }
223: if (current.radiovalue == null || current.radiovalue == 'nochange') {
224: // They did not check any of the login radiobuttons.
225: alert('You must choose an authentication type');
226: return;
227: }
228: foundatype=1;
229: if (current.argfield == null || current.argfield == '') {
230: var alertmsg = '';
231: switch (current.value) {
232: case 'krb':
233: alertmsg = 'You need to specify the Kerberos domain';
234: break;
235: case 'loc':
236: case 'fsys':
237: alertmsg = 'You need to specify the initial password';
238: break;
239: case 'fsys':
240: alertmsg = '';
241: break;
242: default:
243: alertmsg = '';
244: }
245: if (alertmsg != '') {
246: alert(alertmsg);
247: return;
248: }
249: }
250:
251: if (foundname==0) { message='No name fields specified. '; }
252: if (foundid==0) { message+='No ID or student number field specified. '; }
253: if (foundsec==0) { message+='No section or group field specified. '; }
254: if (vf.startdate.value=='') {
255: message+='No starting date set. ';
256: }
257: if (vf.enddate.value=='') {
258: message+='No ending date set. ';
259: }
260: if ((vf.enddate.value!='') && (vf.startdate.value!='')) {
261: if (Math.round(vf.enddate.value)<Math.round(vf.startdate.value)) {
262: alert('Ending date is before starting date');
263: return;
264: }
265: }
266: if (message!='') {
267: message+='Continue enrollment?';
268: if (confirm(message)) {
269: pclose();
270: vf.state.value='enrolling';
271: vf.submit();
272: }
273: } else {
274: pclose();
275: vf.state.value='enrolling';
276: vf.submit();
277: }
278: }
279:
280:
281: function pclose() {
282: parmwin=window.open("/adm/rat/empty.html","LONCAPAparms",
283: "height=350,width=350,scrollbars=no,menubar=no");
284: parmwin.close();
285: }
286:
287: function pjump(type,dis,value,marker,ret,call) {
288: parmwin=window.open("/adm/rat/parameter.html?type="+escape(type)
289: +"&value="+escape(value)+"&marker="+escape(marker)
290: +"&return="+escape(ret)
291: +"&call="+escape(call)+"&name="+escape(dis),"LONCAPAparms",
292: "height=350,width=350,scrollbars=no,menubar=no");
293:
294: }
295:
296: function dateset() {
297: if (document.studentform.pres_marker.value=='end') {
298: document.studentform.enddate.value=
299: document.studentform.pres_value.value;
300: }
301: if (document.studentform.pres_marker.value=='start') {
302: document.studentform.startdate.value=
303: document.studentform.pres_value.value;
304: }
305: pclose();
306: }
307:
308: $authheader
309: ENDPICK
310:
311: }
312:
313: ###############################################################
314: ###############################################################
315: sub upload_manager_javascript_forward_associate {
316: return(<<ENDPICK);
317: function verify(vf) {
318: var founduname=0;
319: var foundpwd=0;
320: var foundname=0;
321: var foundid=0;
322: var foundsec=0;
323: var tw;
324: for (i=0;i<=vf.nfields.value;i++) {
325: tw=eval('vf.f'+i+'.selectedIndex');
326: if (tw==1) { founduname=1; }
327: if ((tw>=2) && (tw<=6)) { foundname=1; }
328: if (tw==7) { foundid=1; }
329: if (tw==8) { foundsec=1; }
330: if (tw==9) { foundpwd=1; }
331: }
332: verify_message(vf,founduname,foundpwd,foundname,foundid,foundsec);
333: }
334:
335: //
336: // vf = this.form
337: // tf = column number
338: //
339: // values of nw
340: //
341: // 0 = none
342: // 1 = username
343: // 2 = names (lastname, firstnames)
344: // 3 = fname (firstname)
345: // 4 = mname (middlename)
346: // 5 = lname (lastname)
347: // 6 = gen (generation)
348: // 7 = id
349: // 8 = section
350: // 9 = ipwd (password)
351: //
352: function flip(vf,tf) {
353: var nw=eval('vf.f'+tf+'.selectedIndex');
354: var i;
355: // make sure no other columns are labeled the same as this one
356: for (i=0;i<=vf.nfields.value;i++) {
357: if ((i!=tf) && (eval('vf.f'+i+'.selectedIndex')==nw)) {
358: eval('vf.f'+i+'.selectedIndex=0;')
359: }
360: }
361: // If we set this to 'lastname, firstnames', clear out all the ones
362: // set to 'fname','mname','lname','gen' (3,4,5,6) currently.
363: if (nw==2) {
364: for (i=0;i<=vf.nfields.value;i++) {
365: if ((eval('vf.f'+i+'.selectedIndex')>=3) &&
366: (eval('vf.f'+i+'.selectedIndex')<=6)) {
367: eval('vf.f'+i+'.selectedIndex=0;')
368: }
369: }
370: }
371: // If we set this to one of 'fname','mname','lname','gen' (3,4,5,6),
372: // clear out any that are set to 'lastname, firstnames' (2)
373: if ((nw>=3) && (nw<=6)) {
374: for (i=0;i<=vf.nfields.value;i++) {
375: if (eval('vf.f'+i+'.selectedIndex')==2) {
376: eval('vf.f'+i+'.selectedIndex=0;')
377: }
378: }
379: }
380: // If we set the password, make the password form below correspond to
381: // the new value.
382: if (nw==9) {
383: changed_radio('int',document.studentform);
384: set_auth_radio_buttons('int',document.studentform);
385: vf.intarg.value='';
386: vf.krbarg.value='';
387: vf.locarg.value='';
388: }
389: }
390:
391: function clearpwd(vf) {
392: var i;
393: for (i=0;i<=vf.nfields.value;i++) {
394: if (eval('vf.f'+i+'.selectedIndex')==9) {
395: eval('vf.f'+i+'.selectedIndex=0;')
396: }
397: }
398: }
399:
400: ENDPICK
401: }
402:
403: ###############################################################
404: ###############################################################
405: sub upload_manager_javascript_reverse_associate {
406: return(<<ENDPICK);
407: function verify(vf) {
408: var founduname=0;
409: var foundpwd=0;
410: var foundname=0;
411: var foundid=0;
412: var foundsec=0;
413: var tw;
414: for (i=0;i<=vf.nfields.value;i++) {
415: tw=eval('vf.f'+i+'.selectedIndex');
416: if (i==0 && tw!=0) { founduname=1; }
417: if (((i>=1) && (i<=5)) && tw!=0 ) { foundname=1; }
418: if (i==6 && tw!=0) { foundid=1; }
419: if (i==7 && tw!=0) { foundsec=1; }
420: if (i==8 && tw!=0) { foundpwd=1; }
421: }
422: verify_message(vf,founduname,foundpwd,foundname,foundid,foundsec);
423: }
424:
425: function flip(vf,tf) {
426: var nw=eval('vf.f'+tf+'.selectedIndex');
427: var i;
428: // picked the all one one name field, reset the other name ones to blank
429: if (tf==1 && nw!=0) {
430: for (i=2;i<=5;i++) {
431: eval('vf.f'+i+'.selectedIndex=0;')
432: }
433: }
434: //picked one of the piecewise name fields, reset the all in
435: //one field to blank
436: if ((tf>=2) && (tf<=5) && (nw!=0)) {
437: eval('vf.f1.selectedIndex=0;')
438: }
439: // intial password specified, pick internal authentication
440: if (tf==8 && nw!=0) {
441: changed_radio('int',document.studentform);
442: set_auth_radio_buttons('int',document.studentform);
443: vf.krbarg.value='';
444: vf.intarg.value='';
445: vf.locarg.value='';
446: }
447: }
448:
449: function clearpwd(vf) {
450: var i;
451: if (eval('vf.f8.selectedIndex')!=0) {
452: eval('vf.f8.selectedIndex=0;')
453: }
454: }
455: ENDPICK
456: }
457:
458: ###############################################################
459: ###############################################################
460: sub print_upload_manager_footer {
461: my ($r,$i,$keyfields,$defdom,$today,$halfyear)=@_;
462: my %param = ( formname => 'document.studentform');
463: my $krbform = &Apache::loncommon::authform_kerberos(%param);
464: my $intform = &Apache::loncommon::authform_internal(%param);
465: my $locform = &Apache::loncommon::authform_local(%param);
466: my $domform = &domain_form($defdom);
467: $r->print(<<ENDPICK);
468: </table>
469: <input type=hidden name=nfields value=$i>
470: <input type=hidden name=keyfields value="$keyfields">
471: <h3>Login Type</h3>
472: <p>Note: this will not take effect if the user already exists</p>
473: <p>
474: $krbform
475: </p>
476: <p>
477: $intform
478: </p>
479: <p>
480: $locform
481: </p>
482: <h3>LON-CAPA Domain for Students</h3>
483: LON-CAPA domain: $domform <p>
484: <h3>Starting and Ending Dates</h3>
485: <input type="hidden" value='' name="pres_value" >
486: <input type="hidden" value='' name="pres_type" >
487: <input type="hidden" value='' name="pres_marker" >
488: <input type="hidden" value='$today' name="startdate" >
489: <input type="hidden" value='$halfyear' name="enddate" >
490: <a
491: href="javascript:pjump('date_start','Enrollment Starting Date',document.studentform.startdate.value,'start','studentform.pres','dateset');"
492: >Set Starting Date</a><p>
493:
494: <a
495: href="javascript:pjump('date_end','Enrollment Ending Date',document.studentform.enddate.value,'end','studentform.pres','dateset');"
496: >Set Ending Date</a><p>
497: <h3>Full Update</h3>
498: <input type=checkbox name=fullup value=yes> Full update
499: (also print list of users not enrolled anymore)<p>
500: <h3>ID/Student Number</h3>
501: <input type=checkbox name=forceid value=yes>
502: Disable ID/Student Number Safeguard and Force Change of Conflicting IDs
503: (only do if you know what you are doing)<p>
504: <input type="button" onClick="javascript:verify(this.form)" value="Update Courselist" /><br />
505: Note: for large courses, this operation may be time consuming.
506: ENDPICK
507: }
508:
509: # ======================================================= Menu Phase Two Upload
510: sub print_upload_manager_form {
511: my $r=shift;
512:
513: my $datatoken;
514: if (!$ENV{'form.datatoken'}) {
515: $datatoken=&Apache::loncommon::upfile_store($r);
516: } else {
517: $datatoken=$ENV{'form.datatoken'};
518: &Apache::loncommon::load_tmp_file($r);
519: }
520: my @records=&Apache::loncommon::upfile_record_sep();
521: my $total=$#records;
522: my $distotal=$total+1;
523: $ENV{'SERVER_NAME'}=~/(\w+\.\w+)$/;
524: my $krbdefdom=$1;
525: $krbdefdom=~tr/a-z/A-Z/;
526: my $today=time;
527: my $halfyear=$today+15552000;
528: my $defdom=$r->dir_config('lonDefDomain');
529: &print_upload_manager_header($r,$datatoken,$distotal,$krbdefdom);
530: my $i;
531: my $keyfields;
532: if ($total>=0) {
533: my @d=(['username','Username'],
534: ['names','Last Name, First Names'],
535: ['fname','First Name'],
536: ['mname','Middle Names/Initials'],
537: ['lname','Last Name'],
538: ['gen','Generation'],
539: ['id','ID/Student Number'],
540: ['sec','Group/Section'],
541: ['ipwd','Initial Password']);
542: if ($ENV{'form.upfile_associate'} eq 'reverse') {
543: &Apache::loncommon::csv_print_samples($r,\@records);
544: $i=&Apache::loncommon::csv_print_select_table($r,\@records,\@d);
545: foreach (@d) { $keyfields.=$_->[0].','; }
546: chop($keyfields);
547: } else {
548: unshift(@d,['none','']);
549: $i=&Apache::loncommon::csv_samples_select_table($r,\@records,\@d);
550: my %sone=&Apache::loncommon::record_sep($records[0]);
551: $keyfields=join(',',sort(keys(%sone)));
552: }
553: }
554: &print_upload_manager_footer($r,$i,$keyfields,$defdom,$today,$halfyear);
555: }
556:
557: # ======================================================= Enroll single student
558: sub enroll_single_student {
559: my $r=shift;
560: $r->print('<h3>Enrolling Student</h3>');
561: $r->print('<p>Enrolling '.$ENV{'form.cuname'}." in domain ".
562: $ENV{'form.lcdomain'}.'</p>');
563: if (($ENV{'form.cuname'})&&($ENV{'form.cuname'}!~/\W/)&&
564: ($ENV{'form.lcdomain'})&&($ENV{'form.lcdomain'}!~/\W/)) {
565: # Deal with home server selection
566: my $domain=$ENV{'form.lcdomain'};
567: my $desiredhost = $ENV{'form.lcserver'};
568: if (lc($desiredhost) eq 'default') {
569: $desiredhost = undef;
570: } else {
571: my %home_servers =&Apache::loncommon::get_library_servers($domain);
572: if (! exists($home_servers{$desiredhost})) {
573: $r->print('<font color="#ff0000">Error:</font>'.
574: 'Invalid home server specified');
575: return;
576: }
577: }
578: $r->print(" with server $desiredhost :") if (defined($desiredhost));
579: # End of home server selection logic
580: my $amode='';
581: my $genpwd='';
582: if ($ENV{'form.login'} eq 'krb') {
583: $amode='krb';
584: $amode.=$ENV{'form.krbver'};
585: $genpwd=$ENV{'form.krbarg'};
586: } elsif ($ENV{'form.login'} eq 'int') {
587: $amode='internal';
588: $genpwd=$ENV{'form.intarg'};
589: } elsif ($ENV{'form.login'} eq 'loc') {
590: $amode='localauth';
591: $genpwd=$ENV{'form.locarg'};
592: if (!$genpwd) { $genpwd=" "; }
593: }
594: my $home = &Apache::lonnet::homeserver($ENV{'form.cuname'},
595: $ENV{'form.lcdomain'});
596: if ((($amode) && ($genpwd)) || ($home ne 'no_host')) {
597: &modifystudent($ENV{'form.lcdomain'},$ENV{'form.cuname'},
598: $ENV{'request.course.id'},$ENV{'form.csec'},
599: $desiredhost);
600: $r->print(&Apache::lonnet::modifystudent(
601: $ENV{'form.lcdomain'},$ENV{'form.cuname'},
602: $ENV{'form.cstid'},$amode,$genpwd,
603: $ENV{'form.cfirst'},$ENV{'form.cmiddle'},
604: $ENV{'form.clast'},$ENV{'form.cgen'},
605: $ENV{'form.csec'},$ENV{'form.enddate'},
606: $ENV{'form.startdate'},$ENV{'form.forceid'},
607: $desiredhost));
608: } else {
609: $r->print('<p><font color="#ff0000">ERROR</font> '.
610: 'Invalid login mode or password. '.
611: 'Unable to enroll '.$ENV{'form.cuname'}.'.</p>');
612: }
613: } else {
614: $r->print('Invalid username or domain');
615: }
616: }
617:
618: # ======================================================= Menu Phase Two Enroll
619: sub print_enroll_single_student_form {
620: my $r=shift;
621: $r->print("<h3>Enroll One Student</h3>");
622: my ($krbdefdom) = $ENV{'SERVER_NAME'}=~/(\w+\.\w+)$/;
623: $krbdefdom=~tr/a-z/A-Z/;
624: my $today = time;
625: my $halfyear = $today+15552000;
626: my $defdom=$r->dir_config('lonDefDomain');
627: my $javascript_validations=&javascript_validations($krbdefdom);
628: # Set up authentication forms
629: my %param = ( formname => 'document.studentform');
630: my $krbform = &Apache::loncommon::authform_kerberos(%param);
631: my $intform = &Apache::loncommon::authform_internal(%param);
632: my $locform = &Apache::loncommon::authform_local(%param);
633: # Set up domain selection form
634: my $domform = &domain_form($defdom);
635: # Print it all out
636: $r->print(<<END);
637: <input type="hidden" name="action" value="enrollstudent">
638: <input type="hidden" name="state" value="done">
639:
640: <script type="text/javascript" language="Javascript">
641: function verify(vf) {
642: var founduname=0;
643: var foundpwd=0;
644: var foundname=0;
645: var foundid=0;
646: var foundsec=0;
647: var tw;
648: if ((typeof(vf.cuname.value) !="undefined") && (vf.cuname.value!='') &&
649: (typeof(vf.lcdomain.value)!="undefined") && (vf.lcdomain.value!='')) {
650: founduname=1;
651: }
652: if ((typeof(vf.cfirst.value)!="undefined") && (vf.cfirst.value!='') &&
653: (typeof(vf.clast.value) !="undefined") && (vf.clast.value!='')) {
654: foundname=1;
655: }
656: if ((typeof(vf.csec.value)!="undefined") && (vf.csec.value!='')) {
657: foundsec=1;
658: }
659: if ((typeof(vf.cstid.value)!="undefined") && (vf.cstid.value!='')) {
660: foundid=1;
661: }
662: if (founduname==0) {
663: alert('You need to specify at least the username and domain fields');
664: return;
665: }
666: verify_message(vf,founduname,foundpwd,foundname,foundid,foundsec);
667: }
668:
669: $javascript_validations
670:
671: function clearpwd(vf) {
672: //nothing else needs clearing
673: }
674:
675: </script>
676: <h3>Personal Data</h3>
677: <table>
678: <tr><td>First Name:</td><td> <input type="text" name="cfirst" size="15"></td></tr>
679: <tr><td>Middle Name:</td><td> <input type="text" name="cmiddle" size="15"></td></tr>
680: <tr><td>Last Name: </td><td><input type="text" name="clast" size="15"></td></tr>
681: <tr><td>Generation: </td><td><input type="text" name="cgen" size="5"> </td></tr>
682: </table>
683:
684: <h3>Login Data</h3>
685: <p>Username: <input type="text" name="cuname" size="15"></p>
686: <p>Domain: $domform</p>
687: <p>Note: login settings below will not take effect if the user already exists
688: </p><p>
689: $krbform
690: </p><p>
691: $intform
692: </p><p>
693: $locform
694: </p><p>
695:
696: <h3>Course Data</h3>
697:
698: <p>Group/Section: <input type="text" name="csec" size="5" />
699: <p>
700: <!-- Date setting form elements -->
701: <input type="hidden" name="pres_value" value='' />
702: <input type="hidden" name="pres_type" value='' />
703: <input type="hidden" name="pres_marker" value='' />
704: <input type="hidden" name="startdate" value='$today' />
705: <input type="hidden" name="enddate" value='$halfyear' />
706: </p><p>
707: <a
708: href="javascript:pjump('date_start','Enrollment Starting Date',document.studentform.startdate.value,'start','studentform.pres','dateset');"
709: >Set Starting Date</a>
710: </p><p>
711: <a
712: href="javascript:pjump('date_end','Enrollment Ending Date',document.studentform.enddate.value,'end','studentform.pres','dateset');"
713: >Set Ending Date</a>
714: </p>
715: <h3>ID/Student Number</h3>
716: <p>
717: ID/Student Number: <input type="text" name="cstid" size="10">
718: </p><p>
719: <input type="checkbox" name="forceid" value="yes">
720: Disable ID/Student Number Safeguard and Force Change of Conflicting IDs
721: (only do if you know what you are doing)
722: </p><p>
723: <input type="button" onClick="verify(this.form)" value="Enroll as student">
724: </p>
725: END
726: return;
727: }
728:
729: # =================================================== get the current classlist
730: sub get_current_classlist {
731: my $r = shift;
732: # Call DownloadClasslist
733: my $cid = $ENV{'request.course.id'};
734: my $c = $r->connection;
735: my $classlisthash = &Apache::loncoursedata::DownloadClasslist
736: ($cid,'Not downloaded',$c);
737: # Call ProcessClasslist
738: my %cache;
739: my @students = &Apache::loncoursedata::ProcessClasslist(\%cache,
740: $classlisthash,
741: $cid,$c);
742: return (\@students,\%cache);
743: }
744:
745: # ========================================================= Menu Phase Two Drop
746: sub print_drop_menu {
747: my $r=shift;
748: $r->print("<h3>Drop Students</h3>");
749: my $cid=$ENV{'request.course.id'};
750: my ($student_array,$student_data)=&get_current_classlist($r);
751: if (! scalar(@$student_array)) {
752: $r->print("There are no students currently enrolled.\n");
753: return;
754: }
755: # Print out the available choices
756: &show_drop_list($student_array,$student_data,$r);
757: return;
758: }
759:
760: # ============================================== view classlist
761: sub print_html_classlist {
762: my $r=shift;
763: $r->print(<<END);
764: <p>
765: <font size="+1">Current Classlist</font>
766: <font size="+1"><a href="/adm/dropadd?action=classlist&state=csv">CSV format</a></font>
767: </p>
768: END
769: my $cid=$ENV{'request.course.id'};
770: my ($student_array,$student_data)=&get_current_classlist($r);
771: if (! scalar(@$student_array)) {
772: $r->print("There are no students currently enrolled.\n");
773: } else {
774: # Print out the available choices
775: if ($ENV{'form.action'} eq 'modifystudent') {
776: &show_class_list($r,'view','modify',$student_array,$student_data);
777: } else {
778: &show_class_list($r,'view','aboutme',$student_array,$student_data);
779: }
780: }
781: }
782:
783: # ============================================== view classlist
784: sub print_csv_classlist {
785: my $r=shift;
786: my $cid=$ENV{'request.course.id'};
787: my ($student_array,$student_data)=&get_current_classlist($r);
788: if (! scalar(@$student_array)) {
789: $r->print("There are no students currently enrolled.\n");
790: } else {
791: &show_class_list($r,'csv','nolink',$student_array,$student_data);
792: }
793: }
794:
795: # =================================================== Show student list to drop
796: sub show_class_list {
797: my ($r,$mode,$linkto,$students,$student_data)=@_;
798: my $cid=$ENV{'request.course.id'};
799: # Print out header
800: if ($mode eq 'view') {
801: if ($linkto eq 'aboutme') {
802: $r->print('Select a user name to view the users page.');
803: } elsif ($linkto eq 'modify') {
804: $r->print('Select a user name to modify the students information');
805: }
806: $r->print(<<END);
807: <p>
808: <table border=2>
809: <tr><th>username</th><th>domain</th><th>ID</th>
810: <th>student name</th><th>section</th></tr>
811: END
812: } elsif ($mode eq 'csv') {
813: $r->print('"'.join('","',("username","domain","ID","student name",
814: "section")).'"'."\n");
815: }
816: foreach my $student (@$students) {
817: my $username = $student_data->{$student.':username'};
818: my $domain = $student_data->{$student.':domain'};
819: my $section = $student_data->{$student.':section'};
820: my $name = $student_data->{$student.':fullname'};
821: my $status = $student_data->{$student.':Status'};
822: my $id = $student_data->{$student.':id'};
823: next if ($status ne 'Active');
824: if ($mode eq 'view') {
825: $r->print("<tr>\n <td>\n ");
826: if ($linkto eq 'nothing') {
827: $r->print($username);
828: } elsif ($linkto eq 'aboutme') {
829: $r->print(&Apache::loncommon::aboutmewrapper($username,
830: $username,
831: $domain));
832: } elsif ($linkto eq 'modify') {
833: $r->print('<a href="/adm/dropadd?action=modifystudent'.
834: '&state=selected'.'&sname='.$username.
835: '&sdom='.$domain.'">'.$username."</a>\n");
836: }
837: $r->print(<<"END");
838: </td>
839: <td>$domain</td>
840: <td>$id</td>
841: <td>$name</td>
842: <td>$section</td>
843: </tr>
844: END
845: } elsif ($mode eq 'csv') {
846: # no need to bother with $linkto
847: my @line = ();
848: foreach ($username,$domain,$id,$name,$section) {
849: push @line,&Apache::loncommon::csv_translate($_);
850: }
851: my $tmp = $";
852: $" = '","';
853: $r->print("\"@line\"\n");
854: $" = $tmp;
855: }
856: }
857: $r->print('</table><br>') if ($mode eq 'view');
858: }
859:
860:
861: #
862: # print out form for modification of a single students data
863: #
864: sub print_modify_student_form {
865: my $r = shift();
866: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
867: ['sdom','sname']);
868:
869: my $sname = $ENV{'form.sname'};
870: my $sdom = $ENV{'form.sdom'};
871: # determine the students name information
872: my %info=&Apache::lonnet::get('environment',
873: ['firstname','middlename',
874: 'lastname','generation'],
875: $sdom, $sname);
876: my ($tmp) = keys(%info);
877: if ($tmp =~ /^(con_lost|error|no_such_host)/i) {
878: $r->print('<font color="#ff0000" size="+2">Error</font>'.
879: '<p>'.
880: 'Unable to retrieve environment data for '.$sname.
881: 'in domain '.$sdom.'</p><p>'.
882: 'Please contact your LON-CAPA administrator '.
883: 'regarding this situation.</p></body></html>');
884: return;
885: }
886: # determine the students starting and ending times and section
887: my ($starttime,$endtime,$section) = &get_enrollment_data($sname,$sdom);
888: # Deal with date forms
889: my $startdateform = &Apache::lonhtmlcommon::date_setter('studentform',
890: 'startdate',
891: $starttime);
892: my $enddateform = &Apache::lonhtmlcommon::date_setter('studentform',
893: 'enddate',
894: $endtime);
895: # Make sure student is enrolled in course
896: $r->print(<<END);
897: <input type="hidden" name="slogin" value="$sname" />
898: <input type="hidden" name="sdomain" value="$sdom" />
899: <input type="hidden" name="action" value="modifystudent" />
900: <input type="hidden" name="state" value="done" />
901: <h2>Modify Enrollment for $info{'firstname'} $info{'middlename'}
902: $info{'lastname'} $info{'generation'}, $sname\@$sdom</h2>
903: <p>
904: <b>Student Name</b>
905: <table>
906: <tr><th>First</th><th>Middle</th><th>Last</th><th>Generation</th></tr>
907: <tr><td>
908: <input type="text" name="firstname" value="$info{'firstname'}" /></td><td>
909: <input type="text" name="middlename" value="$info{'middlename'}" /></td><td>
910: <input type="text" name="lastname" value="$info{'lastname'}" /></td><td>
911: <input type="text" name="generation" value="$info{'generation'}" /></td></tr>
912: </table>
913: </p><p>
914: <b>Section</b>: <input type="text" name="section" value="$section" size="4"/>
915: </p><p>
916: <table>
917: <tr><td align="right"><b>Starting Date:</b></td><td>$startdateform</td></tr>
918: <tr><td align="right"><b>Ending Date:</b></td><td>$enddateform</td></tr>
919: </table>
920: </p>
921: <input type="submit" value="Submit Modifications" />
922: </body></html>
923: END
924: return;
925: }
926:
927: #
928: # modify a single students section
929: #
930: sub modify_single_student {
931: my $r = shift;
932: # make sure user can modify student data?
933: my $firstname = $ENV{'form.firstname'};
934: my $middlename = $ENV{'form.middlename'};
935: my $lastname = $ENV{'form.lastname'};
936: my $generation = $ENV{'form.generation'};
937: my $section = $ENV{'form.section'};
938: my $courseid = $ENV{'request.course.id'};
939: my $sname = $ENV{'form.slogin'};
940: my $sdom = $ENV{'form.sdomain'};
941: my $starttime = &Apache::lonhtmlcommon::get_date_from_form('startdate',
942: time);
943: my $endtime = &Apache::lonhtmlcommon::get_date_from_form('enddate',
944: time);
945: my $displayable_starttime = localtime($starttime);
946: my $displayable_endtime = localtime($endtime);
947: # talk to the user about what we are going to do
948: $r->print(<<END);
949: Modifying data for user: $sname \@ $sdom <br />
950: <h3>Student Information</h3>
951: <table>
952: <tr><td>First name </td><td> $firstname </td></tr>
953: <tr><td>Middle name </td><td> $middlename </td></tr>
954: <tr><td>Last name </td><td> $lastname </td></tr>
955: <tr><td>Generation </td><td> $generation </td></tr>
956: </table>
957: <h3>Role Information</h3>
958: <table>
959: <tr><td>Section </td><td> $section </td></tr>
960: <tr><td>Start Time </td><td> $displayable_starttime </td></tr>
961: <tr><td>End Time </td><td> $displayable_endtime </td></tr>
962: </table>
963: END
964: # send request(s) to modify data
965: my $roleresults = 'refused';
966: #my $roleresults = &Apache::lonnet::assignrole($sdom,$sname,
967: # $courseid.'/'.$section,
968: # 'st',
969: # $endtime,$starttime);
970: if ($roleresults =~/refused/) {
971: $r->print("Your request to change the role information for this ".
972: "student was refused.");
973: } elsif ($roleresults !~ /ok/) {
974: $r->print("An error occurred during the attempt to change the role".
975: " information for this student. The error reported was ".
976: $roleresults);
977: } else { # everything is okay!
978: $r->print("Student role updated successfully.");
979: }
980: #
981: $r->print(<<END);
982: </body></html>
983: END
984: return;
985: }
986:
987: sub get_enrollment_data {
988: my ($sname,$sdomain) = @_;
989: my $courseid = $ENV{'request.course.id'};
990: $courseid =~ s:_:/:g;
991: my %roles = &Apache::lonnet::dump('roles',$sdomain,$sname);
992: my ($tmp) = keys(%roles);
993: # Bail out if we were unable to get the students roles
994: return "666" if ($tmp =~ /^(con_lost|error|no_such_host)/i);
995: # Go through the roles looking for enrollment in this course
996: my ($end,$start) = (undef,undef);
997: my $section = '';
998: my $count = scalar(keys(%roles));
999: while (my ($course,$role) = each(%roles)) {
1000: &Apache::lonnet::logthis('course = '.$course.' role = '.$role);
1001: if ($course=~ /^\/$courseid\/*\s*(\w+)*_st$/ ) {
1002: #
1003: # Get active role
1004: $section=$1;
1005: (undef,$end,$start)=split(/\_/,$role);
1006: my $now=time;
1007: my $notactive=0;
1008: if ($start) {
1009: if ($now<$start) { $notactive=1; }
1010: }
1011: if ($end) {
1012: if ($now>$end) { $notactive=1; }
1013: }
1014: unless ($notactive) { return ($start,$end,$section); }
1015: }
1016: }
1017: return ($start,$end,$section);
1018: }
1019:
1020: # =================================================== Show student list to drop
1021: sub show_drop_list {
1022: my ($students,$student_data,$r)=@_;
1023: my $cid=$ENV{'request.course.id'};
1024: $r->print(<<'END');
1025: <input type="hidden" name="action" value="drop" />
1026: <input type="hidden" name="state" value="done" />
1027: <script>
1028: function checkAll(field) {
1029: for (i = 0; i < field.length; i++)
1030: field[i].checked = true ;
1031: }
1032:
1033: function uncheckAll(field) {
1034: for (i = 0; i < field.length; i++)
1035: field[i].checked = false ;
1036: }
1037: </script>
1038: <p>
1039: <input type="hidden" name="phase" value="four">
1040: <table border=2>
1041: <tr><th> </th><th>username</th><th>domain</th>
1042: <th>ID</th><th>student name</th><th>section</th></tr>
1043: END
1044: foreach my $student (@$students) {
1045: my $username = $student_data->{$student.':username'};
1046: my $domain = $student_data->{$student.':domain'};
1047: my $section = $student_data->{$student.':section'};
1048: my $name = $student_data->{$student.':fullname'};
1049: my $status = $student_data->{$student.':Status'};
1050: my $id = $student_data->{$student.':id'};
1051: next if ($status ne 'Active');
1052: #
1053: $r->print(<<"END");
1054: <tr>
1055: <td><input type="checkbox" name="droplist" value="$student"></td>
1056: <td>$username</td>
1057: <td>$domain</td>
1058: <td>$id</td>
1059: <td>$name</td>
1060: <td>$section</td>
1061: </tr>
1062: END
1063: }
1064: $r->print('</table><br>');
1065: $r->print(<<"END");
1066: </p><p>
1067: <input type="button" value="check all" onclick="javascript:checkAll(document.studentform.droplist)">
1068: <input type="button" value="uncheck all" onclick="javascript:uncheckAll(document.studentform.droplist)">
1069: <p><input type=submit value="Drop Students"></p>
1070: END
1071: return;
1072: }
1073:
1074: #
1075: # Print out the initial form to get the courselist file
1076: #
1077: sub print_first_courselist_upload_form {
1078: my $r=shift;
1079: my $upfile_select=&Apache::loncommon::upfile_select_html();
1080: my $create_classlist_help =
1081: &Apache::loncommon::help_open_topic("Course_Create_Class_List",
1082: "How do I create a class list from a spreadsheet");
1083: my $create_csv_help =
1084: &Apache::loncommon::help_open_topic("Course_Convert_To_CSV",
1085: "How do I create a CSV file from a spreadsheet");
1086: $r->print(<<ENDUPFORM);
1087: <input type=hidden name=phase value=two>
1088: <h3>Upload a courselist</h3>
1089: $upfile_select
1090: <p>
1091: <input type=submit name="fileupload" value="Upload Courselist">
1092: <input type="hidden" name="action" value="upload" />
1093: <input type="hidden" name="state" value="got_file" />
1094: </p>
1095: $create_classlist_help <br />
1096: $create_csv_help
1097: </body></html>
1098: ENDUPFORM
1099: return;
1100: }
1101:
1102: # ================================================= Drop/Add from uploaded file
1103: sub upfile_drop_add {
1104: my $r=shift;
1105: &Apache::loncommon::load_tmp_file($r);
1106: my @studentdata=&Apache::loncommon::upfile_record_sep();
1107: my @keyfields = split(/\,/,$ENV{'form.keyfields'});
1108: my $cid = $ENV{'request.course.id'};
1109: my %fields=();
1110: for (my $i=0; $i<=$ENV{'form.nfields'}; $i++) {
1111: if ($ENV{'form.upfile_associate'} eq 'reverse') {
1112: if ($ENV{'form.f'.$i} ne 'none') {
1113: $fields{$keyfields[$i]}=$ENV{'form.f'.$i};
1114: }
1115: } else {
1116: $fields{$ENV{'form.f'.$i}}=$keyfields[$i];
1117: }
1118: }
1119: #
1120: my $startdate = $ENV{'form.startdate'};
1121: my $enddate = $ENV{'form.enddate'};
1122: if ($startdate=~/\D/) { $startdate=''; }
1123: if ($enddate=~/\D/) { $enddate=''; }
1124: # Determine domain and desired host (home server)
1125: my $domain=$ENV{'form.lcdomain'};
1126: my $desiredhost = $ENV{'form.lcserver'};
1127: if (lc($desiredhost) eq 'default') {
1128: $desiredhost = undef;
1129: } else {
1130: my %home_servers = &Apache::loncommon::get_library_servers($domain);
1131: if (! exists($home_servers{$desiredhost})) {
1132: $r->print('<font color="#ff0000">Error:</font>'.
1133: 'Invalid home server specified');
1134: return;
1135: }
1136: }
1137: # Determine authentication mechanism
1138: my $amode = '';
1139: my $genpwd = '';
1140: if ($ENV{'form.login'} eq 'krb') {
1141: $amode='krb';
1142: $amode.=$ENV{'form.krbver'};
1143: $genpwd=$ENV{'form.krbarg'};
1144: } elsif ($ENV{'form.login'} eq 'int') {
1145: $amode='internal';
1146: if ((defined($ENV{'form.intarg'})) && ($ENV{'form.intarg'})) {
1147: $genpwd=$ENV{'form.intarg'};
1148: }
1149: } elsif ($ENV{'form.login'} eq 'loc') {
1150: $amode='localauth';
1151: if ((defined($ENV{'form.locarg'})) && ($ENV{'form.locarg'})) {
1152: $genpwd=$ENV{'form.locarg'};
1153: }
1154: }
1155: unless (($domain=~/\W/) || ($amode eq '')) {
1156: #######################################
1157: ## Enroll Students ##
1158: #######################################
1159: $r->print('<h3>Enrolling Students</h3>');
1160: my $count=0;
1161: my $flushc=0;
1162: my %student=();
1163: # Get new classlist
1164: foreach (@studentdata) {
1165: my %entries=&Apache::loncommon::record_sep($_);
1166: # Determine student name
1167: unless (($entries{$fields{'username'}} eq '') ||
1168: (!defined($entries{$fields{'username'}}))) {
1169: my ($fname, $mname, $lname,$gen) = ('','','','');
1170: if (defined($fields{'names'})) {
1171: ($lname,$fname,$mname)=($entries{$fields{'names'}}=~
1172: /([^\,]+)\,\s*(\w+)\s*(.*)$/);
1173: } else {
1174: if (defined($fields{'fname'})) {
1175: $fname=$entries{$fields{'fname'}};
1176: }
1177: if (defined($fields{'mname'})) {
1178: $mname=$entries{$fields{'mname'}};
1179: }
1180: if (defined($fields{'lname'})) {
1181: $lname=$entries{$fields{'lname'}};
1182: }
1183: if (defined($fields{'gen'})) {
1184: $gen=$entries{$fields{'gen'}};
1185: }
1186: }
1187: if ($entries{$fields{'username'}}=~/\W/) {
1188: $r->print('<p><b>Unacceptable username: '.
1189: $entries{$fields{'username'}}.' for user '.
1190: $fname.' '.$mname.' '.$lname.' '.$gen.'</b><p>');
1191: } else {
1192: # determine section number
1193: my $sec='';
1194: my $username=$entries{$fields{'username'}};
1195: if (defined($fields{'sec'})) {
1196: if (defined($entries{$fields{'sec'}})) {
1197: $sec=$entries{$fields{'sec'}};
1198: }
1199: }
1200: # determine student id number
1201: my $id='';
1202: if (defined($fields{'id'})) {
1203: if (defined($entries{$fields{'id'}})) {
1204: $id=$entries{$fields{'id'}};
1205: }
1206: $id=~tr/A-Z/a-z/;
1207: }
1208: # determine student password
1209: my $password='';
1210: if ($genpwd) {
1211: $password=$genpwd;
1212: } else {
1213: if (defined($fields{'ipwd'})) {
1214: if ($entries{$fields{'ipwd'}}) {
1215: $password=$entries{$fields{'ipwd'}};
1216: }
1217: }
1218: }
1219: if ($password) {
1220: &modifystudent($domain,$username,$cid,$sec,
1221: $desiredhost);
1222: my $reply=&Apache::lonnet::modifystudent
1223: ($domain,$username,$id,$amode,$password,
1224: $fname,$mname,$lname,$gen,$sec,$enddate,
1225: $startdate,$ENV{'form.forceid'},$desiredhost);
1226: if ($reply ne 'ok') {
1227: $r->print('<p><b>'.
1228: 'Error enrolling '.$username.': '.
1229: $reply.'</b></p>');
1230: } else {
1231: $count++; $flushc++;
1232: $student{$username}=1;
1233: $r->print('. ');
1234: if ($flushc>15) {
1235: $r->rflush;
1236: $flushc=0;
1237: }
1238: }
1239: } else {
1240: $r->print("<p><b>No password for $username</b><p>");
1241: }
1242: }
1243: }
1244: } # end of foreach (@studentdata)
1245: $r->print('<p>Processed Students: '.$count);
1246: #####################################
1247: # Drop students #
1248: #####################################
1249: if ($ENV{'form.fullup'} eq 'yes') {
1250: $r->print('<h3>Dropping Students</h3>');
1251: # Get current classlist
1252: my ($error,%currentlist)=&get_current_classlist($r);
1253: if (defined($error)) {
1254: $r->print('<pre>ERROR:$error</pre>');
1255: }
1256: if (defined(%currentlist)) {
1257: # Drop the students
1258: foreach (@studentdata) {
1259: my %entries=&Apache::loncommon::record_sep($_);
1260: unless (($entries{$fields{'username'}} eq '') ||
1261: (!defined($entries{$fields{'username'}}))) {
1262: delete($currentlist{$entries{$fields{'username'}}.
1263: ':'.$domain});
1264: }
1265: }
1266: # Print out list of dropped students
1267: &show_drop_list($r,%currentlist);
1268: } else {
1269: $r->print("There are no students currently enrolled.\n");
1270: }
1271: }
1272: } # end of unless
1273: }
1274:
1275: ###################################################################
1276: ###################################################################
1277:
1278: =pod
1279:
1280: =item &drop_students
1281:
1282: Inputs: \@droplist, a pointer to an array of students to drop.
1283: Students should be in format of studentname:studentdomain
1284:
1285: Returns: $errors, a string describing any errors encountered.
1286: $successes, a string describing the successful dropping of students.
1287:
1288: =cut
1289:
1290: ###################################################################
1291: ###################################################################
1292: sub drop_students {
1293: my @droplist = @{shift()};
1294: my $courseid = $ENV{'request.course.id'};
1295: my $successes = '';
1296: my $errors = '';
1297: foreach (@droplist) {
1298: my ($sname,$sdom)=split(/:/,$_);
1299: my $result = &drop_student($sname,$sdom,$courseid);
1300: if ($result !~ /ok/) {
1301: $errors .= "Error dropping $sname\@$sdom: $result\n";
1302: } else {
1303: $successes .= "Dropped $sname\@$sdom\n";
1304: }
1305: }
1306: return ($errors,$successes);
1307: }
1308: ###################################################################
1309: ###################################################################
1310:
1311:
1312: # ================================================================== Phase four
1313: sub drop_student_list {
1314: my $r=shift;
1315: my $count=0;
1316: my @droplist;
1317: if (ref($ENV{'form.droplist'})) {
1318: @droplist = @{$ENV{'form.droplist'}};
1319: } else {
1320: @droplist = ($ENV{'form.droplist'});
1321: }
1322: foreach (@droplist) {
1323: my ($uname,$udom)=split(/\:/,$_);
1324: my $result = &modifystudent($udom,$uname,$ENV{'request.course.id'});
1325: if ($result eq 'ok' || $result eq 'ok:') {
1326: $r->print('Dropped '.$uname.' at '.$udom.'<br>');
1327: } else {
1328: $r->print('Error dropping '.$uname.' at '.$udom.': '.$result.
1329: '<br />');
1330: }
1331: $count++;
1332: }
1333: $r->print('<p><b>Dropped '.$count.' student(s).</b>');
1334: $r->print('<p>Re-enrollment will re-activate data.');
1335: }
1336:
1337: ###################################################################
1338: ###################################################################
1339:
1340: =pod
1341:
1342: =item &handler
1343:
1344: The typical handler you see in all these modules. Takes $r, the
1345: http request, as an argument.
1346:
1347: The response to the request is governed by two form variables
1348:
1349: form.action form.state response
1350: ---------------------------------------------------
1351: undefined undefined print main menu
1352: upload undefined print courselist upload menu
1353: upload got_file deal with uploaded file,
1354: print the upload managing menu
1355: upload enrolling enroll students based on upload
1356: drop undefined print the classlist ready to drop
1357: drop done drop the selected students
1358: enrollstudent undefined print single student enroll menu
1359: enrollstudent enrolling enroll student
1360: classlist undefined print html classlist
1361: classlist csv print csv classlist
1362: modifystudent undefined print classlist to select student to modify
1363: modifystudent selected print modify student menu
1364: modifystudent done make modifications to student record
1365:
1366: =cut
1367:
1368: ###################################################################
1369: ###################################################################
1370: sub handler {
1371: my $r=shift;
1372: if ($r->header_only) {
1373: $r->content_type('text/html');
1374: $r->send_http_header;
1375: return OK;
1376: }
1377: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
1378: ['action','state']);
1379: # Needs to be in a course
1380: if (! (($ENV{'request.course.fn'}) &&
1381: (&Apache::lonnet::allowed('cst',$ENV{'request.course.id'})))) {
1382: # Not in a course, or not allowed to modify parms
1383: $ENV{'user.error.msg'}=
1384: "/adm/dropadd:cst:0:0:Cannot drop or add students";
1385: return HTTP_NOT_ACCEPTABLE;
1386: }
1387: #
1388: # Only output the header information if they did not request csv format
1389: #
1390: if (exists($ENV{'form.state'}) && ($ENV{'form.state'} eq 'csv')) {
1391: $r->content_type('text/csv');
1392: } else {
1393: # Start page
1394: $r->content_type('text/html');
1395: $r->send_http_header;
1396: $r->print(&header());
1397: }
1398: #
1399: # Main switch on form.action and form.state, as appropriate
1400: if (! exists($ENV{'form.action'})) {
1401: &print_main_menu($r);
1402: } elsif ($ENV{'form.action'} eq 'upload') {
1403: if (! exists($ENV{'form.state'})) {
1404: &print_first_courselist_upload_form($r);
1405: } elsif ($ENV{'form.state'} eq 'got_file') {
1406: &print_upload_manager_form($r);
1407: } elsif ($ENV{'form.state'} eq 'enrolling') {
1408: if ($ENV{'form.datatoken'}) {
1409: &upfile_drop_add($r);
1410: } else {
1411: # Hmmm, this is an error
1412: }
1413: } else {
1414: &print_first_courselist_upload_form($r);
1415: }
1416: } elsif ($ENV{'form.action'} eq 'drop') {
1417: if (! exists($ENV{'form.state'})) {
1418: &print_drop_menu($r);
1419: } elsif ($ENV{'form.state'} eq 'done') {
1420: &drop_student_list($r);
1421: } else {
1422: &menu_phase_two_drop($r);
1423: }
1424: } elsif ($ENV{'form.action'} eq 'enrollstudent') {
1425: if (! exists($ENV{'form.state'})) {
1426: &print_enroll_single_student_form($r);
1427: } elsif ($ENV{'form.state'} eq 'enrolling') {
1428: &enroll_single_student($r);
1429: } else {
1430: &print_enroll_single_student_form($r);
1431: }
1432: } elsif ($ENV{'form.action'} eq 'classlist') {
1433: if (! exists($ENV{'form.state'})) {
1434: &print_html_classlist($r);
1435: } elsif ($ENV{'form.state'} eq 'csv') {
1436: &print_csv_classlist($r);
1437: } else {
1438: &print_html_classlist($r);
1439: }
1440: } elsif ($ENV{'form.action'} eq 'modifystudent') {
1441: if (! exists($ENV{'form.state'})) {
1442: &print_html_classlist($r);
1443: } elsif ($ENV{'form.state'} eq 'selected') {
1444: &print_modify_student_form($r);
1445: } elsif ($ENV{'form.state'} eq 'done') {
1446: &modify_single_student($r);
1447: } else {
1448: &print_html_classlist($r);
1449: }
1450: } else {
1451: # We should not end up here, but I guess it is possible
1452: &Apache::lonnet::logthis("Undetermined state in londropadd.pm. ".
1453: "form.action = ".$ENV{'form.action'}.
1454: "Someone should fix this.");
1455: &print_main_menu($r);
1456: }
1457: #
1458: # Finish up
1459: if (exists($ENV{'form.state'}) && ($ENV{'form.state'} eq 'csv')) {
1460: $r->print("\n");
1461: } else {
1462: $r->print('</form></body></html>');
1463: }
1464: return OK;
1465: }
1466:
1467: ###################################################################
1468: ###################################################################
1469:
1470: 1;
1471: __END__
1472:
1473:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>