File:
[LON-CAPA] /
loncom /
interface /
Attic /
londropadd.pm
Revision
1.130:
download - view:
text,
annotated -
select for diffs
Fri Jun 3 16:27:26 2005 UTC (19 years, 2 months ago) by
www
Branches:
MAIN
CVS tags:
version_2_0_X,
version_2_0_2,
version_2_0_1,
version_2_0_0,
version_1_99_3,
version_1_99_2,
version_1_99_1,
version_1_99_0,
HEAD
Bug #3805: explain authentication mechanisms
1: # The LearningOnline Network with CAPA
2: # Handler to drop and add students in courses
3: #
4: # $Id: londropadd.pm,v 1.130 2005/06/03 16:27:26 www 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: #
29: ###############################################################
30: ##############################################################
31:
32: package Apache::londropadd;
33:
34: use strict;
35: use Apache::lonnet;
36: use Apache::loncommon();
37: use Apache::lonhtmlcommon();
38: use Apache::Constants qw(:common :http REDIRECT);
39: use Spreadsheet::WriteExcel;
40: use Apache::lonstathelpers();
41: use Apache::lonlocal;
42:
43: ###############################################################
44: ###############################################################
45: sub header {
46: my $html=&Apache::lonxml::xmlbegin();
47: my $bodytag=&Apache::loncommon::bodytag('Enrollment Manager');
48: my $title = &mt('LON-CAPA Enrollment Manager');
49: return(<<ENDHEAD);
50: $html
51: <head>
52: <title>$title</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 (defined($csec) && $section eq $csec) {
82: $result .= 'ok:';
83: } elsif ( ((!$section) && (!$csec)) || ($section ne $csec) ) {
84: my (undef,$end,$start)=split(/\_/,$roles{$course});
85: my $now=time;
86: # if this is an active role
87: if (!($start && ($now<$start)) || !($end && ($now>$end))) {
88: my $reply=&Apache::lonnet::modifystudent
89: # dom name id mode pass f m l g
90: ($udom,$unam,'', '', '',undef,undef,undef,undef,
91: $section,time,undef,undef,$desiredhost);
92: $result .= $reply.':';
93: }
94: }
95: }
96: }
97: if ($result eq '') {
98: $result = 'Unable to find section for this student';
99: } else {
100: $result =~ s/(ok:)+/ok/g;
101: }
102: return $result;
103: }
104:
105: ###############################################################
106: ###############################################################
107: # build a domain and server selection form
108: sub domain_form {
109: my ($defdom) = @_;
110: # Set up domain and server selection forms
111: #
112: # Get the domains
113: my @domains = &Apache::loncommon::get_domains();
114: # build up the menu information to be passed to
115: # &Apache::loncommon::linked_select_forms
116: my %select_menus;
117: foreach my $dom (@domains) {
118: # set up the text for this domain
119: $select_menus{$dom}->{'text'}= $dom;
120: # we want a choice of 'default' as the default in the second menu
121: $select_menus{$dom}->{'default'}= 'default';
122: $select_menus{$dom}->{'select2'}->{'default'} = 'default';
123: # Now build up the other items in the second menu
124: my %servers = &Apache::loncommon::get_library_servers($dom);
125: foreach my $server (keys(%servers)) {
126: $select_menus{$dom}->{'select2'}->{$server}
127: = "$server $servers{$server}";
128: }
129: }
130: my $result = &Apache::loncommon::linked_select_forms
131: ('studentform',' with home server ',$defdom,
132: 'lcdomain','lcserver',\%select_menus);
133: return $result;
134: }
135:
136: ###############################################################
137: ###############################################################
138: # Menu Phase One
139: sub print_main_menu {
140: my ($r,$enrl_permission,$view_permission)=@_;
141: #
142: my ($cdom,$cnum) = split/_/,$env{'request.course.id'};
143: my @menu =
144: (
145: { text => 'Upload a class list',
146: help => 'Course_Create_Class_List',
147: action => 'upload',
148: permission => $enrl_permission,
149: },
150: { text => 'Enroll a single student',
151: help => 'Course_Add_Student',
152: action => 'enrollstudent',
153: permission => $enrl_permission,
154: },
155: { text => 'Modify student data',
156: help => 'Course_Modify_Student_Data',
157: action => 'modifystudent',
158: permission => $enrl_permission,
159: },
160: { text => 'View Class List',
161: help => 'Course_View_Class_List',
162: action => 'classlist',
163: permission => $view_permission,
164: },
165: { text => 'Drop Students',
166: help => 'Course_Drop_Student',
167: action => 'drop',
168: permission => $enrl_permission,
169: },
170: { text => 'Automated Enrollment Manager',
171: permission => &Apache::lonnet::auto_run($cnum,$cdom),
172: url => '/adm/populate',
173: },
174: );
175: my $menu_html = '';
176: foreach my $menu_item (@menu) {
177: next if (! $menu_item->{'permission'});
178: $menu_html.='<p>';
179: $menu_html.='<font size="+1">';
180: if (exists($menu_item->{'url'})) {
181: $menu_html.=qq{<a href="$menu_item->{'url'}">};
182: } else {
183: $menu_html.=
184: qq{<a href="/adm/dropadd?action=$menu_item->{'action'}">};
185: }
186: $menu_html.= &mt($menu_item->{'text'}).'</a></font>';
187: if (exists($menu_item->{'help'})) {
188: $menu_html.=
189: &Apache::loncommon::help_open_topic($menu_item->{'help'});
190: }
191: $menu_html.='</p>'.$/;
192: }
193: $r->print($menu_html);
194: return;
195: }
196:
197: ###############################################################
198: ###############################################################
199: sub hidden_input {
200: my ($name,$value) = @_;
201: return '<input type="hidden" name="'.$name.'" value="'.$value.'" />'."\n";
202: }
203:
204: sub print_upload_manager_header {
205: my ($r,$datatoken,$distotal,$krbdefdom)=@_;
206: my $javascript;
207: #
208: if (! exists($env{'form.upfile_associate'})) {
209: $env{'form.upfile_associate'} = 'forward';
210: }
211: if ($env{'form.associate'} eq 'Reverse Association') {
212: if ( $env{'form.upfile_associate'} ne 'reverse' ) {
213: $env{'form.upfile_associate'} = 'reverse';
214: } else {
215: $env{'form.upfile_associate'} = 'forward';
216: }
217: }
218: if ($env{'form.upfile_associate'} eq 'reverse') {
219: $javascript=&upload_manager_javascript_reverse_associate();
220: } else {
221: $javascript=&upload_manager_javascript_forward_associate();
222: }
223: #
224: # Deal with restored settings
225: my $password_choice = '';
226: if (exists($env{'form.ipwd_choice'}) &&
227: $env{'form.ipwd_choice'} ne '') {
228: # If a column was specified for password, assume it is for an
229: # internal password. This is a bug waiting to be filed (could be
230: # local or krb auth instead of internal) but I do not have the
231: # time to mess around with this now.
232: $password_choice = 'int';
233: }
234: #
235: my $javascript_validations=&javascript_validations('auth',$krbdefdom,
236: $password_choice);
237: my $checked=(($env{'form.noFirstLine'})?' checked="1"':'');
238: $r->print('<h3>'.&mt('Uploading Class List')."</h3>\n".
239: "<hr>\n".
240: '<h3>'.&mt('Identify fields')."</h3>\n");
241: $r->print("<p>\n".
242: &mt('Total number of records found in file: [_1].',$distotal).
243: "\n".
244: "</p><hr>\n");
245: $r->print(&mt('Enter as many fields as you can. The system will inform you and bring you back to this page if the data selected is insufficient to enroll students in your class.')."<hr>\n");
246: $r->print(&hidden_input('action','upload').
247: &hidden_input('state','got_file').
248: &hidden_input('associate','').
249: &hidden_input('datatoken',$datatoken).
250: &hidden_input('fileupload',$env{'form.fileupload'}).
251: &hidden_input('upfiletype',$env{'form.upfiletype'}).
252: &hidden_input('upfile_associate',$env{'form.upfile_associate'}));
253: $r->print('<input type="button" value="Reverse Association" '.
254: 'name="'.&mt('Reverse Association').'" '.
255: 'onClick="javascript:this.form.associate.value=\'Reverse Association\';submit(this.form);" />');
256: $r->print('<input type="checkbox" name="noFirstLine" $checked />'.
257: &mt('Ignore First Line'));
258: $r->print("<hr />\n".
259: '<script type="text/javascript" language="Javascript">'."\n".
260: $javascript."\n".$javascript_validations.'</script>');
261: }
262:
263: ###############################################################
264: ###############################################################
265: sub javascript_validations {
266: my ($mode,$krbdefdom,$curr_authtype,$curr_authfield)=@_;
267: my $authheader;
268: if ($mode eq 'auth') {
269: my %param = ( formname => 'studentform',
270: kerb_def_dom => $krbdefdom,
271: curr_authtype => $curr_authtype);
272: $authheader = &Apache::loncommon::authform_header(%param);
273: } elsif ($mode eq 'createcourse') {
274: my %param = ( formname => 'ccrs',
275: kerb_def_dom => $krbdefdom,
276: curr_authtype => $curr_authtype );
277: $authheader = &Apache::loncommon::authform_header(%param);
278: } elsif ($mode eq 'modifycourse') {
279: my %param = ( formname => 'cmod',
280: kerb_def_dom => $krbdefdom,
281: mode => 'modifycourse',
282: curr_authtype => $curr_authtype,
283: curr_autharg => $curr_authfield );
284: $authheader = &Apache::loncommon::authform_header(%param);
285: }
286:
287:
288: my %alert = &Apache::lonlocal::texthash
289: (username => 'You need to specify the username field.',
290: authen => 'You must choose an authentication type.',
291: krb => 'You need to specify the Kerberos domain.',
292: ipass => 'You need to specify the initial password.',
293: name => 'The optional name field was not specified.',
294: snum => 'The optional student number field was not specified.',
295: section => 'The optional section or group field was not specified.',
296: email => 'The optional email address field was not specified.',
297: continue => 'Continue enrollment?',
298: );
299:
300: # my $pjump_def = &Apache::lonhtmlcommon::pjump_javascript_definition();
301: my $function_name =(<<END);
302: function verify_message (vf,founduname,foundpwd,foundname,foundid,foundsec,foundemail) {
303: END
304: my $auth_checks;
305: if ($mode eq 'createcourse') {
306: $auth_checks .= (<<END);
307: if (vf.autoadds[0].checked == true) {
308: if (current.radiovalue == null || current.radiovalue == 'nochange') {
309: alert('$alert{'authen'}');
310: return;
311: }
312: }
313: END
314: } else {
315: $auth_checks .= (<<END);
316: var foundatype=0;
317: if (founduname==0) {
318: alert('$alert{'username'}');
319: return;
320: }
321: // alert('current.radiovalue = '+current.radiovalue);
322: if (current.radiovalue == null || current.radiovalue == '' || current.radiovalue == 'nochange') {
323: // They did not check any of the login radiobuttons.
324: alert('$alert{'authen'}');
325: return;
326: }
327: END
328: }
329: if ($mode eq 'createcourse') {
330: $auth_checks .= "
331: if ( (vf.autoadds[0].checked == true) &&
332: (vf.elements[current.argfield].value == null || vf.elements[current.argfield].value == '') ) {
333: ";
334: } elsif ($mode eq 'modifycourse') {
335: $auth_checks .= "
336: if (vf.elements[current.argfield].value == null || vf.elements[current.argfield].value == '') {
337: ";
338: }
339: if ( ($mode eq 'createcourse') || ($mode eq 'modifycourse') ) {
340: $auth_checks .= (<<END);
341: var alertmsg = '';
342: switch (current.radiovalue) {
343: case 'krb':
344: alertmsg = '$alert{'krb'}';
345: break;
346: default:
347: alertmsg = '';
348: }
349: if (alertmsg != '') {
350: alert(alertmsg);
351: return;
352: }
353: }
354: END
355: } else {
356: $auth_checks .= (<<END);
357: foundatype=1;
358: if (current.argfield == null || current.argfield == '') {
359: var alertmsg = '';
360: switch (current.value) {
361: case 'krb':
362: alertmsg = '$alert{'krb'}';
363: break;
364: case 'loc':
365: case 'fsys':
366: alertmsg = '$alert{'ipass'}';
367: break;
368: case 'fsys':
369: alertmsg = '';
370: break;
371: default:
372: alertmsg = '';
373: }
374: if (alertmsg != '') {
375: alert(alertmsg);
376: return;
377: }
378: }
379: END
380: }
381: my $optional_checks = '';
382: if ( ($mode eq 'createcourse') || ($mode eq 'modifycourse') ) {
383: $optional_checks = (<<END);
384: vf.submit();
385: }
386: END
387: } else {
388: $optional_checks = (<<END);
389: var message='';
390: if (foundname==0) {
391: message='$alert{'name'}';
392: }
393: if (foundid==0) {
394: if (message!='') {
395: message+='\\n';
396: }
397: message+='$alert{'snum'}';
398: }
399: if (foundsec==0) {
400: if (message!='') {
401: message+='\\n';
402: }
403: message+='$alert{'section'}';
404: }
405: if (foundemail==0) {
406: if (message!='') {
407: message+='\\n';
408: }
409: message+='$alert{'email'}';
410: }
411: if (message!='') {
412: message+= '\\n$alert{'continue'}';
413: if (confirm(message)) {
414: vf.state.value='enrolling';
415: vf.submit();
416: }
417: } else {
418: vf.state.value='enrolling';
419: vf.submit();
420: }
421: }
422: END
423: }
424: my $result = $function_name;
425: if ( ($mode eq 'auth') || ($mode eq 'createcourse') || ($mode eq 'modifycourse') ) {
426: $result .= $auth_checks;
427: }
428: $result .= $optional_checks;
429: if ( ($mode eq 'auth') || ($mode eq 'createcourse') || ($mode eq 'modifycourse') ) {
430: $result .= $authheader;
431: }
432: return $result;
433: }
434:
435: ###############################################################
436: ###############################################################
437: sub upload_manager_javascript_forward_associate {
438: return(<<ENDPICK);
439: function verify(vf) {
440: var founduname=0;
441: var foundpwd=0;
442: var foundname=0;
443: var foundid=0;
444: var foundsec=0;
445: var foundemail=0;
446: var tw;
447: for (i=0;i<=vf.nfields.value;i++) {
448: tw=eval('vf.f'+i+'.selectedIndex');
449: if (tw==1) { founduname=1; }
450: if ((tw>=2) && (tw<=6)) { foundname=1; }
451: if (tw==7) { foundid=1; }
452: if (tw==8) { foundsec=1; }
453: if (tw==9) { foundpwd=1; }
454: if (tw==10) { foundemail=1; }
455: }
456: verify_message(vf,founduname,foundpwd,foundname,foundid,foundsec,foundemail);
457: }
458:
459: //
460: // vf = this.form
461: // tf = column number
462: //
463: // values of nw
464: //
465: // 0 = none
466: // 1 = username
467: // 2 = names (lastname, firstnames)
468: // 3 = fname (firstname)
469: // 4 = mname (middlename)
470: // 5 = lname (lastname)
471: // 6 = gen (generation)
472: // 7 = id
473: // 8 = section
474: // 9 = ipwd (password)
475: // 10 = email address
476:
477: function flip(vf,tf) {
478: var nw=eval('vf.f'+tf+'.selectedIndex');
479: var i;
480: // make sure no other columns are labeled the same as this one
481: for (i=0;i<=vf.nfields.value;i++) {
482: if ((i!=tf) && (eval('vf.f'+i+'.selectedIndex')==nw)) {
483: eval('vf.f'+i+'.selectedIndex=0;')
484: }
485: }
486: // If we set this to 'lastname, firstnames', clear out all the ones
487: // set to 'fname','mname','lname','gen' (3,4,5,6) currently.
488: if (nw==2) {
489: for (i=0;i<=vf.nfields.value;i++) {
490: if ((eval('vf.f'+i+'.selectedIndex')>=3) &&
491: (eval('vf.f'+i+'.selectedIndex')<=6)) {
492: eval('vf.f'+i+'.selectedIndex=0;')
493: }
494: }
495: }
496: // If we set this to one of 'fname','mname','lname','gen' (3,4,5,6),
497: // clear out any that are set to 'lastname, firstnames' (2)
498: if ((nw>=3) && (nw<=6)) {
499: for (i=0;i<=vf.nfields.value;i++) {
500: if (eval('vf.f'+i+'.selectedIndex')==2) {
501: eval('vf.f'+i+'.selectedIndex=0;')
502: }
503: }
504: }
505: // If we set the password, make the password form below correspond to
506: // the new value.
507: if (nw==9) {
508: changed_radio('int',document.studentform);
509: set_auth_radio_buttons('int',document.studentform);
510: vf.intarg.value='';
511: vf.krbarg.value='';
512: vf.locarg.value='';
513: }
514: }
515:
516: function clearpwd(vf) {
517: var i;
518: for (i=0;i<=vf.nfields.value;i++) {
519: if (eval('vf.f'+i+'.selectedIndex')==9) {
520: eval('vf.f'+i+'.selectedIndex=0;')
521: }
522: }
523: }
524:
525: ENDPICK
526: }
527:
528: ###############################################################
529: ###############################################################
530: sub upload_manager_javascript_reverse_associate {
531: return(<<ENDPICK);
532: function verify(vf) {
533: var founduname=0;
534: var foundpwd=0;
535: var foundname=0;
536: var foundid=0;
537: var foundsec=0;
538: var tw;
539: for (i=0;i<=vf.nfields.value;i++) {
540: tw=eval('vf.f'+i+'.selectedIndex');
541: if (i==0 && tw!=0) { founduname=1; }
542: if (((i>=1) && (i<=5)) && tw!=0 ) { foundname=1; }
543: if (i==6 && tw!=0) { foundid=1; }
544: if (i==7 && tw!=0) { foundsec=1; }
545: if (i==8 && tw!=0) { foundpwd=1; }
546: }
547: verify_message(vf,founduname,foundpwd,foundname,foundid,foundsec);
548: }
549:
550: function flip(vf,tf) {
551: var nw=eval('vf.f'+tf+'.selectedIndex');
552: var i;
553: // picked the all one one name field, reset the other name ones to blank
554: if (tf==1 && nw!=0) {
555: for (i=2;i<=5;i++) {
556: eval('vf.f'+i+'.selectedIndex=0;')
557: }
558: }
559: //picked one of the piecewise name fields, reset the all in
560: //one field to blank
561: if ((tf>=2) && (tf<=5) && (nw!=0)) {
562: eval('vf.f1.selectedIndex=0;')
563: }
564: // intial password specified, pick internal authentication
565: if (tf==8 && nw!=0) {
566: changed_radio('int',document.studentform);
567: set_auth_radio_buttons('int',document.studentform);
568: vf.krbarg.value='';
569: vf.intarg.value='';
570: vf.locarg.value='';
571: }
572: }
573:
574: function clearpwd(vf) {
575: var i;
576: if (eval('vf.f8.selectedIndex')!=0) {
577: eval('vf.f8.selectedIndex=0;')
578: }
579: }
580: ENDPICK
581: }
582:
583: ###############################################################
584: ###############################################################
585: sub print_upload_manager_footer {
586: my ($r,$i,$keyfields,$defdom,$today,$halfyear)=@_;
587:
588: my ($krbdef,$krbdefdom) =
589: &Apache::loncommon::get_kerberos_defaults($defdom);
590: my %param = ( formname => 'document.studentform',
591: kerb_def_dom => $krbdefdom,
592: kerb_def_auth => $krbdef
593: );
594: if (exists($env{'form.ipwd_choice'}) &&
595: defined($env{'form.ipwd_choice'}) &&
596: $env{'form.ipwd_choice'} ne '') {
597: $param{'curr_authtype'} = 'int';
598: }
599: my $krbform = &Apache::loncommon::authform_kerberos(%param);
600: my $intform = &Apache::loncommon::authform_internal(%param);
601: my $locform = &Apache::loncommon::authform_local(%param);
602: my $domform = &domain_form($defdom);
603: my $date_table = &date_setting_table();
604: my $Str = "</table>\n";
605: $Str .= &hidden_input('nfields',$i);
606: $Str .= &hidden_input('keyfields',$keyfields);
607: $Str .= '<h3>'.&mt('Login Type')."</h3>\n";
608: $Str .= "<p>\n".
609: &mt('Note: this will not take effect if the user already exists').
610: &Apache::loncommon::help_open_topic('Auth_Options').
611: "</p><p>\n";
612: $Str .= $krbform."\n</p><p>\n".
613: $intform."\n</p><p>\n".
614: $locform."\n</p>\n";
615: $Str .= '<h3>'.&mt('LON-CAPA Domain for Students')."</h3>\n";
616: $Str .= "<p>\n".&mt('LON-CAPA domain: [_1]',$domform)."\n</p>\n";
617: $Str .= "<h3>".&mt('Starting and Ending Dates')."</h3>\n";
618: $Str .= "<p>\n".$date_table."</p>\n";
619: $Str .= "<h3>".&mt('Full Update')."</h3>\n";
620: $Str .= '<input type="checkbox" name="fullup" value="yes">'.
621: ' '.&mt('Full update (also print list of users not enrolled anymore)').
622: "</p>\n";
623: $Str .= "<h3>".&mt('Student Number')."</h3>\n";
624: $Str .= "<p>\n".'<input type="checkbox" name="forceid" value="yes">';
625: $Str .= &mt('Disable ID/Student Number Safeguard and Force Change '.
626: 'of Conflicting IDs (only do if you know what you are doing)').
627: "\n</p><p>\n";
628: $Str .= '<input type="button" onClick="javascript:verify(this.form)" '.
629: 'value="Update Class List" />'."<br />\n";
630: $Str .= &mt('Note: for large courses, this operation may be time '.
631: 'consuming');
632: $r->print($Str);
633: return;
634: }
635:
636: ###############################################################
637: ###############################################################
638: sub print_upload_manager_form {
639: my $r=shift;
640:
641: my $firstLine;
642: my $datatoken;
643: if (!$env{'form.datatoken'}) {
644: $datatoken=&Apache::loncommon::upfile_store($r);
645: } else {
646: $datatoken=$env{'form.datatoken'};
647: &Apache::loncommon::load_tmp_file($r);
648: }
649: my @records=&Apache::loncommon::upfile_record_sep();
650: if($env{'form.noFirstLine'}){
651: $firstLine=shift(@records);
652: }
653: my $total=$#records;
654: my $distotal=$total+1;
655: my $today=time;
656: my $halfyear=$today+15552000;
657: #
658: # Restore memorized settings
659: &Apache::loncommon::restore_course_settings
660: ('enrollment_upload',{ 'username_choice' => 'scalar', # column settings
661: 'names_choice' => 'scalar',
662: 'fname_choice' => 'scalar',
663: 'mname_choice' => 'scalar',
664: 'lname_choice' => 'scalar',
665: 'gen_choice' => 'scalar',
666: 'id_choice' => 'scalar',
667: 'sec_choice' => 'scalar',
668: 'ipwd_choice' => 'scalar',
669: 'email_choice' => 'scalar',
670: });
671: #
672: # Determine kerberos parameters as appropriate
673: my $defdom=$env{'course.'.$env{'request.course.id'}.'.domain'};
674: my ($krbdef,$krbdefdom) =
675: &Apache::loncommon::get_kerberos_defaults($defdom);
676: #
677: &print_upload_manager_header($r,$datatoken,$distotal,$krbdefdom);
678: my $i;
679: my $keyfields;
680: if ($total>=0) {
681: my @field=
682: (['username',&mt('Username'), $env{'form.username_choice'}],
683: ['names',&mt('Last Name, First Names'),$env{'form.names_choice'}],
684: ['fname',&mt('First Name'), $env{'form.fname_choice'}],
685: ['mname',&mt('Middle Names/Initials'),$env{'form.mname_choice'}],
686: ['lname',&mt('Last Name'), $env{'form.lname_choice'}],
687: ['gen', &mt('Generation'), $env{'form.gen_choice'}],
688: ['id', &mt('ID/Student Number'),$env{'form.id_choice'}],
689: ['sec', &mt('Group/Section'), $env{'form.sec_choice'}],
690: ['ipwd', &mt('Initial Password'),$env{'form.ipwd_choice'}],
691: ['email',&mt('EMail Address'), $env{'form.email_choice'}]);
692: if ($env{'form.upfile_associate'} eq 'reverse') {
693: &Apache::loncommon::csv_print_samples($r,\@records);
694: $i=&Apache::loncommon::csv_print_select_table($r,\@records,
695: \@field);
696: foreach (@field) {
697: $keyfields.=$_->[0].',';
698: }
699: chop($keyfields);
700: } else {
701: unshift(@field,['none','']);
702: $i=&Apache::loncommon::csv_samples_select_table($r,\@records,
703: \@field);
704: my %sone=&Apache::loncommon::record_sep($records[0]);
705: $keyfields=join(',',sort(keys(%sone)));
706: }
707: }
708: &print_upload_manager_footer($r,$i,$keyfields,$defdom,$today,$halfyear);
709: }
710:
711: ###############################################################
712: ###############################################################
713: sub enroll_single_student {
714: my $r=shift;
715: # Remove non alphanumeric values from section
716: $env{'form.csec'}=~s/\W//g;
717: #
718: # We do the dates first because the action of making them the defaul
719: # in the course is entirely separate from the action of enrolling the
720: # student. Also, a failure in setting the dates as default is not fatal
721: # to the process of enrolling / modifying a student.
722: my ($startdate,$enddate) = &get_dates_from_form();
723: if ($env{'form.makedatesdefault'}) {
724: $r->print(&make_dates_default($startdate,$enddate));
725: }
726:
727: $r->print('<h3>'.&mt('Enrolling Student').'</h3>');
728: $r->print('<p>'.&mt('Enrolling').' '.$env{'form.cuname'}." \@ ".
729: $env{'form.lcdomain'}.'</p>');
730: if (($env{'form.cuname'})&&($env{'form.cuname'}!~/\W/)&&
731: ($env{'form.lcdomain'})&&($env{'form.lcdomain'}!~/\W/)) {
732: # Deal with home server selection
733: my $domain=$env{'form.lcdomain'};
734: my $desiredhost = $env{'form.lcserver'};
735: if (lc($desiredhost) eq 'default') {
736: $desiredhost = undef;
737: } else {
738: my %home_servers =&Apache::loncommon::get_library_servers($domain);
739: if (! exists($home_servers{$desiredhost})) {
740: $r->print('<font color="#ff0000">'.&mt('Error').':</font>'.
741: &mt('Invalid home server specified'));
742: return;
743: }
744: }
745: $r->print(" ".&mt('with server')." $desiredhost :") if (defined($desiredhost));
746: # End of home server selection logic
747: my $amode='';
748: my $genpwd='';
749: if ($env{'form.login'} eq 'krb') {
750: $amode='krb';
751: $amode.=$env{'form.krbver'};
752: $genpwd=$env{'form.krbarg'};
753: } elsif ($env{'form.login'} eq 'int') {
754: $amode='internal';
755: $genpwd=$env{'form.intarg'};
756: } elsif ($env{'form.login'} eq 'loc') {
757: $amode='localauth';
758: $genpwd=$env{'form.locarg'};
759: if (!$genpwd) { $genpwd=" "; }
760: }
761: my $home = &Apache::lonnet::homeserver($env{'form.cuname'},
762: $env{'form.lcdomain'});
763: if ((($amode) && ($genpwd)) || ($home ne 'no_host')) {
764: # Clean out any old roles the student has in this class.
765: &modifystudent($env{'form.lcdomain'},$env{'form.cuname'},
766: $env{'request.course.id'},$env{'form.csec'},
767: $desiredhost);
768: my $login_result = &Apache::lonnet::modifystudent
769: ($env{'form.lcdomain'},$env{'form.cuname'},
770: $env{'form.cstid'},$amode,$genpwd,
771: $env{'form.cfirst'},$env{'form.cmiddle'},
772: $env{'form.clast'},$env{'form.cgen'},
773: $env{'form.csec'},$enddate,
774: $startdate,$env{'form.forceid'},
775: $desiredhost,$env{'form.emailaddress'});
776: if ($login_result =~ /^ok/) {
777: $r->print($login_result);
778: $r->print("<p> ".&mt('If active, the new role will be available when the student next logs in to LON-CAPA.')."</p>");
779: } else {
780: $r->print(&mt('unable to enroll').": ".$login_result);
781: }
782: } else {
783: $r->print('<p><font color="#ff0000">'.&mt('ERROR').'</font> ');
784: if ($amode =~ /^krb/) {
785: $r->print(&mt('Missing Kerberos domain information.').' ');
786: } else {
787: $r->print(&mt('Invalid login mode or password.').' ');
788: }
789: $r->print('<b>'.&mt('Unable to enroll').' '.$env{'form.cuname'}.'.</b></p>');
790: }
791: } else {
792: $r->print(&mt('Invalid username or domain'));
793: }
794: }
795:
796: sub setup_date_selectors {
797: my ($starttime,$endtime,$mode) = @_;
798: if (! defined($starttime)) {
799: $starttime = time;
800: unless ($mode eq 'create_enrolldates' || $mode eq 'create_defaultdates') {
801: if (exists($env{'course.'.$env{'request.course.id'}.
802: '.default_enrollment_start_date'})) {
803: $starttime = $env{'course.'.$env{'request.course.id'}.
804: '.default_enrollment_start_date'};
805: }
806: }
807: }
808: if (! defined($endtime)) {
809: $endtime = time+(6*30*24*60*60); # 6 months from now, approx
810: unless ($mode eq 'createcourse') {
811: if (exists($env{'course.'.$env{'request.course.id'}.
812: '.default_enrollment_end_date'})) {
813: $endtime = $env{'course.'.$env{'request.course.id'}.
814: '.default_enrollment_end_date'};
815: }
816: }
817: }
818: my $startdateform = &Apache::lonhtmlcommon::date_setter('studentform',
819: 'startdate',
820: $starttime);
821: my $enddateform = &Apache::lonhtmlcommon::date_setter('studentform',
822: 'enddate',
823: $endtime);
824: if ($mode eq 'create_enrolldates') {
825: $startdateform = &Apache::lonhtmlcommon::date_setter('ccrs',
826: 'startenroll',
827: $starttime);
828: $enddateform = &Apache::lonhtmlcommon::date_setter('ccrs',
829: 'endenroll',
830: $endtime);
831: }
832: if ($mode eq 'create_defaultdates') {
833: $startdateform = &Apache::lonhtmlcommon::date_setter('ccrs',
834: 'startaccess',
835: $starttime);
836: $enddateform = &Apache::lonhtmlcommon::date_setter('ccrs',
837: 'endaccess',
838: $endtime);
839: }
840: return ($startdateform,$enddateform);
841: }
842:
843: sub get_dates_from_form {
844: my $startdate = &Apache::lonhtmlcommon::get_date_from_form('startdate');
845: my $enddate = &Apache::lonhtmlcommon::get_date_from_form('enddate');
846: if ($env{'form.no_end_date'}) {
847: $enddate = 0;
848: }
849: return ($startdate,$enddate);
850: }
851:
852: sub date_setting_table {
853: my ($starttime,$endtime,$mode) = @_;
854: my ($startform,$endform)=&setup_date_selectors($starttime,$endtime,$mode);
855: my $dateDefault = '<nobr>'.
856: '<input type="checkbox" name="makedatesdefault" /> '.
857: &mt('make these dates the default for future enrollment');
858: if ($mode eq 'create_enrolldates' || $mode eq 'create_defaultdates') {
859: $dateDefault = ' ';
860: }
861: my $perpetual = '<nobr><input type="checkbox" name="no_end_date"';
862: if (defined($endtime) && $endtime == 0) {
863: $perpetual .= ' checked';
864: }
865: $perpetual.= ' /> '.&mt('no ending date').'</nobr>';
866: if ($mode eq 'create_enrolldates') {
867: $perpetual = ' ';
868: }
869: my $result = '';
870: $result .= "<table>\n";
871: $result .= '<tr><td align="right">'.&mt('Starting Date').'</td>'.
872: '<td>'.$startform.'</td>'.
873: '<td>'.$dateDefault.'</td>'."</tr>\n";
874: $result .= '<tr><td align="right">'.&mt('Ending Date').'</td>'.
875: '<td>'.$endform.'</td>'.
876: '<td>'.$perpetual.'</td>'."</tr>\n";
877: $result .= "</table>\n";
878: return $result;
879: }
880:
881: sub make_dates_default {
882: my ($startdate,$enddate) = @_;
883: my $result = '';
884: my $dom = $env{'course.'.$env{'request.course.id'}.'.domain'};
885: my $crs = $env{'course.'.$env{'request.course.id'}.'.num'};
886: my $put_result = &Apache::lonnet::put('environment',
887: {'default_enrollment_start_date'=>$startdate,
888: 'default_enrollment_end_date' =>$enddate},$dom,$crs);
889: if ($put_result eq 'ok') {
890: $result .= "Set default start and end dates for course<br />";
891: #
892: # Refresh the course environment
893: &Apache::lonnet::coursedescription($env{'request.course.id'});
894: } else {
895: $result .= &mt('Unable to set default dates for course').":".$put_result.
896: '<br />';
897: }
898: return $result;
899: }
900:
901: ##
902: ## Single student enrollment routines (some of them)
903: ##
904: sub get_student_username_domain_form {
905: my $r = shift;
906: my $domform = &Apache::loncommon::select_dom_form
907: ($env{'course.'.$env{'request.course.id'}.'.domain'},'cudomain',0);
908: my %lt=&Apache::lonlocal::texthash(
909: 'eos' => "Enroll One Student",
910: 'usr' => "Username",
911: 'dom' => "Domain",
912: 'been' => "Begin Enrollment",
913: );
914: $r->print(<<END);
915: <input type="hidden" name="action" value="enrollstudent" />
916: <input type="hidden" name="state" value="gotusername" />
917: <h3>$lt{'eos'}</h3>
918: <table>
919: <tr><th>$lt{'usr'}:</th>
920: <td><input type="text" name="cuname" size="15" /></td></tr>
921: <tr><th>$lt{'dom'}:</th>
922: <td>$domform</td></tr>
923: <tr><th> </th>
924: <td>
925: <input type="submit" name="Begin Enrollment" value="$lt{'been'}" />
926: </td></tr>
927: </table>
928: <script type="text/javascript">
929: // the if prevents the script error if the browser can not handle this
930: if ( document.studentform.cuname ) { document.studentform.cuname.focus(); }
931: </script>
932: END
933: return;
934: }
935:
936: sub print_enroll_single_student_form {
937: my $r=shift;
938: $r->print("<h3>".&mt('Enroll One Student')."</h3>");
939: #
940: my $username = $env{'form.cuname'};
941: my $domain = $env{'form.cudomain'};
942: $username=~s/\W//gs;
943: $domain=~s/\W//gs;
944: my $home = &Apache::lonnet::homeserver($username,$domain);
945: # $new_user flags whether we are creating a new user or using an old one
946: my $new_user = 1;
947: if ($home ne 'no_host') {
948: $new_user = 0;
949: }
950: #
951: my $user_data_html = '';
952: my $javascript_validations = '';
953: if ($new_user) {
954: my $defdom=$env{'course.'.$env{'request.course.id'}.'.domain'};
955: # Set up authentication forms
956: my ($krbdef,$krbdefdom) =
957: &Apache::loncommon::get_kerberos_defaults($domain);
958: $javascript_validations=&javascript_validations('auth',$krbdefdom);
959: my %param = ( formname => 'document.studentform',
960: kerb_def_dom => $krbdefdom,
961: kerb_def_auth => $krbdef
962: );
963: my $krbform = &Apache::loncommon::authform_kerberos(%param);
964: my $intform = &Apache::loncommon::authform_internal(%param);
965: my $locform = &Apache::loncommon::authform_local(%param);
966: #
967: # Set up domain selection form
968: my $homeserver_form = '';
969: my %servers = &Apache::loncommon::get_library_servers($domain);
970: $homeserver_form = '<select name="lcserver" size="1">'."\n".
971: '<option value="default" selected>default</option>'."\n";
972: while (my ($servername,$serverdescription) = each (%servers)) {
973: $homeserver_form .= '<option value="'.$servername.'">'.
974: $serverdescription."</option>\n";
975: }
976: $homeserver_form .= "</select>\n";
977: #
978: #
979: my %lt=&Apache::lonlocal::texthash(
980: 'udf' => "User Data for",
981: 'fn' => "First Name",
982: 'mn' => "Middle Name",
983: 'ln' => "Last Name",
984: 'gen' => "Generation",
985: 'hs' => "Home Server",
986: 'pswd' => "Password",
987: 'psam' => "Please select an authentication mechanism",
988: 'mail' => "Email Address"
989: );
990: my $authhelp=&Apache::loncommon::help_open_topic('Auth_Options');
991: $user_data_html = <<END;
992: <h3>$lt{'udf'} $username\@$domain</h3>
993: <table>
994: <tr><th>$lt{'fn'}:</th>
995: <td><input type="text" name="cfirst" size="15"></td></tr>
996: <tr><th>$lt{'mn'}:</th>
997: <td><input type="text" name="cmiddle" size="15"></td></tr>
998: <tr><th>$lt{'ln'}:</th>
999: <td><input type="text" name="clast" size="15"></td></tr>
1000: <tr><th>$lt{'gen'}:</th>
1001: <td><input type="text" name="cgen" size="5"> </td></tr>
1002: <tr><th>$lt{'hs'}:</th>
1003: <td>$homeserver_form</td></tr>
1004: <tr><th>$lt{'mail'}:</th>
1005: <td><input type="text" name="emailaddress" size="20" /></td></tr>
1006: </table>
1007: <h3>$lt{'pswd'}</h3>
1008: $lt{'psam'}$authhelp
1009: <table>
1010: <p>
1011: $krbform
1012: <br />
1013: $intform
1014: <br />
1015: $locform
1016: </p>
1017: END
1018: } else {
1019: # User already exists. Do not worry about authentication
1020: my %uenv = &Apache::lonnet::dump('environment',$domain,$username);
1021: $javascript_validations = &javascript_validations('noauth');
1022: my %lt=&Apache::lonlocal::texthash(
1023: 'udf' => "User Data for",
1024: 'fn' => "First Name",
1025: 'mn' => "Middle Name",
1026: 'ln' => "Last Name",
1027: 'gen' => "Generation",
1028: 'mail' => "Email Address",
1029: );
1030: $user_data_html = <<END;
1031: <h3>$lt{'udf'} $username\@$domain</h3>
1032: <input type="hidden" name="lcserver" value="default" />
1033: <table>
1034: <tr><th>$lt{'fn'}:</th>
1035: <td>
1036: <input type="text" name="cfirst" value="$uenv{'firstname'}" size="15" />
1037: </td></tr>
1038: <tr><th>$lt{'mn'}:</th>
1039: <td>
1040: <input type="text" name="cmiddle" value="$uenv{'middlename'}" size="15" />
1041: </td></tr>
1042: <tr><th>$lt{'ln'}:</th>
1043: <td>
1044: <input type="text" name="clast"value="$uenv{'lastname'}" size="15" />
1045: </td></tr>
1046: <tr><th>$lt{'gen'}:</th>
1047: <td>
1048: <input type="text" name="cgen" value="$uenv{'generation'}" size="5" />
1049: </td></tr>
1050: <tr><th>$lt{'mail'}:</th>
1051: <td>
1052: <input type="text" name="emailaddress" value="$uenv{'permanentemail'}" size="20" />
1053: </td></tr>
1054: </table>
1055: END
1056: }
1057: my $date_table = &date_setting_table();
1058: # Print it all out
1059: my %lt=&Apache::lonlocal::texthash(
1060: 'cd' => "Course Data",
1061: 'gs' => "Group/Section",
1062: 'idsn' => "ID/Student Number",
1063: 'disn' => "Disable ID/Student Number Safeguard and Force Change of Conflicting IDs (only do if you know what you are doing)",
1064: 'eas' => "Enroll as student",
1065: );
1066: $r->print(<<END);
1067: <input type="hidden" name="action" value="enrollstudent" />
1068: <input type="hidden" name="state" value="done" />
1069: <input type="hidden" name="cuname" value="$username" />
1070: <input type="hidden" name="lcdomain" value="$domain" />
1071: <script type="text/javascript" language="Javascript">
1072: function verify(vf) {
1073: var founduname=0;
1074: var foundpwd=0;
1075: var foundname=0;
1076: var foundid=0;
1077: var foundsec=0;
1078: var tw;
1079: if ((typeof(vf.cuname.value) !="undefined") && (vf.cuname.value!='') &&
1080: (typeof(vf.lcdomain.value)!="undefined") && (vf.lcdomain.value!='')) {
1081: founduname=1;
1082: }
1083: if ((typeof(vf.cfirst.value)!="undefined") && (vf.cfirst.value!='') &&
1084: (typeof(vf.clast.value) !="undefined") && (vf.clast.value!='')) {
1085: foundname=1;
1086: }
1087: if ((typeof(vf.csec.value)!="undefined") && (vf.csec.value!='')) {
1088: foundsec=1;
1089: }
1090: if ((typeof(vf.cstid.value)!="undefined") && (vf.cstid.value!='')) {
1091: foundid=1;
1092: }
1093: if (founduname==0) {
1094: alert('You need to specify at least the username and domain fields');
1095: return;
1096: }
1097: verify_message(vf,founduname,foundpwd,foundname,foundid,foundsec);
1098: }
1099:
1100: $javascript_validations
1101:
1102: function clearpwd(vf) {
1103: //nothing else needs clearing
1104: }
1105:
1106: </script>
1107:
1108: $user_data_html
1109:
1110: <h3>$lt{'cd'}</h3>
1111:
1112: <p>$lt{'gs'}: <input type="text" name="csec" size="5" />
1113: <p>
1114: $date_table
1115: </p>
1116: <h3>$lt{'idsn'}</h3>
1117: <p>
1118: $lt{'idsn'}: <input type="text" name="cstid" size="10">
1119: </p><p>
1120: <input type="checkbox" name="forceid" value="yes">
1121: $lt{'disn'}
1122: </p><p>
1123: <input type="button" onClick="verify(this.form)" value="$lt{'eas'}">
1124: </p>
1125: END
1126: return;
1127: }
1128:
1129: # ========================================================= Menu Phase Two Drop
1130: sub print_drop_menu {
1131: my $r=shift;
1132: $r->print("<h3>".&mt('Drop Students')."</h3>");
1133: my $cid=$env{'request.course.id'};
1134: my ($classlist,$keylist) = &Apache::loncoursedata::get_classlist();
1135: if (! defined($classlist)) {
1136: $r->print(&mt('There are no students currently enrolled.')."\n");
1137: return;
1138: }
1139: # Print out the available choices
1140: &show_drop_list($r,$classlist,$keylist);
1141: return;
1142: }
1143:
1144: # ============================================== view classlist
1145: sub print_html_classlist {
1146: my ($r,$mode) = @_;
1147: if (! exists($env{'form.sortby'})) {
1148: $env{'form.sortby'} = 'username';
1149: }
1150: if ($env{'form.Status'} !~ /^(Any|Expired|Active)$/) {
1151: $env{'form.Status'} = 'Active';
1152: }
1153: my $status_select = &Apache::lonhtmlcommon::StatusOptions
1154: ($env{'form.Status'});
1155: my $cid=$env{'request.course.id'};
1156: my $cdom=$env{'course.'.$cid.'.domain'};
1157: my $cnum=$env{'course.'.$cid.'.num'};
1158: #
1159: # List course personnel
1160: my %coursepersonnel=&Apache::lonnet::get_course_adv_roles($cdom.'/'.$cnum);
1161: #
1162: if (! defined($env{'form.output'}) ||
1163: $env{'form.output'} !~ /^(csv|excel|html)$/ ) {
1164: $env{'form.output'} = 'html';
1165: }
1166: #
1167: $r->print('<br /><table border="2">');
1168: foreach my $role (sort keys %coursepersonnel) {
1169: next if ($role =~ /^\s*$/);
1170: $r->print('<tr><td>'.$role.'</td><td>');
1171: foreach my $user (split(',',$coursepersonnel{$role})) {
1172: my ($puname,$pudom)=split(':',$user);
1173: $r->print(' '.&Apache::loncommon::aboutmewrapper(
1174: &Apache::loncommon::plainname($puname,
1175: $pudom),
1176: $puname,$pudom));
1177: }
1178: $r->print('</td></tr>');
1179: }
1180: $r->print('</table>');
1181: #
1182: # Interface output
1183: $r->print('<input type="hidden" name="action" value="'.
1184: $env{'form.action'}.'" />');
1185: $r->print("<p>\n");
1186: if ($env{'form.action'} ne 'modifystudent') {
1187: my %lt=&Apache::lonlocal::texthash('csv' => "CSV",
1188: 'excel' => "Excel",
1189: 'html' => 'HTML');
1190: my $output_selector = '<select size="1" name="output" >';
1191: foreach my $outputformat ('html','csv','excel') {
1192: my $option = '<option value="'.$outputformat.'" ';
1193: if ($outputformat eq $env{'form.output'}) {
1194: $option .= 'selected ';
1195: }
1196: $option .='>'.$lt{$outputformat}.'</option>';
1197: $output_selector .= "\n".$option;
1198: }
1199: $output_selector .= '</select>';
1200: $r->print(&mt('Output Format: [_1]',$output_selector).(' 'x3));
1201: }
1202: $r->print(&mt('Student Status: [_1]',$status_select)."\n");
1203: $r->print('<input type="submit" value="'.&mt('Update Display').'" />'.
1204: "\n</p>\n");
1205: #
1206: # Print the classlist
1207: $r->print('<h2>'.&mt('Current Class List').'</h2>');
1208: my ($classlist,$keylist)=&Apache::loncoursedata::get_classlist();
1209: if (! defined($classlist)) {
1210: $r->print(&mt('There are no students currently enrolled.')."\n");
1211: } else {
1212: # Print out the available choices
1213: if ($env{'form.action'} eq 'modifystudent') {
1214: &show_class_list($r,'view','modify',
1215: $env{'form.Status'},$classlist,$keylist);
1216: } else {
1217: &show_class_list($r,$env{'form.output'},'aboutme',
1218: $env{'form.Status'},$classlist,$keylist);
1219: }
1220: }
1221: }
1222:
1223: # =================================================== Show student list to drop
1224: sub show_class_list {
1225: my ($r,$mode,$linkto,$statusmode,$classlist,$keylist)=@_;
1226: my $cid=$env{'request.course.id'};
1227: #
1228: # Variables for excel output
1229: my ($excel_workbook, $excel_sheet, $excel_filename,$row,$format);
1230: #
1231: # Variables for csv output
1232: my ($CSVfile,$CSVfilename);
1233: #
1234: my $sortby = $env{'form.sortby'};
1235: if ($sortby !~ /^(username|domain|section|fullname|id|start|end|type)$/) {
1236: $sortby = 'username';
1237: }
1238: # Print out header
1239: unless ($mode eq 'autoenroll') {
1240: $r->print(<<END);
1241: <input type="hidden" name="state" value="$env{'form.state'}" />
1242: END
1243: }
1244: $r->print(<<END);
1245: <input type="hidden" name="sortby" value="$sortby" />
1246: END
1247: if ($mode eq 'html' || $mode eq 'view' || $mode eq 'autoenroll') {
1248: if ($linkto eq 'aboutme') {
1249: $r->print(&mt('Select a user name to view the users personal page.'));
1250: } elsif ($linkto eq 'modify') {
1251: $r->print(&mt('Select a user name to modify the students information'));
1252: }
1253: my %lt=&Apache::lonlocal::texthash(
1254: 'usrn' => "username",
1255: 'dom' => "domain",
1256: 'sn' => "student name",
1257: 'sec' => "section",
1258: 'start' => "start date",
1259: 'end' => "end date",
1260: 'type' => "enroll type/action"
1261: );
1262: unless ($mode eq 'autoenroll') {
1263: $r->print(<<END);
1264: <input type="hidden" name="sname" value="" />
1265: <input type="hidden" name="sdom" value="" />
1266: END
1267: }
1268: $r->print("
1269: <p>
1270: <table border=2>
1271: <tr>
1272: ");
1273: if ($mode eq 'autoenroll') {
1274: $r->print("
1275: <th><a href=\"javascript:document.studentform.sortby.value='type';document.studentform.submit();\">$lt{'type'}</a></th>
1276: ");
1277: } else {
1278: $r->print("
1279: <th>Count</th>
1280: ");
1281: }
1282: $r->print(<<END);
1283: <th>
1284: <a href="javascript:document.studentform.sortby.value='username';document.studentform.submit();">$lt{'usrn'}</a>
1285: </th><th>
1286: <a href="javascript:document.studentform.sortby.value='domain';document.studentform.submit();">$lt{'dom'}</a>
1287: </th><th>
1288: <a href="javascript:document.studentform.sortby.value='id';document.studentform.submit();">ID</a>
1289: </th><th>
1290: <a href="javascript:document.studentform.sortby.value='fullname';document.studentform.submit();">$lt{'sn'}</a>
1291: </th><th>
1292: <a href="javascript:document.studentform.sortby.value='section';document.studentform.submit();">$lt{'sec'}</a>
1293: </th><th>
1294: <a href="javascript:document.studentform.sortby.value='start';document.studentform.submit();">$lt{'start'}</a>
1295: </th><th>
1296: <a href="javascript:document.studentform.sortby.value='end';document.studentform.submit();">$lt{'end'}</a>
1297: </th>
1298: </tr>
1299: END
1300: } elsif ($mode eq 'csv') {
1301: #
1302: # Open a file
1303: $CSVfilename = '/prtspool/'.
1304: $env{'user.name'}.'_'.$env{'user.domain'}.'_'.
1305: time.'_'.rand(1000000000).'.csv';
1306: unless ($CSVfile = Apache::File->new('>/home/httpd'.$CSVfilename)) {
1307: $r->log_error("Couldn't open $CSVfilename for output $!");
1308: $r->print("Problems occured in writing the csv file. ".
1309: "This error has been logged. ".
1310: "Please alert your LON-CAPA administrator.");
1311: $CSVfile = undef;
1312: }
1313: #
1314: # Write headers and data to file
1315: if($statusmode eq 'Expired') {
1316: print $CSVfile '"'.&mt('Students with expired roles').'"'."\n";
1317: }
1318: if ($statusmode eq 'Any') {
1319: print $CSVfile '"'.join('","',map {
1320: &Apache::loncommon::csv_translate(&mt($_))
1321: } ("username","domain","ID","student name",
1322: "section","start date","end date","status")).'"'."\n";
1323: } else {
1324: print $CSVfile '"'.join('","',map {
1325: &Apache::loncommon::csv_translate(&mt($_))
1326: } ("username","domain","ID","student name",
1327: "section","start date","end date")).'"'."\n";
1328: }
1329: } elsif ($mode eq 'excel') {
1330: # Create the excel spreadsheet
1331: ($excel_workbook,$excel_filename,$format) =
1332: &Apache::loncommon::create_workbook($r);
1333: return if (! defined($excel_workbook));
1334: $excel_sheet = $excel_workbook->addworksheet('classlist');
1335: #
1336: my $description = 'Class List for '.
1337: $env{'course.'.$env{'request.course.id'}.'.description'};
1338: $excel_sheet->write($row++,0,$description,$format->{'h1'});
1339: #
1340: $excel_sheet->write($row++,0,["username","domain","ID",
1341: "student name","section",
1342: "start date","end date","status"],
1343: $format->{'bold'});
1344: }
1345: #
1346: # Sort the students
1347: my %index;
1348: my $i;
1349: foreach (@$keylist) {
1350: $index{$_} = $i++;
1351: }
1352: my $index = $index{$sortby};
1353: my $second = $index{'username'};
1354: my $third = $index{'domain'};
1355: my @Sorted_Students = sort {
1356: lc($classlist->{$a}->[$index]) cmp lc($classlist->{$b}->[$index])
1357: ||
1358: lc($classlist->{$a}->[$second]) cmp lc($classlist->{$b}->[$second])
1359: ||
1360: lc($classlist->{$a}->[$third]) cmp lc($classlist->{$b}->[$third])
1361: } (keys(%$classlist));
1362: my $studentcount = 0;
1363: my $autocount = 0;
1364: my $manualcount = 0;
1365: my $unlockcount = 0;
1366: my $lockcount = 0;
1367: foreach my $student (@Sorted_Students) {
1368: my $sdata = $classlist->{$student};
1369: my $username = $sdata->[$index{'username'}];
1370: my $domain = $sdata->[$index{'domain'}];
1371: my $section = $sdata->[$index{'section'}];
1372: my $name = $sdata->[$index{'fullname'}];
1373: my $id = $sdata->[$index{'id'}];
1374: my $status = $sdata->[$index{'status'}];
1375: my $start = $sdata->[$index{'start'}];
1376: my $end = $sdata->[$index{'end'}];
1377: my $type = $sdata->[$index{'type'}];
1378: next if (($statusmode ne 'Any') && ($status ne $statusmode));
1379: if ($mode eq 'view' || $mode eq 'html' || $mode eq 'autoenroll') {
1380: if (! defined($start) || $start == 0) {
1381: $start = &mt('none');
1382: } else {
1383: $start = &Apache::lonlocal::locallocaltime($start);
1384: }
1385: if (! defined($end) || $end == 0) {
1386: $end = &mt('none');
1387: } else {
1388: $end = &Apache::lonlocal::locallocaltime($end);
1389: }
1390: $r->print("<tr>\n ");
1391: if ($mode eq 'autoenroll') {
1392: my $lockedtype = $sdata->[$index{'lockedtype'}];
1393: $studentcount++;
1394: my $cellentry;
1395: if ($type eq 'auto') {
1396: $cellentry = '<b>'.&mt('auto').'</b> <input type="checkbox" name="chgauto" value="'.$username.':'.$domain.'" /> Change';
1397: $autocount ++;
1398: } else {
1399: $cellentry = '<table border="0" cellspacing="0"><tr><td rowspan="2"><b>'.&mt('manual').'</b></td><td><nobr><input type="checkbox" name="chgmanual" value="'.$username.':'.$domain.'" /> Change</nobr></td></tr><tr><td><nobr>';
1400: $manualcount ++;
1401: if ($lockedtype) {
1402: $cellentry .= '<input type="checkbox" name="unlockchg" value="'.$username.':'.$domain.'" /> '.&mt('Unlock');
1403: $unlockcount ++;
1404: } else {
1405: $cellentry .= '<input type="checkbox" name="lockchg" value="'.$username.':'.$domain.'" /> '.&mt('Lock');
1406: $lockcount ++;
1407: }
1408: $cellentry .= '</nobr></td></tr></table>';
1409: }
1410: $r->print("<td>$cellentry<td>\n ");
1411: } else {
1412: $r->print("<td>".(++$studentcount)."</td><td>\n ");
1413: }
1414: if ($linkto eq 'nothing') {
1415: $r->print($username);
1416: } elsif ($linkto eq 'aboutme') {
1417: $r->print(&Apache::loncommon::aboutmewrapper($username,
1418: $username,
1419: $domain));
1420: } elsif ($linkto eq 'modify') {
1421: $r->print('<a href="'.
1422: "javascript:document.studentform.sname.value='".
1423: $username.
1424: "';document.studentform.sdom.value='".$domain.
1425: "';document.studentform.state.value='selected".
1426: "';document.studentform.submit();".'">'.
1427: $username."</a>\n");
1428: }
1429: $r->print(<<"END");
1430: </td>
1431: <td>$domain</td>
1432: <td>$id</td>
1433: <td>$name</td>
1434: <td>$section</td>
1435: <td>$start</td>
1436: <td>$end</td>
1437: </tr>
1438: END
1439: } elsif ($mode eq 'csv') {
1440: next if (! defined($CSVfile));
1441: # no need to bother with $linkto
1442: if (! defined($start) || $start == 0) {
1443: $start = &mt('none');
1444: } else {
1445: $start = &Apache::lonlocal::locallocaltime($start);
1446: }
1447: if (! defined($end) || $end == 0) {
1448: $end = &mt('none');
1449: } else {
1450: $end = &Apache::lonlocal::locallocaltime($end);
1451: }
1452: my @line = ();
1453: foreach ($username,$domain,$id,$name,$section,$start,$end) {
1454: push @line,&Apache::loncommon::csv_translate($_);
1455: }
1456: if ($statusmode eq 'Any') {
1457: push @line,&Apache::loncommon::csv_translate($status);
1458: }
1459: print $CSVfile '"'.join('","',@line).'"'."\n";
1460: } elsif ($mode eq 'excel') {
1461: $excel_sheet->write($row,0,[$username,$domain,$id,
1462: $name,$section]);
1463: my $col = 5;
1464: foreach my $time ($start,$end) {
1465: if (defined($time) && $time != 0) {
1466: $excel_sheet->write($row,$col++,
1467: &Apache::lonstathelpers::calc_serial($time),
1468: $format->{'date'});
1469: } else {
1470: $excel_sheet->write($row,$col++,'none');
1471: }
1472: }
1473: $excel_sheet->write($row,$col++,$status);
1474: $row++;
1475: }
1476: }
1477: if ($mode eq 'view' || $mode eq 'html' || $mode eq 'autoenroll') {
1478: $r->print('</table><br>');
1479: } elsif ($mode eq 'excel') {
1480: $excel_workbook->close();
1481: $r->print('<p><a href="'.$excel_filename.'">'.
1482: &mt('Your Excel spreadsheet').'</a> '.&mt('is ready for download').'.</p>'."\n");
1483: } elsif ($mode eq 'csv') {
1484: close($CSVfile);
1485: $r->print('<a href="'.$CSVfilename.'">'.
1486: &mt('Your CSV file').'</a> is ready for download.'.
1487: "\n");
1488: $r->rflush();
1489: }
1490: if ($mode eq 'autoenroll') {
1491: return ($studentcount,$autocount,$manualcount,$lockcount,$unlockcount);
1492: }
1493: return;
1494: }
1495:
1496:
1497: #
1498: # print out form for modification of a single students data
1499: #
1500: sub print_modify_student_form {
1501: my $r = shift();
1502: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
1503: ['sdom','sname']);
1504: my $sname = $env{'form.sname'};
1505: my $sdom = $env{'form.sdom'};
1506: my $sortby = $env{'form.sortby'};
1507: # determine the students name information
1508: my %info=&Apache::lonnet::get('environment',
1509: ['firstname','middlename',
1510: 'lastname','generation','id'],
1511: $sdom, $sname);
1512: my ($tmp) = keys(%info);
1513: if ($tmp =~ /^(con_lost|error|no_such_host)/i) {
1514: $r->print('<font color="#ff0000" size="+2">'.&mt('Error').'</font>'.
1515: '<p>'.
1516: &mt('Unable to retrieve environment data for').' '.$sname.
1517: &mt('in domain').' '.$sdom.'</p><p>'.
1518: &mt('Please contact your LON-CAPA administrator regarding this situation.').'</p></body></html>');
1519: return;
1520: }
1521: # determine the students starting and ending times and section
1522: my ($starttime,$endtime,$section) = &get_enrollment_data($sname,$sdom);
1523: if ($starttime =~ /^error/) {
1524: $r->print('<h2>'&mt('Error').'</h2>');
1525: $r->print('<p>'.$starttime.'</p>');
1526: return;
1527: }
1528: #
1529: # Deal with date forms
1530: my $current_date_description = '';
1531: my $textdate = '';
1532:
1533: if (! defined($starttime) || $starttime == 0) {
1534: $current_date_description = &mt('Current Starting Date: not set').
1535: '<br />';
1536: } else {
1537: $current_date_description =
1538: &mt('Current Starting Date: [_1]',
1539: &Apache::lonlocal::locallocaltime($starttime)).'<br />';
1540: }
1541: if (! defined($endtime) || $endtime == 0) {
1542: $current_date_description.= &mt('Current Ending Date: not set').
1543: '<br />';
1544: } else {
1545: $current_date_description.=
1546: &mt('Current Ending Date: [_1]',
1547: &Apache::lonlocal::locallocaltime($endtime)).'<br />';
1548:
1549: }
1550: my $date_table = &date_setting_table($starttime,$endtime);
1551: #
1552: if (! exists($env{'form.Status'}) ||
1553: $env{'form.Status'} !~ /^(Any|Expired|Active)$/) {
1554: $env{'form.Status'} = 'crap';
1555: }
1556: # Make sure student is enrolled in course
1557: my %lt=&Apache::lonlocal::texthash(
1558: 'mef' => "Modify Enrollment for",
1559: 'odcc' => "Only domain coordinators can change a users password.",
1560: 'sn' => "Student Name",
1561: 'fn' => "First",
1562: 'mn' => "Middle",
1563: 'ln' => "Last",
1564: 'gen' => "Generation",
1565: 'sid' => "Student ID",
1566: 'disn' => "Disable ID/Student Number Safeguard and Force Change of Conflicting IDs (only do if you know what you are doing)",
1567: 'sec' => "Section",
1568: 'sm' => "Submit Modifications",
1569: );
1570: $r->print(<<END);
1571: <p>
1572: <font size="+1">
1573: $lt{'odcc'}
1574: </font>
1575: </p>
1576: <input type="hidden" name="slogin" value="$sname" />
1577: <input type="hidden" name="sdomain" value="$sdom" />
1578: <input type="hidden" name="action" value="modifystudent" />
1579: <input type="hidden" name="state" value="done" />
1580: <input type="hidden" name="sortby" value="$sortby" />
1581: <input type="hidden" name="Status" value="$env{'form.Status'}" />
1582: <h2>$lt{'mef'} $info{'firstname'} $info{'middlename'}
1583: $info{'lastname'} $info{'generation'}, $sname\@$sdom</h2>
1584: <p>
1585: <b>$lt{'sn'}</b>
1586: <table>
1587: <tr><th>$lt{'fn'}</th><th>$lt{'mn'}</th><th>$lt{'ln'}</th><th>$lt{'gen'}</th></tr>
1588: <tr><td>
1589: <input type="text" name="firstname" value="$info{'firstname'}" /></td><td>
1590: <input type="text" name="middlename" value="$info{'middlename'}" /></td><td>
1591: <input type="text" name="lastname" value="$info{'lastname'}" /></td><td>
1592: <input type="text" name="generation" value="$info{'generation'}" /></td></tr>
1593: </table>
1594: </p><p>
1595: <b>$lt{'sid'}</b>: <input type="text" name="id" value="$info{'id'}" size="12"/>
1596: </p><p>
1597: <input type="checkbox" name="forceid" >
1598: $lt{'disn'}
1599: </p><p>
1600: <b>$lt{'sec'}</b>: <input type="text" name="section" value="$section" size="14"/>
1601: </p>
1602: <p>$current_date_description</p>
1603: <p>$date_table</p>
1604: <input type="submit" value="$lt{'sm'}" />
1605: </body></html>
1606: END
1607: return;
1608: }
1609:
1610: #
1611: # modify a single students section
1612: #
1613: sub modify_single_student {
1614: my $r = shift;
1615: #
1616: # Remove non alphanumeric values from the section
1617: $env{'form.section'} =~ s/\W//g;
1618: #
1619: # Do the date defaults first
1620: my ($starttime,$endtime) = &get_dates_from_form();
1621: if ($env{'form.makedatesdefault'}) {
1622: $r->print(&make_dates_default($starttime,$endtime));
1623: }
1624: # Get the 'sortby' and 'Status' variables so the user goes back to their
1625: # previous screen
1626: my $sortby = $env{'form.sortby'};
1627: my $status = $env{'form.Status'};
1628: #
1629: # We always need this information
1630: my $slogin = $env{'form.slogin'};
1631: my $sdom = $env{'form.sdomain'};
1632: #
1633: # Get the old data
1634: my %old=&Apache::lonnet::get('environment',
1635: ['firstname','middlename',
1636: 'lastname','generation','id'],
1637: $sdom, $slogin);
1638: $old{'section'} = &Apache::lonnet::getsection($sdom,$slogin,
1639: $env{'request.course.id'});
1640: my ($tmp) = keys(%old);
1641: if ($tmp =~ /^(con_lost|error|no_such_host)/i) {
1642: $r->print(&mt('There was an error determining the environment values for')." $slogin \@ $sdom.");
1643: return;
1644: }
1645: undef $tmp;
1646: #
1647: # Get the new data
1648: my $firstname = $env{'form.firstname'};
1649: my $middlename = $env{'form.middlename'};
1650: my $lastname = $env{'form.lastname'};
1651: my $generation = $env{'form.generation'};
1652: my $section = $env{'form.section'};
1653: my $courseid = $env{'request.course.id'};
1654: my $sid = $env{'form.id'};
1655: my $displayable_starttime = localtime($starttime);
1656: my $displayable_endtime = localtime($endtime);
1657: #
1658: # check for forceid override
1659: if ((defined($old{'id'})) && ($old{'id'} ne '') &&
1660: ($sid ne $old{'id'}) && (! exists($env{'form.forceid'}))) {
1661: $r->print("<font color=\"ff0000\">".&mt('You changed the students id but did not disable the ID change safeguard. The students id will not be changed.')."</font>");
1662: $sid = $old{'id'};
1663: }
1664: #
1665: # talk to the user about what we are going to do
1666: my %lt=&Apache::lonlocal::texthash(
1667: 'mdu' => "Modifying data for user",
1668: 'si' => "Student Information",
1669: 'fd' => "Field",
1670: 'ov' => "Old Value",
1671: 'nv' => "New Value",
1672: 'fn' => "First name",
1673: 'mn' => "Middle name",
1674: 'ln' => "Last name",
1675: 'gen' => "Generation",
1676: 'sec' => "Section",
1677: 'ri' => "Role Information",
1678: 'st' => "Start Time",
1679: 'et' => "End Time",
1680: );
1681: $r->print(<<END);
1682: <h2>$lt{'mdu'} $slogin \@ $sdom </h2>
1683: <h3>$lt{'si'}</h3>
1684: <table rules="rows" border="1" cellpadding="3" >
1685: <tr>
1686: <th> $lt{'fd'} </th>
1687: <th> $lt{'ov'} </th>
1688: <th> $lt{'nv'} </th>
1689: </tr>
1690: <tr>
1691: <td> <b>$lt{'fn'}</b> </td>
1692: <td> $old{'firstname'} </td>
1693: <td> $firstname </td>
1694: </tr><tr>
1695: <td> <b>$lt{'mn'}</b> </td>
1696: <td> $old{'middlename'} </td>
1697: <td> $middlename </td>
1698: </tr><tr>
1699: <td> <b>$lt{'ln'}</b> </td>
1700: <td> $old{'lastname'} </td>
1701: <td> $lastname </td>
1702: </tr><tr>
1703: <td> <b>$lt{'gen'}</b> </td>
1704: <td> $old{'generation'} </td>
1705: <td> $generation </td>
1706: </tr><tr>
1707: <td> <b>ID</b> </td>
1708: <td> $old{'id'} </td>
1709: <td> $sid </td>
1710: </tr><tr>
1711: <td> <b>$lt{'sec'}</b> </td>
1712: <td> $old{'section'} </td>
1713: <td> $section</td>
1714: </tr>
1715: </table>
1716: <h3>$lt{'ri'}</h3>
1717: <table>
1718: <tr><td align="right"><b>$lt{'st'}:</b></td><td> $displayable_starttime </td></tr>
1719: <tr><td align="right"><b>$lt{'et'}:</b></td><td> $displayable_endtime </td></tr>
1720: </table>
1721: <p>
1722: END
1723: #
1724: # Send request(s) to modify data (final undef is for 'desiredhost',
1725: # which is a moot point because the student already has an account.
1726: my $modify_section_results = &modifystudent($sdom,$slogin,
1727: $env{'request.course.id'},
1728: $section,undef);
1729: if ($modify_section_results !~ /^ok/) {
1730: $r->print(&mt('An error occured during the attempt to change the section for this student.')."<br />");
1731: }
1732: my $roleresults = &Apache::lonnet::modifystudent
1733: ($sdom,$slogin,$sid,undef,undef,$firstname,$middlename,$lastname,
1734: $generation,$section,$endtime,$starttime,$env{'form.forceid'});
1735: if ($roleresults eq 'refused' ) {
1736: $r->print(&mt('Your request to change the role information for this student was refused. You do not appear to have sufficient authority to change student information.'));
1737: } elsif ($roleresults !~ /ok/) {
1738: $r->print(&mt('An error occurred during the attempt to change the role information for this student.')." <br />".
1739: &mt('The error reported was')." ".
1740: $roleresults);
1741: &Apache::lonnet::logthis("londropadd:failed attempt to modify student".
1742: " data for ".$slogin." \@ ".$sdom." by ".
1743: $env{'user.name'}." \@ ".$env{'user.domain'}.
1744: ":".$roleresults);
1745: } else { # everything is okay!
1746: $r->print(&mt('Student information updated successfully.')." <br />".
1747: &mt('The student must log out and log in again to see these changes.'));
1748: }
1749: my $Masd=&mt('Modify another students data');
1750: $r->print(<<END);
1751: </p><p>
1752: <input type="hidden" name="action" value="modifystudent" />
1753: <input type="hidden" name="sortby" value="$sortby" />
1754: <input type="hidden" name="Status" value="$status" />
1755: <a href="javascript:document.studentform.submit();">$Masd</a>
1756: </body></html>
1757: END
1758: return;
1759: }
1760:
1761: sub get_enrollment_data {
1762: my ($sname,$sdomain) = @_;
1763: my $courseid = $env{'request.course.id'};
1764: $courseid =~ s:_:/:g;
1765: my %roles = &Apache::lonnet::dump('roles',$sdomain,$sname);
1766: my ($tmp) = keys(%roles);
1767: # Bail out if we were unable to get the students roles
1768: return ('error'.$tmp) if ($tmp =~ /^(con_lost|error|no_such_host)/i);
1769: # Go through the roles looking for enrollment in this course
1770: my ($end,$start) = (undef,undef);
1771: my $section = '';
1772: my $count = scalar(keys(%roles));
1773: while (my ($course,$role) = each(%roles)) {
1774: if ($course=~ /^\/$courseid\/*\s*(\w+)*_st$/ ) {
1775: #
1776: # Get active role
1777: $section=$1;
1778: (undef,$end,$start)=split(/\_/,$role);
1779: my $now=time;
1780: my $notactive=0;
1781: if ($start) {
1782: if ($now<$start) { $notactive=1; }
1783: }
1784: if ($end) {
1785: if ($now>$end) { $notactive=1; }
1786: }
1787: unless ($notactive) { return ($start,$end,$section); }
1788: }
1789: }
1790: return ($start,$end,$section);
1791: }
1792:
1793: #################################################
1794: #################################################
1795:
1796: =pod
1797:
1798: =item show_drop_list
1799:
1800: Display a list of students to drop
1801: Inputs:
1802:
1803: =over 4
1804:
1805: =item $r, Apache request
1806:
1807: =item $classlist, hash pointer returned from loncoursedata::get_classlist();
1808:
1809: =item $keylist, array pointer returned from loncoursedata::get_classlist()
1810: which describes the order elements are stored in the %$classlist values.
1811:
1812: =item $nosort, if true, sorting links are omitted.
1813:
1814: =back
1815:
1816: =cut
1817:
1818: #################################################
1819: #################################################
1820: sub show_drop_list {
1821: my ($r,$classlist,$keylist,$nosort)=@_;
1822: my $cid=$env{'request.course.id'};
1823: if (! exists($env{'form.sortby'})) {
1824: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
1825: ['sortby']);
1826: }
1827: my $sortby = $env{'form.sortby'};
1828: if ($sortby !~ /^(username|domain|section|fullname|id|start|end)$/) {
1829: $sortby = 'username';
1830: }
1831: #
1832: my $action = "drop";
1833: $r->print(<<END);
1834: <input type="hidden" name="sortby" value="$sortby" />
1835: <input type="hidden" name="action" value="$action" />
1836: <input type="hidden" name="state" value="done" />
1837: <script>
1838: function checkAll(field) {
1839: for (i = 0; i < field.length; i++)
1840: field[i].checked = true ;
1841: }
1842:
1843: function uncheckAll(field) {
1844: for (i = 0; i < field.length; i++)
1845: field[i].checked = false ;
1846: }
1847: </script>
1848: <p>
1849: <input type="hidden" name="phase" value="four">
1850: END
1851:
1852: my %lt=&Apache::lonlocal::texthash('usrn' => "username",
1853: 'dom' => "domain",
1854: 'sn' => "student name",
1855: 'sec' => "section",
1856: 'start' => "start date",
1857: 'end' => "end date",
1858: );
1859: if ($nosort) {
1860: $r->print(<<END);
1861: <table border=2>
1862: <tr>
1863: <th> </th>
1864: <th>$lt{'usrn'}</th>
1865: <th>$lt{'dom'}</th>
1866: <th>ID</th>
1867: <th>$lt{'sn'}</th>
1868: <th>$lt{'sec'}</th>
1869: <th>$lt{'start'}</th>
1870: <th>$lt{'end'}</th>
1871: </tr>
1872: END
1873:
1874: } else {
1875: $r->print(<<END);
1876: <table border=2>
1877: <tr><th> </th>
1878: <th>
1879: <a href="/adm/dropadd?action=$action&sortby=username">$lt{'usrn'}</a>
1880: </th><th>
1881: <a href="/adm/dropadd?action=$action&sortby=domain">$lt{'dom'}</a>
1882: </th><th>
1883: <a href="/adm/dropadd?action=$action&sortby=id">ID</a>
1884: </th><th>
1885: <a href="/adm/dropadd?action=$action&sortby=fullname">$lt{'sn'}</a>
1886: </th><th>
1887: <a href="/adm/dropadd?action=$action&sortby=section">$lt{'sec'}</a>
1888: </th><th>
1889: <a href="/adm/dropadd?action=$action&sortby=start">$lt{'start'}</a>
1890: </th><th>
1891: <a href="/adm/dropadd?action=$action&sortby=end">$lt{'end'}</a>
1892: </th>
1893: </tr>
1894: END
1895: }
1896: #
1897: # Sort the students
1898: my %index;
1899: my $i;
1900: foreach (@$keylist) {
1901: $index{$_} = $i++;
1902: }
1903: my $index = $index{$sortby};
1904: my $second = $index{'username'};
1905: my $third = $index{'domain'};
1906: my @Sorted_Students = sort {
1907: lc($classlist->{$a}->[$index]) cmp lc($classlist->{$b}->[$index])
1908: ||
1909: lc($classlist->{$a}->[$second]) cmp lc($classlist->{$b}->[$second])
1910: ||
1911: lc($classlist->{$a}->[$third]) cmp lc($classlist->{$b}->[$third])
1912: } (keys(%$classlist));
1913: foreach my $student (@Sorted_Students) {
1914: my $error;
1915: my $sdata = $classlist->{$student};
1916: my $username = $sdata->[$index{'username'}];
1917: my $domain = $sdata->[$index{'domain'}];
1918: my $section = $sdata->[$index{'section'}];
1919: my $name = $sdata->[$index{'fullname'}];
1920: my $id = $sdata->[$index{'id'}];
1921: my $start = $sdata->[$index{'start'}];
1922: my $end = $sdata->[$index{'end'}];
1923: if (! defined($start) || $start == 0) {
1924: $start = &mt('none');
1925: } else {
1926: $start = &Apache::lonlocal::locallocaltime($start);
1927: }
1928: if (! defined($end) || $end == 0) {
1929: $end = &mt('none');
1930: } else {
1931: $end = &Apache::lonlocal::locallocaltime($end);
1932: }
1933: my $status = $sdata->[$index{'status'}];
1934: next if ($status ne 'Active');
1935: #
1936: $r->print(<<"END");
1937: <tr>
1938: <td><input type="checkbox" name="droplist" value="$student"></td>
1939: <td>$username</td>
1940: <td>$domain</td>
1941: <td>$id</td>
1942: <td>$name</td>
1943: <td>$section</td>
1944: <td>$start</td>
1945: <td>$end</td>
1946: </tr>
1947: END
1948: }
1949: $r->print('</table><br>');
1950: %lt=&Apache::lonlocal::texthash(
1951: 'dp' => "Drop Students",
1952: 'ca' => "check all",
1953: 'ua' => "uncheck all",
1954: );
1955: $r->print(<<"END");
1956: </p><p>
1957: <input type="button" value="$lt{'ca'}" onclick="javascript:checkAll(document.studentform.droplist)">
1958: <input type="button" value="$lt{'ua'}" onclick="javascript:uncheckAll(document.studentform.droplist)">
1959: <p><input type=submit value="$lt{'dp'}"></p>
1960: END
1961: return;
1962: }
1963:
1964: #
1965: # Print out the initial form to get the courselist file
1966: #
1967: sub print_first_courselist_upload_form {
1968: my $r=shift;
1969: my $str;
1970: $str = '<input type="hidden" name="phase" value="two">';
1971: $str .= '<input type="hidden" name="action" value="upload" />';
1972: $str .= '<input type="hidden" name="state" value="got_file" />';
1973: $str .= "<h3>".&mt('Upload a class list')."</h3>\n";
1974: $str .= &Apache::loncommon::upfile_select_html();
1975: $str .= "<p>\n";
1976: $str .= '<input type="submit" name="fileupload" value="'.
1977: &mt('Upload class list').'">'."\n";
1978: $str .= '<input type="checkbox" name="noFirstLine" /> '.
1979: &mt('Ignore First Line')."</p>\n";
1980: $str .= &Apache::loncommon::help_open_topic("Course_Create_Class_List",
1981: &mt("How do I create a class list from a spreadsheet")).
1982: "<br />\n";
1983: $str .= &Apache::loncommon::help_open_topic("Course_Convert_To_CSV",
1984: &mt("How do I create a CSV file from a spreadsheet")).
1985: "<br />\n";
1986: $str .= "</body>\n</html>\n";
1987: $r->print($str);
1988: return;
1989: }
1990:
1991: # ================================================= Drop/Add from uploaded file
1992: sub upfile_drop_add {
1993: my $r=shift;
1994: &Apache::loncommon::load_tmp_file($r);
1995: my @studentdata=&Apache::loncommon::upfile_record_sep();
1996: if($env{'form.noFirstLine'}){shift(@studentdata);}
1997: my @keyfields = split(/\,/,$env{'form.keyfields'});
1998: my $cid = $env{'request.course.id'};
1999: my %fields=();
2000: for (my $i=0; $i<=$env{'form.nfields'}; $i++) {
2001: if ($env{'form.upfile_associate'} eq 'reverse') {
2002: if ($env{'form.f'.$i} ne 'none') {
2003: $fields{$keyfields[$i]}=$env{'form.f'.$i};
2004: }
2005: } else {
2006: $fields{$env{'form.f'.$i}}=$keyfields[$i];
2007: }
2008: }
2009: #
2010: # Store the field choices away
2011: foreach my $field (qw/username names
2012: fname mname lname gen id sec ipwd email/) {
2013: $env{'form.'.$field.'_choice'}=$fields{$field};
2014: }
2015: &Apache::loncommon::store_course_settings('enrollment_upload',
2016: { 'username_choice' => 'scalar',
2017: 'names_choice' => 'scalar',
2018: 'fname_choice' => 'scalar',
2019: 'mname_choice' => 'scalar',
2020: 'lname_choice' => 'scalar',
2021: 'gen_choice' => 'scalar',
2022: 'id_choice' => 'scalar',
2023: 'sec_choice' => 'scalar',
2024: 'ipwd_choice' => 'scalar',
2025: 'email_choice' => 'scalar' });
2026:
2027: #
2028: my ($startdate,$enddate) = &get_dates_from_form();
2029: if ($env{'form.makedatesdefault'}) {
2030: $r->print(&make_dates_default($startdate,$enddate));
2031: }
2032: # Determine domain and desired host (home server)
2033: my $domain=$env{'form.lcdomain'};
2034: my $desiredhost = $env{'form.lcserver'};
2035: if (lc($desiredhost) eq 'default') {
2036: $desiredhost = undef;
2037: } else {
2038: my %home_servers = &Apache::loncommon::get_library_servers($domain);
2039: if (! exists($home_servers{$desiredhost})) {
2040: $r->print('<font color="#ff0000">'.&mt('Error').'</font>'.
2041: &mt('Invalid home server specified'));
2042: $r->print("</body>\n</html>\n");
2043: return;
2044: }
2045: }
2046: # Determine authentication mechanism
2047: my $amode = '';
2048: my $genpwd = '';
2049: if ($env{'form.login'} eq 'krb') {
2050: $amode='krb';
2051: $amode.=$env{'form.krbver'};
2052: $genpwd=$env{'form.krbarg'};
2053: } elsif ($env{'form.login'} eq 'int') {
2054: $amode='internal';
2055: if ((defined($env{'form.intarg'})) && ($env{'form.intarg'})) {
2056: $genpwd=$env{'form.intarg'};
2057: }
2058: } elsif ($env{'form.login'} eq 'loc') {
2059: $amode='localauth';
2060: if ((defined($env{'form.locarg'})) && ($env{'form.locarg'})) {
2061: $genpwd=$env{'form.locarg'};
2062: }
2063: }
2064: if ($amode =~ /^krb/) {
2065: if (! defined($genpwd) || $genpwd eq '') {
2066: $r->print('<font color="red" size="+1">'.
2067: &mt('Unable to enroll students').'</font> '.
2068: &mt('No Kerberos domain was specified.').'</p>');
2069: $amode = ''; # This causes the loop below to be skipped
2070: }
2071: }
2072: unless (($domain=~/\W/) || ($amode eq '')) {
2073: #######################################
2074: ## Enroll Students ##
2075: #######################################
2076: $r->print('<h3>'.&mt('Enrolling Students')."</h3>\n<p>\n");
2077: my $count=0;
2078: my $flushc=0;
2079: my %student=();
2080: # Get new classlist
2081: foreach (@studentdata) {
2082: my %entries=&Apache::loncommon::record_sep($_);
2083: # Determine student name
2084: unless (($entries{$fields{'username'}} eq '') ||
2085: (!defined($entries{$fields{'username'}}))) {
2086: my ($fname, $mname, $lname,$gen) = ('','','','');
2087: if (defined($fields{'names'})) {
2088: ($lname,$fname,$mname)=($entries{$fields{'names'}}=~
2089: /([^\,]+)\,\s*(\w+)\s*(.*)$/);
2090: } else {
2091: if (defined($fields{'fname'})) {
2092: $fname=$entries{$fields{'fname'}};
2093: }
2094: if (defined($fields{'mname'})) {
2095: $mname=$entries{$fields{'mname'}};
2096: }
2097: if (defined($fields{'lname'})) {
2098: $lname=$entries{$fields{'lname'}};
2099: }
2100: if (defined($fields{'gen'})) {
2101: $gen=$entries{$fields{'gen'}};
2102: }
2103: }
2104: if ($entries{$fields{'username'}}=~/\W/) {
2105: $r->print('<br />'.
2106: &mt('<b>[_1]</b>: Unacceptable username for user [_2] [_3] [_4] [_5]',
2107: $entries{$fields{'username'}},$fname,$mname,$lname,$gen).
2108: '</b>');
2109: } else {
2110: # determine section number
2111: my $sec='';
2112: my $username=$entries{$fields{'username'}};
2113: if (defined($fields{'sec'})) {
2114: if (defined($entries{$fields{'sec'}})) {
2115: $sec=$entries{$fields{'sec'}};
2116: }
2117: }
2118: # remove non alphanumeric values from section
2119: $sec =~ s/\W//g;
2120: # determine student id number
2121: my $id='';
2122: if (defined($fields{'id'})) {
2123: if (defined($entries{$fields{'id'}})) {
2124: $id=$entries{$fields{'id'}};
2125: }
2126: $id=~tr/A-Z/a-z/;
2127: }
2128: # determine email address
2129: my $email='';
2130: if (defined($fields{'email'})) {
2131: if (defined($entries{$fields{'email'}})) {
2132: $email=$entries{$fields{'email'}};
2133: unless ($email=~/^[^\@]+\@[^\@]+$/) { $email=''; }
2134: }
2135: }
2136: # determine student password
2137: my $password='';
2138: if ($genpwd) {
2139: $password=$genpwd;
2140: } else {
2141: if (defined($fields{'ipwd'})) {
2142: if ($entries{$fields{'ipwd'}}) {
2143: $password=$entries{$fields{'ipwd'}};
2144: }
2145: }
2146: }
2147: # Clean up whitespace
2148: foreach (\$domain,\$username,\$id,\$fname,\$mname,
2149: \$lname,\$gen,\$sec) {
2150: $$_ =~ s/(\s+$|^\s+)//g;
2151: }
2152: if ($password || $env{'form.login'} eq 'loc') {
2153: &modifystudent($domain,$username,$cid,$sec,
2154: $desiredhost);
2155: my $reply=&Apache::lonnet::modifystudent
2156: ($domain,$username,$id,$amode,$password,
2157: $fname,$mname,$lname,$gen,$sec,$enddate,
2158: $startdate,$env{'form.forceid'},$desiredhost,
2159: $email);
2160: if ($reply ne 'ok') {
2161: $reply =~ s/^error://;
2162: $r->print('<br />'.
2163: &mt('<b>[_1]</b>: Unable to enroll: [_2]',$username,$reply));
2164: } else {
2165: $count++; $flushc++;
2166: $student{$username}=1;
2167: $r->print('. ');
2168: if ($flushc>15) {
2169: $r->rflush;
2170: $flushc=0;
2171: }
2172: }
2173: } else {
2174: $r->print('<br />'.
2175: &mt('<b>[_1]</b>: Unable to enroll. No password specified.',$username)
2176: );
2177: }
2178: }
2179: }
2180: } # end of foreach (@studentdata)
2181: $r->print("</p>\n<p>\n".&mt('Processed [_1] student(s).',$count).
2182: "</p>\n");
2183: $r->print("<p>\n".
2184: &mt('If active, the new role will be available when the '.
2185: 'students next log in to LON-CAPA.')."</p>\n");
2186: #####################################
2187: # Drop students #
2188: #####################################
2189: if ($env{'form.fullup'} eq 'yes') {
2190: $r->print('<h3>'.&mt('Dropping Students')."</h3>\n");
2191: # Get current classlist
2192: my ($classlist,$keylist)=&Apache::loncoursedata::get_classlist();
2193: if (! defined($classlist)) {
2194: $r->print(&mt('There are no students currently enrolled.').
2195: "\n");
2196: } else {
2197: # Remove the students we just added from the list of students.
2198: foreach (@studentdata) {
2199: my %entries=&Apache::loncommon::record_sep($_);
2200: unless (($entries{$fields{'username'}} eq '') ||
2201: (!defined($entries{$fields{'username'}}))) {
2202: delete($classlist->{$entries{$fields{'username'}}.
2203: ':'.$domain});
2204: }
2205: }
2206: # Print out list of dropped students.
2207: &show_drop_list($r,$classlist,$keylist,'nosort');
2208: }
2209: }
2210: } # end of unless
2211: }
2212:
2213: # ================================================================== Phase four
2214: sub drop_student_list {
2215: my $r=shift;
2216: my $count=0;
2217: my @droplist = &Apache::loncommon::get_env_multiple('form.droplist');
2218: foreach (@droplist) {
2219: my ($uname,$udom)=split(/\:/,$_);
2220: # drop student
2221: my $result = &modifystudent($udom,$uname,$env{'request.course.id'});
2222: if ($result eq 'ok' || $result eq 'ok:') {
2223: $r->print(&mt('Dropped [_1]',$uname.'@'.$udom).'<br>');
2224: $count++;
2225: } else {
2226: $r->print(
2227: &mt('Error dropping [_1]:[_2]',$uname.'@'.$udom,$result).
2228: '<br />');
2229: }
2230: }
2231: $r->print('<p><b>'.&mt('Dropped [_1] student(s).',$count).'</b></p>');
2232: $r->print('<p>'.&mt('Re-enrollment will re-activate data.')) if ($count);
2233: }
2234:
2235: ###################################################################
2236: ###################################################################
2237:
2238: =pod
2239:
2240: =item &handler
2241:
2242: The typical handler you see in all these modules. Takes $r, the
2243: http request, as an argument.
2244:
2245: The response to the request is governed by two form variables
2246:
2247: form.action form.state response
2248: ---------------------------------------------------
2249: undefined undefined print main menu
2250: upload undefined print courselist upload menu
2251: upload got_file deal with uploaded file,
2252: print the upload managing menu
2253: upload enrolling enroll students based on upload
2254: drop undefined print the classlist ready to drop
2255: drop done drop the selected students
2256: enrollstudent undefined print student username domain form
2257: enrollstudent gotusername print single student enroll menu
2258: enrollstudent enrolling enroll student
2259: classlist undefined print html classlist
2260: classlist csv print csv classlist
2261: modifystudent undefined print classlist to select student to modify
2262: modifystudent selected print modify student menu
2263: modifystudent done make modifications to student record
2264:
2265: =cut
2266:
2267: ###################################################################
2268: ###################################################################
2269: sub handler {
2270: my $r=shift;
2271: if ($r->header_only) {
2272: &Apache::loncommon::content_type($r,'text/html');
2273: $r->send_http_header;
2274: return OK;
2275: }
2276: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
2277: ['action','state']);
2278:
2279: &Apache::lonhtmlcommon::clear_breadcrumbs();
2280: &Apache::lonhtmlcommon::add_breadcrumb
2281: ({href=>"/adm/dropadd",
2282: text=>"Enrollment Manager",
2283: faq=>9,bug=>'Instructor Interface',});
2284: # Needs to be in a course
2285: if (! ($env{'request.course.fn'})) {
2286: # Not in a course
2287: $env{'user.error.msg'}=
2288: "/adm/dropadd:cst:0:0:Cannot drop or add students";
2289: return HTTP_NOT_ACCEPTABLE;
2290: }
2291: #
2292: my $view_permission =
2293: &Apache::lonnet::allowed('vcl',$env{'request.course.id'});
2294: my $enrl_permission =
2295: &Apache::lonnet::allowed('cst',$env{'request.course.id'});
2296: if (! $view_permission && ! $enrl_permission) {
2297: $env{'user.error.msg'}=
2298: "/adm/dropadd:cst:0:0:Cannot drop or add students";
2299: return HTTP_NOT_ACCEPTABLE;
2300: }
2301: #
2302: # Only output the header information if they did not request csv format
2303: #
2304: # Start page
2305: &Apache::loncommon::content_type($r,'text/html');
2306: $r->send_http_header;
2307: $r->print(&header());
2308: #
2309: # Main switch on form.action and form.state, as appropriate
2310: if (! exists($env{'form.action'})) {
2311: $r->print(&Apache::lonhtmlcommon::breadcrumbs
2312: (undef,'Enrollment Manager'));
2313: &print_main_menu($r,$enrl_permission,$view_permission);
2314: } elsif ($env{'form.action'} eq 'upload' && $enrl_permission) {
2315: &Apache::lonhtmlcommon::add_breadcrumb
2316: ({href=>'/adm/dropadd?action=upload&state=',
2317: text=>"Upload Classlist"});
2318: $r->print(&Apache::lonhtmlcommon::breadcrumbs
2319: (undef,'Upload Classlist','Course_Create_Class_List'));
2320: if (! exists($env{'form.state'})) {
2321: &print_first_courselist_upload_form($r);
2322: } elsif ($env{'form.state'} eq 'got_file') {
2323: &print_upload_manager_form($r);
2324: } elsif ($env{'form.state'} eq 'enrolling') {
2325: if ($env{'form.datatoken'}) {
2326: &upfile_drop_add($r);
2327: } else {
2328: # Hmmm, this is an error
2329: }
2330: } else {
2331: &print_first_courselist_upload_form($r);
2332: }
2333: } elsif ($env{'form.action'} eq 'drop' && $enrl_permission) {
2334: &Apache::lonhtmlcommon::add_breadcrumb
2335: ({href=>'/adm/dropadd?action=drop',
2336: text=>"Drop Students"});
2337: $r->print(&Apache::lonhtmlcommon::breadcrumbs
2338: (undef,'Drop Students','Course_Drop_Student'));
2339: if (! exists($env{'form.state'})) {
2340: &print_drop_menu($r);
2341: } elsif ($env{'form.state'} eq 'done') {
2342: &drop_student_list($r);
2343: } else {
2344: &print_drop_menu($r);
2345: }
2346: } elsif ($env{'form.action'} eq 'enrollstudent' && $enrl_permission) {
2347: &Apache::lonhtmlcommon::add_breadcrumb
2348: ({href=>'/adm/dropadd?action=enrollstudent',
2349: text=>"Enroll Student"});
2350: $r->print(&Apache::lonhtmlcommon::breadcrumbs
2351: (undef,'Enroll Student','Course_Add_Student'));
2352: if (! exists($env{'form.state'})) {
2353: &get_student_username_domain_form($r);
2354: } elsif ($env{'form.state'} eq 'gotusername') {
2355: &print_enroll_single_student_form($r);
2356: } elsif ($env{'form.state'} eq 'enrolling') {
2357: &enroll_single_student($r);
2358: } else {
2359: &get_student_username_domain_form($r);
2360: }
2361: } elsif ($env{'form.action'} eq 'classlist' && $view_permission) {
2362: &Apache::lonhtmlcommon::add_breadcrumb
2363: ({href=>'/adm/dropadd?action=classlist',
2364: text=>"View Classlist"});
2365: $r->print(&Apache::lonhtmlcommon::breadcrumbs
2366: (undef,'View Classlist','Course_View_Class_List'));
2367: if (! exists($env{'form.state'})) {
2368: &print_html_classlist($r,undef);
2369: } elsif ($env{'form.state'} eq 'csv') {
2370: &print_html_classlist($r,'csv');
2371: } elsif ($env{'form.state'} eq 'excel') {
2372: &print_html_classlist($r,'excel');
2373: } else {
2374: &print_html_classlist($r,undef);
2375: }
2376: } elsif ($env{'form.action'} eq 'modifystudent' && $enrl_permission) {
2377: &Apache::lonhtmlcommon::add_breadcrumb
2378: ({href=>'/adm/dropadd?action=modifystudent',
2379: text=>"Modify Student Data"});
2380: $r->print(&Apache::lonhtmlcommon::breadcrumbs
2381: (undef,'Modify Student Data','Course_Modify_Student_Data'));
2382: if (! exists($env{'form.state'})) {
2383: &print_html_classlist($r);
2384: } elsif ($env{'form.state'} eq 'selected') {
2385: &print_modify_student_form($r);
2386: } elsif ($env{'form.state'} eq 'done') {
2387: &modify_single_student($r);
2388: } else {
2389: &print_html_classlist($r);
2390: }
2391: } else {
2392: # We should not end up here, but I guess it is possible
2393: &Apache::lonnet::logthis("Undetermined state in londropadd.pm. ".
2394: "form.action = ".$env{'form.action'}.
2395: "Someone should fix this.");
2396: $r->print(&Apache::lonhtmlcommon::breadcrumbs
2397: (undef,'Enrollment Manager'));
2398: &print_main_menu($r,$enrl_permission,$view_permission);
2399: }
2400: #
2401: # Finish up
2402: $r->print('</form></body></html>');
2403: return OK;
2404: }
2405:
2406: ###################################################################
2407: ###################################################################
2408:
2409: 1;
2410: __END__
2411:
2412:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>