Annotation of loncom/enrollment/Enrollment.pm, revision 1.53

1.7       albertel    1: # Automated Enrollment manager
1.53    ! raeburn     2: # $Id: Enrollment.pm,v 1.52 2017/10/27 13:35:37 raeburn Exp $
1.7       albertel    3: #
                      4: # Copyright Michigan State University Board of Trustees
                      5: #
                      6: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      7: #
                      8: # LON-CAPA is free software; you can redistribute it and/or modify
                      9: # it under the terms of the GNU General Public License as published by
                     10: # the Free Software Foundation; either version 2 of the License, or
                     11: # (at your option) any later version.
                     12: #
                     13: # LON-CAPA is distributed in the hope that it will be useful,
                     14: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     15: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     16: # GNU General Public License for more details.
                     17: #
                     18: # You should have received a copy of the GNU General Public License
                     19: # along with LON-CAPA; if not, write to the Free Software
                     20: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     21: #
                     22: # /home/httpd/html/adm/gpl.txt
                     23: #
                     24: # http://www.lon-capa.org/
                     25: #
1.1       raeburn    26: package LONCAPA::Enrollment;
                     27: 
                     28: use Apache::loncoursedata;
                     29: use Apache::lonnet;
1.32      albertel   30: use Apache::loncommon();
1.8       raeburn    31: use Apache::lonmsg;
1.28      raeburn    32: use Apache::lonlocal;
1.1       raeburn    33: use HTML::Entities;
1.53    ! raeburn    34: use HTML::Parser;
1.1       raeburn    35: use LONCAPA::Configuration;
1.53    ! raeburn    36: use Math::Random;
1.8       raeburn    37: use Time::Local;
                     38: use lib '/home/httpd/lib/perl';
1.1       raeburn    39: 
                     40: use strict;
                     41: 
                     42: sub update_LC {
1.44      raeburn    43:     my ($dom,$crs,$adds,$drops,$startdate,$enddate,$authtype,$autharg,
1.49      raeburn    44:         $showcredits,$defaultcredits,$autofailsafe,$classesref,$groupref,
                     45:         $logmsg,$newusermsg,$context,$phototypes) = @_;
1.19      raeburn    46: # Get institutional code and title of this class
                     47:     my %courseinfo = ();
                     48:     &get_courseinfo($dom,$crs,\%courseinfo);
1.1       raeburn    49: # Get current LON-CAPA student enrollment for this class
                     50:     my $configvars = &LONCAPA::Configuration::read_conf('loncapa.conf');
                     51:     my $cid = $dom."_".$crs;
1.26      raeburn    52:     my $roster = &Apache::loncoursedata::get_classlist($dom,$crs);
1.1       raeburn    53:     my $cend = &Apache::loncoursedata::CL_END;
                     54:     my $cstart = &Apache::loncoursedata::CL_START; 
                     55:     my $stuid=&Apache::loncoursedata::CL_ID;
                     56:     my $sec=&Apache::loncoursedata::CL_SECTION;
                     57:     my $status=&Apache::loncoursedata::CL_STATUS;
                     58:     my $type=&Apache::loncoursedata::CL_TYPE;
1.16      raeburn    59:     my $lockedtype=&Apache::loncoursedata::CL_LOCKEDTYPE;
1.44      raeburn    60:     my $credidx=&Apache::loncoursedata::CL_CREDITS;
1.49      raeburn    61:     my $instidx = &Apache::loncoursedata::CL_INSTSEC;
1.1       raeburn    62:     my @localstudents = ();
1.15      raeburn    63:     my @futurestudents = ();
                     64:     my @activestudents = ();
1.18      raeburn    65:     my @excludedstudents = ();
1.1       raeburn    66:     my $currlist;
1.47      raeburn    67:     my $now = time;
1.1       raeburn    68:     foreach my $uname (keys %{$roster} ) {
                     69:         if ($uname =~ m/^(.+):$dom$/) {
                     70:             if ($$roster{$uname}[$status] eq "Active") {
1.15      raeburn    71:                 push @activestudents, $1;
                     72:                 @{$$currlist{$1}} = @{$$roster{$uname}};
1.1       raeburn    73:                 push @localstudents, $1;
1.15      raeburn    74:             } elsif ( ($$roster{$uname}[$cstart] > time)  && ($$roster{$uname}[$cend] > time || $$roster{$uname}[$cend] == 0 || $$roster{$uname}[$cend] eq '') ) {
                     75:                 push @futurestudents, $1;
1.1       raeburn    76:                 @{$$currlist{$1}} = @{$$roster{$uname}};
1.15      raeburn    77:                 push @localstudents, $1;
1.18      raeburn    78:             } elsif ($$roster{$uname}[$lockedtype] == 1) {
                     79:                 push @excludedstudents, $1;
1.1       raeburn    80:             }
                     81:         }
                     82:     }
                     83:     my $linefeed = '';
                     84:     my $addresult = '';
                     85:     my $dropresult = '';
1.21      raeburn    86:     my $switchresult = '';
1.28      raeburn    87:     my $photoresult = '';
1.1       raeburn    88:     if ($context eq "updatenow") {
                     89:         $linefeed = "</li>\n<li>"; 
                     90:     } elsif ($context eq "automated") {
                     91:         $linefeed = "\n";
                     92:     }
                     93:     my $enrollcount = 0;
                     94:     my $dropcount = 0;
1.21      raeburn    95:     my $switchcount = 0;
1.1       raeburn    96: 
1.19      raeburn    97: # Get role names
                     98:     my %longroles = ();
                     99:     open(FILE,"<$$configvars{'lonTabDir'}.'/rolesplain.tab");
                    100:     my @rolesplain = <FILE>;
                    101:     close(FILE);
1.42      raeburn   102:     foreach my $item (@rolesplain) {
                    103:         if ($_ =~ /^(st|ta|ex|ad|in|cc|co):([\w\s]+):?([\w\s]*)/) {
                    104:             if ($courseinfo{'type'} eq 'Community') {
                    105:                 unless($1 eq 'cc') {
                    106:                     $longroles{$1} = $3;
                    107:                 }
                    108:             } else {
                    109:                 unless($1 eq 'co') { 
                    110:                     $longroles{$1} = $2;
                    111:                 }
                    112:             }
1.19      raeburn   113:         }
                    114:     }
                    115: 
1.8       raeburn   116:     srand( time() ^ ($$ + ($$ << 15))  ); # Seed rand in case initial passwords have to be generated for new users.
                    117: 
1.1       raeburn   118: # Get mapping of IDs to usernames for current LON-CAPA student enrollment for this class 
                    119:     my @LCids = ();
                    120:     my %unameFromLCid = ();
                    121:     foreach my $uname (sort keys %{$currlist}) {
                    122:         my $stuID = $$currlist{$uname}[$stuid];
                    123:         if (!grep/^$stuID$/,@LCids) {
                    124:             push @LCids, $stuID;
                    125:             @{$unameFromLCid{$stuID}} = ();
                    126:         }
                    127:         push @{$unameFromLCid{$stuID}},$uname;
                    128:     }
                    129:  
                    130: # Get latest institutional enrollment for this class.
                    131:     my %allenrolled = ();
                    132:     my @reg_students = ();
1.38      raeburn   133:     my %place = &place_hash(); 
1.1       raeburn   134:     my %ucount = ();
                    135:     my %enrollinfo = ();
1.49      raeburn   136:     my %classcount;
1.1       raeburn   137:     foreach my $class (@{$classesref}) {
                    138:         my %enrolled = ();
                    139:         &parse_classlist($$configvars{'lonDaemons'},$dom,$crs,$class,\%place,$$groupref{$class},\%enrolled);
1.49      raeburn   140:         $classcount{$class} = scalar(keys(%enrolled));
1.1       raeburn   141:         foreach my $uname (sort keys %enrolled ) {
                    142:             if (!grep/^$uname$/,@reg_students) {
                    143:                 push @reg_students,$uname;
                    144:                 $ucount{$uname} = 0;
                    145:                 @{$allenrolled{$uname}} = ();
                    146:             }
                    147:             @{$allenrolled{$uname}[$ucount{$uname}]} = @{$enrolled{$uname}};
                    148:             $ucount{$uname} ++;
                    149:         }
                    150:     }
                    151: 
                    152: # Check for multiple sections for a single student 
                    153:     my @okusers = ();
                    154:     foreach my $uname (@reg_students)  {
1.18      raeburn   155:         if (grep/^$uname$/,@excludedstudents) {
1.33      raeburn   156:             $$logmsg .= &mt('No re-enrollment for [_1] - user was previously manually unenrolled and locked.',$uname).$linefeed;
1.18      raeburn   157:         } elsif (@{$allenrolled{$uname}} > 1) {
1.1       raeburn   158:             my @sections = ();
                    159:             my $saved;
                    160:             for (my $i=0; $i<@{$allenrolled{$uname}}; $i++) {
                    161:                 my @stuinfo = @{$allenrolled{$uname}[$i]};
                    162:                 my $secnum = $stuinfo[ $place{'groupID'} ];
                    163:                 unless ($secnum eq '') {
                    164:                     unless (grep/^$secnum$/,@sections) {
                    165:                         $saved = $i; 
                    166:                         push @sections,$secnum;
                    167:                     }
                    168:                 }
                    169:             }
                    170:             if (@sections == 0) {
                    171:                 @{$enrollinfo{$uname}} = @{$allenrolled{$uname}[0]};
                    172:                 push @okusers, $uname;
                    173:             }
                    174:             elsif (@sections == 1) {
                    175:                 @{$enrollinfo{$uname}} = @{$allenrolled{$uname}[$saved]};
                    176:                 push @okusers, $uname;
                    177:             }
                    178:             elsif (@sections > 1) {
1.33      raeburn   179:                 $$logmsg .=  &mt('[_1] appears in classlists for more than one section of this course, i.e. in sections: ',$uname);
1.1       raeburn   180:                 foreach (@sections) {
1.5       raeburn   181:                     $$logmsg .= " $_,";
1.1       raeburn   182:                 }
1.5       raeburn   183:                 chop($$logmsg);
1.33      raeburn   184:                 $$logmsg .= '. '.&mt('Because of this ambiguity, no enrollment action was taken for this student.').$linefeed;
1.1       raeburn   185:             }
                    186:         } else {
                    187:             @{$enrollinfo{$uname}} = @{$allenrolled{$uname}[0]};
                    188:             push @okusers, $uname;
                    189:         }
                    190:     }
1.40      weissno   191: # Get mapping of student/employee IDs to usernames for users in institutional data for this class  
1.1       raeburn   192:     my @allINids = ();
1.3       raeburn   193:     my %unameFromINid = ();
1.1       raeburn   194:     foreach my $uname (@okusers) {
                    195:         $enrollinfo{$uname}[ $place{'studentID'} ] =~ tr/A-Z/a-z/;
                    196:         my $stuID = $enrollinfo{$uname}[ $place{'studentID'} ];
                    197:         if (grep/^$stuID$/,@allINids)  {
                    198:             push @{$unameFromINid{$stuID}},$uname;
                    199:         } else {
                    200:             push @allINids, $stuID;
                    201:             @{$unameFromINid{$stuID}} = $uname; 
                    202:         }
                    203:     }
1.28      raeburn   204: 
1.48      raeburn   205: # Explicitly allow access to creation/modification of students and group membership changes 
                    206: # when called as an automated process.
1.5       raeburn   207:     if ($context eq 'automated') {
1.22      albertel  208:         $env{'allowed.cst'}='F';
1.48      raeburn   209:         $env{'allowed.mdg'}='F';
1.5       raeburn   210:     }
                    211: 
1.1       raeburn   212: # Compare IDs with existing LON-CAPA enrollment for this class
                    213:     foreach my $uname (@okusers) {
1.5       raeburn   214:         unless ($uname eq '') {
                    215:             my %uidhash=&Apache::lonnet::idrget($dom,$uname);
                    216:             my @stuinfo = @{$enrollinfo{$uname}};
1.49      raeburn   217:             my ($access,$added,$inststatus,$instsec);
1.44      raeburn   218:             my $credits;
                    219:             if ($showcredits) {
                    220:                 $credits = $stuinfo[$place{'credits'}];
                    221:                 $credits =~ s/[^\d\.]//g;
                    222:                 if ($credits eq $defaultcredits) {
                    223:                     undef($credits);
                    224:                 }
                    225:             }
                    226:             $inststatus = $stuinfo[$place{inststatus}];
1.49      raeburn   227:             $instsec = $stuinfo[$place{instsec}];
1.5       raeburn   228:             if (grep/^$uname$/,@localstudents) {
1.1       raeburn   229: # Check for studentID changes
1.5       raeburn   230:                 if ( ($uidhash{$uname}) && ($uidhash{$uname} !~ /error\:/) )  {
                    231:                     unless ( ($uidhash{$uname}) eq ($stuinfo[ $place{studentID} ]) ) {
1.33      raeburn   232:                         $$logmsg .= &mt('Change in ID for [_1]. StudentID in LON-CAPA system is [_2]; StudentID in institutional data is [_3].',$uname,$uidhash{$uname},$stuinfo[ $place{studentID} ]).$linefeed; 
1.5       raeburn   233:                     }
1.1       raeburn   234:                 }
1.16      raeburn   235: # Check for switch from manual to auto
                    236:                 unless (($$currlist{$uname}[$type] eq "auto") || ($$currlist{$uname}[$lockedtype] eq "1") || (!$adds) ) {
                    237: # drop manually added student
1.38      raeburn   238:                     my $drop_reply = &Apache::lonnet::modifystudent($dom,$uname,'','','',undef,undef,undef,undef,$$currlist{$uname}[$sec],time,undef,undef,undef,undef,'auto','',$cid,'',$context);
1.16      raeburn   239: # re-enroll as auto student
                    240:                     if ($drop_reply !~ /^ok/) {
1.46      raeburn   241:                             $$logmsg .= &mt('An error occurred during the attempt to convert [_1] from a manual type to an auto type student - [_2].',$uname,$drop_reply).$linefeed;
1.16      raeburn   242:                     } else {
                    243: # re-enroll as auto student
                    244:                         my ($auth,$authparam,$first,$middle,$last,$gene,$usec,$end,$start,$emailaddr,$pid,$emailenc);
                    245:                         &prepare_add($authtype,$autharg,$enddate,$startdate,\@stuinfo,\%place,\$dom,\$uname,\$auth,\$authparam,\$first,\$middle,\$last,\$gene,\$usec,\$end,\$start,\$emailaddr,\$pid,\$emailenc);
                    246:                         if ($$currlist{$uname}[$sec] ne $usec) {
1.33      raeburn   247:                             my $showoldsec = $$currlist{$uname}[$sec];
                    248:                             if ($$currlist{$uname}[$sec] eq '') {
                    249:                                 $showoldsec = &mt('none');
                    250:                             }
                    251:                             my $showsec = $usec;
                    252:                             if ($usec eq '') {
                    253:                                 $showsec = &mt('none');
                    254:                             }
1.44      raeburn   255:                             $switchresult .= &mt('Section for [_1] switched from [_2] to [_3].',$uname,$showoldsec,$showsec).$linefeed;
1.21      raeburn   256:                             if ($context eq 'automated') {
1.44      raeburn   257:                                 $$logmsg .= &mt('Section switch for [_1] from [_2] to [_3].',$uname,$showoldsec,$usec).$linefeed;
1.21      raeburn   258:                             }
                    259:                             $switchcount ++;
1.16      raeburn   260:                         }
1.44      raeburn   261:                         &execute_add($context,'switchtype',$uname,$dom,$auth,
                    262:                                      $authparam,$first,$middle,$last,$gene,
                    263:                                      $pid,$usec,$end,$start,$emailenc,
1.49      raeburn   264:                                      $credits,$instsec,$cid,\$addresult,\$enrollcount,
1.44      raeburn   265:                                      $linefeed,$logmsg);
                    266:                         $added = 1;
1.16      raeburn   267:                     }
1.44      raeburn   268:                 }
1.1       raeburn   269: # Check for section changes
1.15      raeburn   270:                 if ($$currlist{$uname}[$sec] eq $stuinfo[ $place{groupID} ]) {
                    271: # Check for access date changes for students with access starting in the future.
                    272:                     if ( (grep/^$uname$/,@futurestudents) && ($$currlist{$uname}[$type] eq "auto") && ($adds == 1) ) {
1.16      raeburn   273:                         my $datechange = &datechange_check($$currlist{$uname}[$cstart],$$currlist{$uname}[$cend],$startdate,$enddate);
1.15      raeburn   274:                         if ($datechange) {
1.49      raeburn   275:                             my $modify_access_result = &Apache::lonnet::modify_student_enrollment($dom,$uname,undef,undef,undef,undef,undef,$stuinfo[ $place{groupID} ],$enddate,$startdate,'auto','',$cid,'',$context,$credits,$instsec);
1.15      raeburn   276:                             $access = &showaccess($enddate,$startdate);
                    277:                             if ($modify_access_result =~ /^ok/) {
1.33      raeburn   278:                                 $$logmsg .= &mt('Change in access dates for [_1].',$uname).$access.$linefeed;
1.44      raeburn   279:                                 $added = 1;
1.15      raeburn   280:                             } else {
1.33      raeburn   281:                                 $$logmsg .= &mt('Error when attempting to change start and/or end access dates for [_1] in section: [_2] -error [_3].',$uname,$stuinfo[$place{groupID}],$modify_access_result).$linefeed;
1.15      raeburn   282:                             }
                    283:                         }
                    284:                     }
                    285:                 } else {
1.5       raeburn   286:                     if ( ($$currlist{$uname}[$type] eq "auto") && ($adds == 1) ) {
1.10      raeburn   287: # Delete from roles.db for current section
                    288:                         my $expiretime = time;
                    289:                         my $uurl='/'.$cid;
                    290:                         $uurl=~s/\_/\//g;
                    291:                         if ($$currlist{$uname}[$sec]) {
                    292:                             $uurl.='/'.$$currlist{$uname}[$sec];
                    293:                         }
1.38      raeburn   294:                         my $expire_role_result = &Apache::lonnet::assignrole($dom,$uname,$uurl,'st',$expiretime,'','','',$context);
1.10      raeburn   295:                         if ($expire_role_result eq 'ok') {
1.15      raeburn   296:                             my $modify_section_result;
                    297:                             if (grep/^$uname$/,@activestudents) {
1.49      raeburn   298:                                 $modify_section_result = &Apache::lonnet::modify_student_enrollment($dom,$uname,undef,undef,undef,undef,undef,$stuinfo[ $place{groupID} ],$$currlist{$uname}[$cend],$$currlist{$uname}[$cstart],'auto','',$cid,'',$context,$credits,$instsec);
1.15      raeburn   299:                             } else {
1.49      raeburn   300:                                 $modify_section_result =  &Apache::lonnet::modify_student_enrollment($dom,$uname,undef,undef,undef,undef,undef,$stuinfo[ $place{groupID} ],$enddate,$startdate,'auto','',$cid,'',$context,$credits,$instsec);
1.15      raeburn   301:                                 $access =  &showaccess($enddate,$startdate);
                    302:                             }
1.10      raeburn   303:                             if ($modify_section_result =~ /^ok/) {
1.44      raeburn   304:                                 $switchresult .= &mt('Section for [_1] switched from old section: [_2] to new section: [_3].',$uname,$$currlist{$uname}[$sec],$stuinfo[ $place{groupID} ]).$access.$linefeed;
                    305:                                 $added = 1;
1.21      raeburn   306:                                 if ($context eq 'automated') {
1.44      raeburn   307:                                     $$logmsg .= &mt('Section switch for [_1] from [_2] to [_3].',$uname,$$currlist{$uname}[$sec],$stuinfo[ $place{groupID} ]).$linefeed;
1.21      raeburn   308:                                 }
                    309:                                 $switchcount ++;
1.10      raeburn   310:                             } else {
1.33      raeburn   311:                                 $$logmsg .= &mt("Error when attempting section change for [_1], from old section: '[_2]' to new section: '[_3]' -error: [_4]",$uname,$$currlist{$uname}[$sec],$stuinfo[ $place{groupID} ],$modify_section_result).$linefeed;
1.10      raeburn   312:                             }
1.5       raeburn   313:                         } else {
1.33      raeburn   314:                             $$logmsg .= &mt("Error when attempting to expire role for [_1] in old section: '[_2]' -error: '[_3]'.",$uname,$$currlist{$uname}[$sec],$expire_role_result).$linefeed;
1.5       raeburn   315:                         }
1.1       raeburn   316:                     }
                    317:                 }
1.44      raeburn   318: # Check for credits changes
                    319:                 if (($showcredits) && 
                    320:                     ($$currlist{$uname}[$credidx] ne $credits) && (!$added)) {
                    321:                     my $modify_credits_result =
1.49      raeburn   322:                         &Apache::lonnet::modify_student_enrollment($dom,$uname,undef,undef,undef,undef,undef,$stuinfo[ $place{groupID} ],$enddate,$startdate,'auto','',$cid,'',$context,$credits,$instsec);
1.44      raeburn   323:                     if ($modify_credits_result =~ /^ok/) {
                    324:                         if ($credits ne '') {
                    325:                             $$logmsg .= &mt('Credits change for [_1] from [_2] to [_3].',$uname,$$currlist{$uname}[$credidx],$credits).$linefeed;
                    326:                         } else {
                    327:                             $$logmsg .= &mt('Credits change for [_1] from [_2] to course default [_3].',$uname,$$currlist{$uname}[$credidx],$defaultcredits).$linefeed;
                    328:                         }
                    329:                     } else {
                    330:                         $$logmsg .= &mt('Error when attempting to change credits for [_1] in section: [_2] -error [_3].',$uname,$stuinfo[$place{groupID}],$modify_credits_result).$linefeed;
                    331:                     }
                    332:                 }
1.49      raeburn   333: # Check for institutional section change
1.51      raeburn   334:                 if (($$currlist{$uname}[$instidx] ne $instsec) && (!$added)) {
1.49      raeburn   335:                     my $modify_instsec_result =
                    336:                         &Apache::lonnet::modify_student_enrollment($dom,$uname,undef,undef,undef,undef,undef,$stuinfo[ $place{groupID} ],$enddate,$startdate,'auto','',$cid,'',$context,$credits,$instsec);
                    337:                     if ($modify_instsec_result =~ /^ok/) {
                    338:                         $$logmsg .= &mt('Institutional section change for [_1] from [_2] to [_3].',$uname,$$currlist{$uname}[$instidx],$instsec).$linefeed;
                    339:                     } else {
                    340:                         $$logmsg .= &mt('Error when attempting to change institutional section for [_1] in section: [_2] -error [_3].',$uname,$stuinfo[$place{groupID}],$modify_instsec_result).$linefeed;
                    341:                     }
                    342:                 }
1.5       raeburn   343:             } else {
1.1       raeburn   344: # Check for changed usernames by checking studentIDs
1.5       raeburn   345:                 if ( ($stuinfo[ $place{studentID} ] ne '') && (grep/^$stuinfo[ $place{studentID} ]$/,@LCids) ) {
1.27      raeburn   346:                     foreach my $match ( @{ $unameFromLCid{ $stuinfo[ $place{studentID} ] } }  ) {
1.40      weissno   347:                         $$logmsg .= &mt('A possible change in username has been detected for a student enrolled in this course.').' '.&mt('The existing LON-CAPA classlist contains user: [_1] and student/employee ID: [_2].',$match,$stuinfo[ $place{studentID} ]);
1.27      raeburn   348:                         if (grep/^$match$/,@okusers) {
1.40      weissno   349:                             $$logmsg .= &mt('The username [_1] remains in the institutional classlist, but the same student/employee ID is used for new user: [_2] now found in the institutional classlist.',$match,$uname).' '.&mt('You may need to contact your Domain Coordinator to determine how to resolve this issue and whether to move student data files for user: [_1] to [_2].',$match,$uname).' ';
1.27      raeburn   350:                         } else {
                    351:                             unless ($drops == 1) {
1.40      weissno   352:                                 $$logmsg .= &mt('This username - [_1] - has been dropped from the institutional classlist, but the student/employee ID of this user is also used by [_2] who now appears in the institutional classlist.',$match,$uname).' '.&mt('You may need to contact your Domain Coordinator to request a move of the student data files for user: [_1] to [_2].',$match,$uname).' ';
1.5       raeburn   353:                             }
1.1       raeburn   354:                         }
1.40      weissno   355:                         $$logmsg .= &mt('Because of this student/employee ID conflict, the new username - [_1] - has not been added to the LON-CAPA classlist',$uname).$linefeed;
1.1       raeburn   356:                     }
1.5       raeburn   357:                 } elsif ($adds == 1) {
1.44      raeburn   358:                     my ($auth,$authparam,$first,$middle,$last,$gene,$usec,$end,$start,$emailaddr,$pid,$emailenc,$credithours);
1.16      raeburn   359:                     &prepare_add($authtype,$autharg,$enddate,$startdate,\@stuinfo,\%place,\$dom,\$uname,\$auth,\$authparam,\$first,\$middle,\$last,\$gene,\$usec,\$end,\$start,\$emailaddr,\$pid,\$emailenc);
1.1       raeburn   360: # Check for existing account in this LON-CAPA domain for this username
1.47      raeburn   361:                     next if (($end) && ($end < $now));
1.5       raeburn   362:                     my $uhome=&Apache::lonnet::homeserver($uname,$dom);
                    363:                     if ($uhome eq 'no_host') { # User does not exist
1.19      raeburn   364:                         my $args = {'auth' => $auth,
                    365:                                     'authparam' => $authparam,
                    366:                                     'emailenc' => $emailenc,
                    367:                                     'udom' => $dom,
                    368:                                     'uname' => $uname,
                    369:                                     'pid' => $pid,
                    370:                                     'first' => $first,
                    371:                                     'middle' => $middle,
                    372:                                     'last' => $last,
                    373:                                     'gene' => $gene,
                    374:                                     'usec' => $usec,
                    375:                                     'end' => $end,
                    376:                                     'start' => $start,
                    377:                                     'emailaddr' => $emailaddr,
                    378:                                     'cid' => $cid,
                    379:                                     'crs' => $crs,
                    380:                                     'cdom' => $dom,
                    381:                                     'context' => $context,
                    382:                                     'linefeed' => $linefeed,
1.44      raeburn   383:                                     'inststatus' => $inststatus,
1.49      raeburn   384:                                     'instsec'  => $instsec,
1.44      raeburn   385:                                     'role' => 'st',
1.19      raeburn   386:                                    };
1.44      raeburn   387:                         if ($credits) {
                    388:                             $args->{'credits'} = $credits;
                    389:                         }
1.38      raeburn   390:                         my $outcome = &create_newuser($args,$logmsg,$newusermsg,\$enrollcount,\$addresult,\%longroles,\%courseinfo,$context);
1.5       raeburn   391:                     } else {
1.44      raeburn   392:                         &execute_add($context,'newstudent',$uname,$dom,$auth,
                    393:                                      $authparam,$first,$middle,$last,$gene,$pid,
1.49      raeburn   394:                                      $usec,$end,$start,$emailenc,$credits,$instsec,
1.44      raeburn   395:                                      $cid,\$addresult,\$enrollcount,$linefeed,
                    396:                                      $logmsg);
1.3       raeburn   397:                     }
1.31      raeburn   398:                     if ($courseinfo{'showphoto'}) {
1.28      raeburn   399:                         my ($result,$resulttype) = 
                    400:                            &Apache::lonnet::auto_checkphotos($uname,$dom,$pid);
                    401:                         if ($resulttype) {
                    402:                             push(@{$$phototypes{$resulttype}},$uname);
                    403:                         }
                    404:                     }
1.1       raeburn   405:                 }
                    406:             }
                    407:         }
                    408:     }
1.31      raeburn   409:     if ($courseinfo{'showphoto'}) {
1.28      raeburn   410:         if (keys(%{$phototypes})>0) {
                    411:             my %lt = &photo_response_types();
                    412:             foreach my $type (sort(keys(%{$phototypes}))) {
                    413:                 my $numphoto = @{$$phototypes{$type}};
                    414:                 if ($numphoto > 0) {
                    415:                     if ($context eq 'updatenow') {
                    416:                         $photoresult .=  '<br /><b>'.
1.29      albertel  417: 			    &mt('For [_1] students, photos ',$numphoto).
                    418: 			    $lt{$type}.'</b><ul><li>';
1.28      raeburn   419:                     } else {
1.33      raeburn   420:                         $photoresult .=  "\n".&mt("For [quant,_1,student], photos ",$numphoto).
1.29      albertel  421: 			    $lt{$type}."\n";
1.28      raeburn   422:                     }
                    423:                     foreach my $user (@{$$phototypes{$type}}) { 
                    424:                         $photoresult .= $user.$linefeed;
                    425:                     }
                    426:                     if ($context eq 'updatenow') {
                    427:                         $photoresult = substr($photoresult,0,
1.29      albertel  428: 					      rindex($photoresult,"<li>"));
1.28      raeburn   429:                         $photoresult .= '</ul><br />';
                    430:                     } else {
                    431:                         $photoresult .= "\n";
                    432:                     }
                    433:                 }
                    434:             }
                    435:         }
                    436:     }
                    437: 
1.1       raeburn   438: # Do drops
                    439:     if ( ($drops == 1) && (@reg_students > 0) ) {
1.49      raeburn   440:         my %delaydrops;
1.1       raeburn   441:         foreach my $uname (@localstudents) {
                    442:             if ($$currlist{$uname}[$type] eq "auto") {
                    443:                 my @saved = ();
                    444:                 if (!grep/^$uname$/,@reg_students) {
                    445: # Check for changed usernames by checking studentIDs
                    446:                     if (grep/^$$currlist{$uname}[ $stuid ]$/,@allINids) {
                    447:                         foreach my $match (@{$unameFromINid{$$currlist{$uname}[ $stuid ]}} ) {
1.52      raeburn   448:                             $$logmsg .= &mt('A possible change in username has been detected for a student enrolled in this course.').' '.&mt('The existing LON-CAPA classlist contains user: [_1] and student/employee ID: [_2].',$uname,$$currlist{$uname}[ $stuid ]).' '.&mt('This username has been dropped from the institutional classlist, but the same student/employee ID is used for user: [_1] who still appears in the institutional classlist.',$match).' '.&mt('You may need to move the student data files for user: [_1] to [_2]',$uname,$match).' '.&mt('Because of this, user [_1] has not been dropped from the course.',$uname).$linefeed;
1.1       raeburn   449:                             push @saved,$uname;
                    450:                         }
                    451:                     } elsif (@saved == 0) {
1.49      raeburn   452: # Check enrollment count for institutional section of student to be dropped 
                    453:                         if ($$currlist{$uname}[$instidx]) {
                    454:                             if (exists($classcount{$$currlist{$uname}[$instidx]})) {
                    455:                                 if ($classcount{$$currlist{$uname}[$instidx]} == 0) {
                    456:                                     if ($autofailsafe) {
                    457:                                         push(@{$delaydrops{$$currlist{$uname}[$instidx]}},$uname);    
                    458:                                         next;
                    459:                                     }
                    460:                                 }
                    461:                             }
                    462:                         }
1.38      raeburn   463:                         my $drop_reply = &Apache::lonnet::modifystudent($dom,$uname,'','','',undef,undef,undef,undef,$$currlist{$uname}[$sec],time,undef,undef,undef,undef,'auto','',$cid,'',$context);
1.1       raeburn   464:                         if ($drop_reply !~ /^ok/) {
1.46      raeburn   465:                             $$logmsg .= &mt('An error occurred during the attempt to expire the [_1] from the old section [_2] - [_3].',$uname,$$currlist{$uname}[$sec],$drop_reply).$linefeed;
1.1       raeburn   466:                         } else {
                    467:                             $dropcount ++;
                    468:                             my %userenv = &Apache::lonnet::get('environment',['firstname','lastname','id'],$dom,$uname);
1.38      raeburn   469:                             $dropresult .= $userenv{'firstname'}." ".$userenv{'lastname'}." (".$userenv{'id'}.") - ".$uname.' '.&mt("dropped from section: '[_1]'.",$$currlist{$uname}[$sec]).$linefeed; 
1.8       raeburn   470:                             if ($context eq 'automated') {
1.33      raeburn   471:                                 $$logmsg .= &mt('User [_1] student role expired from course.',$uname).$linefeed;
1.8       raeburn   472:                             }
1.1       raeburn   473:                         }
                    474:                     }
                    475:                 }
                    476:             }
                    477:         }
1.49      raeburn   478:         if (scalar(keys(%delaydrops)) > 0) {
                    479:             foreach my $class (keys(%delaydrops)) {
                    480:                 if (ref($delaydrops{$class}) eq 'ARRAY') {
                    481:                     if ($autofailsafe < scalar(@{$delaydrops{$class}})) {
                    482:                         $$logmsg .= &mt('The following students were not expired from the old section [_1] because the enrollment count retrieved for that institutional section was zero, and the number of students with roles to expire exceeded the failsafe threshold of [_2]:',$class,$autofailsafe);
                    483:                         if ($context eq "updatenow") {
1.50      raeburn   484:                             $$logmsg .= '<br />'.join('<br />',@{$delaydrops{$class}}).$linefeed; 
1.49      raeburn   485:                         } elsif ($context eq "automated") {
1.50      raeburn   486:                             $$logmsg .= $linefeed.join($linefeed,@{$delaydrops{$class}}).$linefeed;
1.49      raeburn   487:                         }
                    488:                     } else {
                    489:                         foreach my $uname (@{$delaydrops{$class}}) {
                    490:                             my $drop_reply = &Apache::lonnet::modifystudent($dom,$uname,'','','',undef,undef,undef,undef,$$currlist{$uname}[$sec],time,undef,undef,undef,undef,'auto','',$cid,'',$context);
                    491:                             if ($drop_reply !~ /^ok/) {
                    492:                                 $$logmsg .= &mt('An error occurred during the attempt to expire the [_1] from the old section [_2] - [_3].',$uname,$$currlist{$uname}[$sec],$drop_reply).$linefeed;
                    493:                             } else {
                    494:                                 $dropcount ++;
                    495:                                 my %userenv = &Apache::lonnet::get('environment',['firstname','lastname','id'],$dom,$uname);
                    496:                                 $dropresult .= $userenv{'firstname'}." ".$userenv{'lastname'}." (".$userenv{'id'}.") - ".$uname.' '.&mt("dropped from section: '[_1]'.",$$currlist{$uname}[$sec]).$linefeed;
                    497:                                 if ($context eq 'automated') {
                    498:                                    $$logmsg .= &mt('User [_1] student role expired from course.',$uname).$linefeed;
                    499:                                 }
                    500:                             }
                    501:                         }
                    502:                     }
                    503:                 }
                    504:             }
                    505:         }
1.1       raeburn   506:     }
1.5       raeburn   507: 
1.48      raeburn   508: # Terminated explictly allowed access to student creation/modification 
                    509: # and group membership changes
1.5       raeburn   510:     if ($context eq 'automated') {
1.22      albertel  511:         delete($env{'allowed.cst'});
1.48      raeburn   512:         delete($env{'allowed.mdg'});
1.5       raeburn   513:     }
1.1       raeburn   514:     if ($enrollcount > 0) {
                    515:         if ($context eq "updatenow") {
1.6       raeburn   516:             $addresult = substr($addresult,0,rindex($addresult,"<li>"));
1.33      raeburn   517:             $addresult = &mt("The following [quant,_1,student was,students were] added to this LON-CAPA course:",$enrollcount).'<br/><ul><li>'.$addresult.'</ul><br/><br/>';
1.1       raeburn   518:         } else {
1.33      raeburn   519:             $addresult = &mt("The following [quant,_1,student was,students were] added to this LON-CAPA course:",$enrollcount)."\n\n".$addresult."\n\n";
1.21      raeburn   520:         }
1.1       raeburn   521:     }
                    522:     if ($dropcount > 0) {
                    523:         if ($context eq "updatenow") {
1.6       raeburn   524:             $dropresult = substr($dropresult,0,rindex($dropresult,"<li>"));
1.33      raeburn   525:             $dropresult = &mt("The following [quant,_1,student was,students were] expired from this LON-CAPA course:",$dropcount).'<br/><ul><li>'.$dropresult.'</ul><br/><br/>';
1.1       raeburn   526:         } else {
1.33      raeburn   527:             $dropresult = &mt("The following [quant,_1,student was,students were] expired from this LON-CAPA course:",$dropcount)."\n\n".$dropresult."\n\n";
1.1       raeburn   528:         }
                    529:     }
1.21      raeburn   530:     if ($switchcount > 0) {
                    531:         if ($context eq "updatenow") {
                    532:             $switchresult = substr($switchresult,0,rindex($switchresult,"<li>"));
1.33      raeburn   533:             $switchresult = &mt("The following [quant,_1,student] switched sections in this LON-CAPA course:",$switchcount).'<br/><ul><li>'.$switchresult.'</ul><br/><br/>';
1.21      raeburn   534:         } else {
1.33      raeburn   535:             $switchresult = &mt("The following [quant,_1,student] switched sections in this LON-CAPA course:",$switchcount)."\n\n".$switchresult."\n\n";
1.21      raeburn   536:         }
                    537:     }
1.1       raeburn   538:     if ( ($adds) && ($enrollcount == 0) ) {
1.33      raeburn   539:         $addresult = &mt('There were no new students to add to the course.');
1.1       raeburn   540:         if ($context eq "updatenow") {
                    541:             $addresult .="<br/><br/>";
                    542:         } else {
                    543:             $addresult .="\n";
                    544:         }
                    545:     }
                    546:     if ( ($drops) && ($dropcount == 0) ) {
1.33      raeburn   547:         $dropresult = &mt('There were no students with roles to expire because all active students previously added to the course from institutional classlist(s) are still officially registered.');
1.1       raeburn   548:         if ($context eq "updatenow") {
                    549:             $dropresult .="<br/>";
                    550:         } else {
                    551:             $dropresult .="\n";
                    552:         }
                    553:     }
1.21      raeburn   554:     my $changecount = $enrollcount + $dropcount + $switchcount;
1.28      raeburn   555:     return ($changecount,$addresult.$photoresult.$dropresult.$switchresult);
1.6       raeburn   556: }
1.1       raeburn   557: 
1.19      raeburn   558: sub create_newuser {
1.36      albertel  559:     my ($args,$logmsg,$newusermsg,$enrollcount,$addresult,$longroles,
                    560: 	$courseinfo,$called_context) = @_;
1.19      raeburn   561:     my $auth = $args->{'auth'};
                    562:     my $authparam = $args->{'authparam'};
                    563:     my $emailenc = $args->{'emailenc'};
                    564:     my $udom = $args->{'udom'};
                    565:     my $uname = $args->{'uname'};
                    566:     my $pid = $args->{'pid'};
                    567:     my $first = $args->{'first'};
                    568:     my $middle = $args->{'middle'};
                    569:     my $last = $args->{'last'} ;
                    570:     my $gene = $args->{'gene'};
                    571:     my $usec = $args->{'usec'};
                    572:     my $end = $args->{'end'};
                    573:     my $start = $args->{'start'};
                    574:     my $emailaddr = $args->{'emailaddr'};
                    575:     my $cid = $args->{'cid'};
                    576:     my $crs = $args->{'crs'};
                    577:     my $cdom = $args->{'cdom'};
                    578:     my $context = $args->{'context'};
                    579:     my $linefeed = $args->{'linefeed'};
                    580:     my $role = $args->{'role'};
1.44      raeburn   581:     my $inststatus = $args->{'inststatus'};
                    582:     my $credits = $args->{'credits'};
1.49      raeburn   583:     my $instsec = $args->{'instsec'};
1.19      raeburn   584:     my $create_passwd = 0;
                    585:     my $authchk = '';
                    586:     my $outcome;
                    587:     unless ($authparam eq '') { $authchk = 'ok'; };
                    588: # If no account exists and passwords should be generated
                    589:     if ($auth eq "internal") {
                    590:         if ($authparam eq '') {
1.53    ! raeburn   591:             $authparam = &create_password($udom);
1.19      raeburn   592:             if ($authparam eq '') {
                    593:                 $authchk = '';
                    594:             } else {
                    595:                 $create_passwd = 1;
                    596:                 $authchk = 'ok';
                    597:             }
                    598:         }
                    599:     } elsif ($auth eq "localauth") {
1.34      raeburn   600:         ($authparam,$create_passwd,$authchk) = &Apache::lonnet::auto_create_password($crs,$cdom,$authparam,$udom);
1.19      raeburn   601:     } elsif ($auth =~ m/^krb/) {
                    602:         if ($authparam eq '') {
1.33      raeburn   603:             $$logmsg .= &mt('No Kerberos domain was provided for the new user - [_1], so the new user was not enrolled in the course',$uname).$linefeed;
1.19      raeburn   604:             $authchk = 'invalid';
                    605:         }
                    606:     } else {
                    607:         $authchk = 'invalid';
1.33      raeburn   608:         $$logmsg .= &mt('An invalid authentication type was provided for the new user - [_1], so the user was not enrolled in the course.',$uname).$linefeed;
1.34      raeburn   609:     }
1.19      raeburn   610:     if ($authchk eq 'ok') {
                    611: # Now create user.
                    612:         my $type = 'auto';
                    613:         my $userurl = '/'.$cdom.'/'.$crs;
                    614:         if ($usec ne '') {
                    615:             $userurl .= '/'.$usec;
                    616:         }
                    617:         if ($context eq 'createowner' || $context eq 'createcourse') {
                    618:             my $result = &Apache::lonnet::modifyuser($udom,$uname,$pid,$auth,$authparam,$first,$middle,$last,$gene,'1',undef,$emailaddr);
                    619:             if ($result eq 'ok' && $context eq 'createcourse') {
1.36      albertel  620:                 $outcome = &Apache::loncommon::commit_standardrole($udom,$uname,$userurl,$role,$start,$end,$cdom,$crs,$usec,$called_context);
1.19      raeburn   621:                 unless ($outcome =~ /^Error:/) {
                    622:                     $outcome = 'ok';
                    623:                 }
                    624:             } else {
                    625:                 $outcome = $result;
                    626:             }
                    627:         } else {
1.49      raeburn   628:             $outcome=&Apache::lonnet::modifystudent($udom,$uname,$pid,$auth,$authparam,$first,$middle,$last,$gene,$usec,$end,$start,'',undef,$emailaddr,'auto','',$cid,'',$called_context,$inststatus,$credits,$instsec);
1.19      raeburn   629:         }
                    630:         if ($outcome eq 'ok') {
                    631:             my $access = &showaccess($end,$start);
1.33      raeburn   632:             my $showsec = $usec;
                    633:             if ($usec eq '') {
                    634:                 $showsec = &mt('none');
                    635:             }
1.38      raeburn   636:             $$addresult .= "$first $last ($pid) - $uname ".&mt("enrolled in section: '[_1]'.",$showsec).$access.$linefeed;
1.19      raeburn   637:             unless ($context eq 'createowner' || $context eq 'createcourse') {
                    638:                 $$enrollcount ++;
                    639:             }
1.36      albertel  640:             if ($called_context eq 'automated') {
1.33      raeburn   641:                 $$logmsg .= &mt('New [_1] user [_2] added successfully.',$udom,$uname);
1.19      raeburn   642:             }
                    643:             unless ($emailenc eq '' || $context eq 'createowner' || $context eq 'createcourse') {
                    644:                 my %emailHash;
                    645:                 $emailHash{'critnotification'}  = $emailenc;
                    646:                 $emailHash{'notification'} = $emailenc;
1.23      raeburn   647:                 $emailHash{'permanentemail'} = $emailenc;
1.19      raeburn   648:                 my $putresult = &Apache::lonnet::put('environment',\%emailHash,$udom,$uname);
                    649:             }
                    650:             if ($create_passwd) {
                    651: # Send e-mail with initial password to new user at $emailaddr.
                    652: # If e-mail address is invalid, send password via message to courseowner i
                    653: # (if automated call) or to user if roster update.
                    654:                 if ($emailaddr eq '') {
1.33      raeburn   655:                     $$newusermsg .= &mt(' username: [_1], password: [_2]',$uname,$authparam).$linefeed."\n";
1.19      raeburn   656:                 } else {
1.33      raeburn   657:                     my $subject = &mt('New LON-CAPA account');
1.19      raeburn   658:                     my $body;
1.41      raeburn   659:                     my $portalurl = 'http://'.$ENV{'SERVER_NAME'};
                    660:                     my $protocol = 'http';
                    661:                     my $lonhost=&Apache::lonnet::domain($udom,'primary');
                    662:                     if ($lonhost ne '') {
                    663:                         my $ip = &Apache::lonnet::get_host_ip($lonhost);
                    664:                         if ($Apache::lonnet::protocol{$lonhost} eq 'https') {
                    665:                             $protocol = 'https';
                    666:                         }
                    667:                         if ($ip ne '') {
                    668:                             $portalurl = $protocol.'://'.$ip
                    669:                         }
                    670:                     }
1.19      raeburn   671:                     if ($context eq 'createowner') {
1.41      raeburn   672:                         $body = &mt('A user account has been created for you while creating your new course in the LON-CAPA course management and online homework system.')."\n\n".&mt('You should log-in to the system using the following credentials:')."\n".&mt('username: ').$uname."\n".&mt('password: ').$authparam."\n\n".&mt('The URL you should use to access the LON-CAPA system at your institution is: ').$portalurl."\n\n";
1.19      raeburn   673:                     } elsif ($context eq 'createcourse') {
1.41      raeburn   674:                         $body = &mt('You have been assigned the role of [_1] in a new course: [_2] - [_3] in the LON-CAPA course management and online homework system.',$$longroles{$role},$$courseinfo{'description'},$$courseinfo{'inst_code'}).' '.&mt('As you did not have an existing user account in the system, one has been created for you.')."\n\n".&mt("You should log-in to the system using the following credentials:\nusername: [_1]\npassword: [_2]",$uname,$authparam)."\n\n".&mt('The URL you should use to access the LON-CAPA system at your institution is: ').$portalurl."\n\n"; 
1.19      raeburn   675:                     } else {
                    676:                         my $access_start = 'immediately';
                    677:                         if ($start > 0) {
                    678:                             $access_start = localtime($start)
                    679:                         }
1.45      bisitz    680:                         $body =
                    681:                             &mt('You have been enrolled in the LON-CAPA system at your institution, because you are a registered student in a class which is using the LON-CAPA course management and online homework system.')."\n\n"
                    682:                            .&mt("You should log-in to the system using the following credentials:\nusername: [_1]\npassword: [_2]",$uname,$authparam)."\n\n"
                    683:                            .&mt('The URL you should use to access the LON-CAPA system at your institution is: ').$portalurl."\n\n"
                    684:                            .&mt('When you log-in you will be able to access the LON-CAPA course for [_1] - [_2] starting [_3].',$$courseinfo{'description'},$$courseinfo{'inst_code'},$access_start)."\n";
1.19      raeburn   685:                     }
                    686:                     &Apache::lonmsg::sendemail($emailaddr,$subject,$body);
                    687:                 }
1.36      albertel  688:                 if ($called_context eq 'automated') {
1.33      raeburn   689:                     $$logmsg .= &mt(' Initial password - sent to ').$emailaddr.$linefeed;
1.19      raeburn   690:                 }
                    691:             } else {
1.36      albertel  692:                 if ($called_context eq 'automated') {
1.19      raeburn   693:                     $$logmsg .= $linefeed;
                    694:                 }
                    695:             }
                    696:         } else {
1.33      raeburn   697:             $$logmsg .= &mt('An error occurred adding new user [_1] - [_2].',$uname,$outcome).$linefeed;
1.19      raeburn   698:         }
1.34      raeburn   699:     } else {
                    700:         $$logmsg .= &mt('An error occurred adding the new user [_1] because the authcheck failed for authtype [_2] and parameter [_3].',$uname,$auth,$authparam).' '.&mt('The authcheck response was [_1].',$authchk).$linefeed;
1.19      raeburn   701:     }
                    702:     return $outcome;
                    703: }
                    704: 
1.16      raeburn   705: sub prepare_add {
                    706:     my ($authtype,$autharg,$enddate,$startdate,$stuinfo,$place,$dom,$uname,$auth,$authparam,$first,$middle,$last,$gene,$usec,$end,$start,$emailaddr,$pid,$emailenc) = @_;
                    707:     $$auth = $$stuinfo[ $$place{'authtype'} ];
                    708:     $$authparam = $$stuinfo[ $$place{'autharg'} ];
                    709:     $$first = $$stuinfo[ $$place{'firstname'} ];
                    710:     $$middle = $$stuinfo[ $$place{'middlename'} ];
                    711:     $$last = $$stuinfo[ $$place{'lastname'} ];
                    712:     $$gene = $$stuinfo[ $$place{'generation'} ];
                    713:     $$usec = $$stuinfo[ $$place{'groupID'} ];
                    714:     $$end = $$stuinfo[ $$place{'enddate'} ];
                    715:     $$start = $$stuinfo[ $$place{'startdate'} ];
                    716:     $$emailaddr = $$stuinfo[ $$place{'email'} ];
                    717:     $$pid = $$stuinfo[ $$place{'studentID'} ];
1.47      raeburn   718: 
1.16      raeburn   719: # remove non alphanumeric values from section
                    720:     $$usec =~ s/\W//g;
                    721:                                                                                   
                    722:     unless ($$emailaddr =~/^[^\@]+\@[^\@]+$/) { $$emailaddr =''; }
                    723:     $$emailenc = &HTML::Entities::encode($$emailaddr,'<>&"');
                    724:                                                                                   
                    725: # Use course defaults where entry is absent
                    726:     if ( ($$auth eq '') || (!defined($$auth)) ) {
                    727:         $$auth =  $authtype;
                    728:     }
                    729:     if ( ($$authparam eq '')  || (!defined($$authparam)) )  {
                    730:         $$authparam = $autharg;
                    731:     }
                    732:     if ( ($$end eq '') || (!defined($$end)) )  {
                    733:         $$end = $enddate;
                    734:     }
                    735:     if ( ($$start eq '')  || (!defined($$start)) )  {
                    736:         $$start = $startdate;
                    737:     }
                    738: # Clean up whitespace
                    739:     foreach ($dom,$uname,$pid,$first,$middle,$last,$gene,$usec) {
                    740:         $$_ =~ s/(\s+$|^\s+)//g;
                    741:     }
                    742:     return;
                    743: }
                    744: 
                    745: sub execute_add {
1.44      raeburn   746:     my ($context,$caller,$uname,$dom,$auth,$authparam,$first,$middle,$last,
1.49      raeburn   747:         $gene,$pid,$usec,$end,$start,$emailenc,$credits,$instsec,$cid,$addresult,
1.44      raeburn   748:         $enrollcount,$linefeed,$logmsg) = @_;
1.16      raeburn   749: # Get the user's information and authentication
1.44      raeburn   750:     my %userenv = &Apache::lonnet::get('environment',['firstname','middlename','lastname','generation','id','critnotification','notification','permanentemail','inststatus'],$dom,$uname);
1.16      raeburn   751:     my ($tmp) = keys(%userenv);
                    752:     if ($tmp =~ /^(con_lost|error)/i) {
                    753:         %userenv = ();
                    754:     }
                    755: # Get the user's e-mail address
                    756:     if ($userenv{critnotification} =~ m/%40/) {
                    757:         unless ($emailenc eq $userenv{critnotification}) {
1.41      raeburn   758:             $$logmsg .= &mt('Current critical notification e-mail - [_1] for [_2] is different to e-mail address in institutional classlist - [_3].',
                    759:                            $userenv{critnotification},$uname,$emailenc).
                    760:                         $linefeed;
1.16      raeburn   761:         }
                    762:     }
                    763:     if ($userenv{notification} =~ m/%40/) {
1.23      raeburn   764:         unless ($emailenc eq $userenv{notification}) {
1.41      raeburn   765:             $$logmsg .= &mt('Current standard notification e-mail - [_1] for [_2] is different to e-mail address in institutional classlist - [_3].',
                    766:                             $userenv{notification},$uname,$emailenc).
                    767:                         $linefeed;
1.16      raeburn   768:         }
                    769:     }
1.23      raeburn   770:     if ($userenv{permanentemail} =~ m/%40/) {
                    771:         unless ($emailenc eq $userenv{permanentemail}) {
1.33      raeburn   772:             $$logmsg .= &mt('Current permanent e-mail
                    773: - [_1] for [_2] is different to e-mail address in institutional classlist - [_3]',$userenv{permanentemail},$uname,$emailenc).$linefeed;
1.23      raeburn   774:         }
                    775:     }
1.16      raeburn   776:     my $krbdefdom = '';
                    777:     my $currentauth=&Apache::lonnet::queryauthenticate($uname,$dom);
                    778:     if ($currentauth=~/^(krb[45]):(.*)/) {
                    779:         $currentauth = $1;
                    780:         $krbdefdom = $2;
                    781:     } elsif ($currentauth=~ /^(unix|internal|localauth):/) {
                    782:         $currentauth = $1;
                    783:     } else {
1.33      raeburn   784:         $$logmsg .= &mt('Invalid authentication method [_1] for [_2].',$currentauth,$uname).$linefeed;
1.16      raeburn   785:     }
                    786: # Report if authentication methods are different.
                    787:     if ($currentauth ne $auth) {
1.33      raeburn   788:         $$logmsg .= &mt("Authentication type mismatch for [_1] - '[_2]' in system, '[_3]' based on information in classlist or default for this course.",$uname,$currentauth,$auth).$linefeed;
1.16      raeburn   789:     } elsif ($auth =~ m/^krb/) {
                    790:         if ($krbdefdom ne $authparam) {
1.33      raeburn   791:             $$logmsg .= &mt("Kerberos domain mismatch for [_1] - '[_2]' in system, '[_3]' based on information in classlist or default for this course.",$uname,$krbdefdom,$authparam).$linefeed;
1.16      raeburn   792:         }
                    793:     }
                    794:                                                                                   
                    795: # Check user data
                    796:     if ($first  ne $userenv{'firstname'}  ||
                    797:         $middle ne $userenv{'middlename'} ||
                    798:         $last   ne $userenv{'lastname'}   ||
                    799:         $gene   ne $userenv{'generation'} ||
1.23      raeburn   800:         $pid    ne $userenv{'id'} ||
                    801:         $emailenc ne $userenv{'permanentemail'} ) {
1.16      raeburn   802: # Make the change(s)
                    803:         my %changeHash;
                    804:         $changeHash{'firstname'}  = $first;
                    805:         $changeHash{'middlename'} = $middle;
                    806:         $changeHash{'lastname'}   = $last;
                    807:         $changeHash{'generation'} = $gene;
                    808:         $changeHash{'id'} = $pid;
1.23      raeburn   809:         $changeHash{'permanentemail'} = $emailenc;
1.16      raeburn   810:         my $putresult = &Apache::lonnet::put('environment',\%changeHash,$dom,$uname);
                    811:         if ($putresult eq 'ok') {
1.37      raeburn   812:             $$logmsg .= &mt('User information updated for user: [_1] prior to enrollment.',$uname).$linefeed;
1.16      raeburn   813:         } else {
1.33      raeburn   814:             $$logmsg .= &mt('There was a problem modifying user data for existing user - [_1] -error: [_2], enrollment will still be attempted.',$uname,$putresult).$linefeed;
1.16      raeburn   815:         }
                    816:     }
                    817:                                                                                   
                    818: # Assign the role of student in the course.
1.44      raeburn   819:     my $classlist_reply = 
                    820:         &Apache::lonnet::modify_student_enrollment($dom,$uname,$pid,$first,$middle,
                    821:                                                    $last,$gene,$usec,$end,$start,
                    822:                                                    'auto','',$cid,'',$context,
1.49      raeburn   823:                                                    $credits,$instsec);
1.16      raeburn   824:     if ($classlist_reply eq 'ok') {
                    825:         my $access = &showaccess($end,$start);
1.33      raeburn   826:         my $showsec = $usec;
                    827:         if ($usec eq '') {
                    828:             $showsec = &mt('none');
                    829:         }
1.16      raeburn   830:         if ($caller eq 'switchtype') {
1.38      raeburn   831:             $$logmsg .= &mt("Existing user [_1] detected in institutional classlist - switched from 'manual' to 'auto' enrollment in section [_2].",$uname,$showsec).$access.$linefeed;
1.16      raeburn   832:         } elsif ($caller eq 'newstudent') {
                    833:             $$enrollcount ++;
1.38      raeburn   834:             $$addresult .= "$first $last ($pid) - $uname ".&mt("enrolled in section '[_1]'.",$showsec).$access.$linefeed;
1.16      raeburn   835:         }
                    836:         if ($context eq 'automated') {
1.33      raeburn   837:             $$logmsg .= &mt('Existing [_1] user [_2] enrolled successfully.',$dom,$uname).$linefeed;
1.16      raeburn   838:         }
                    839:     } else {
1.33      raeburn   840:            $$logmsg .= &mt('There was a problem updating the classlist db file for user [_1] to show the new enrollment -error: [_2], so no enrollment occurred for this user.',$uname,$classlist_reply).$linefeed;
1.16      raeburn   841:     }
                    842:     return;
                    843: }
                    844: 
                    845: sub datechange_check {
                    846:     my ($oldstart,$oldend,$startdate,$enddate) = @_;
                    847:     my $datechange = 0;
                    848:     unless ($oldstart eq $startdate) {
                    849:         $datechange = 1;
                    850:     }
                    851:     if (!$datechange) {
                    852:         if (!$oldend) {
                    853:             if ($enddate) {
                    854:                 $datechange = 1;
                    855:             }
                    856:         } elsif ($oldend ne $enddate) {
                    857:             $datechange = 1;
                    858:         }
                    859:     }
                    860:     return $datechange;
                    861: }
                    862: 
1.15      raeburn   863: sub showaccess {
                    864:     my ($end,$start) = @_;
                    865:     my $showstart;
                    866:     my $showend;
                    867:     if ( (!$start) || ($start <= time) ) {
                    868:         $showstart = 'immediately';
                    869:     } else {
                    870:         $showstart = &Apache::lonlocal::locallocaltime($start);
                    871:     }
                    872:     if (!$end) {
                    873:         $showend = 'no end date';
                    874:     } else {
                    875:         $showend = &Apache::lonlocal::locallocaltime($end);
                    876:     }
1.33      raeburn   877:     my $access_msg = ' '.&mt('Access starts: [_1], ends: [_2].',$showstart,$showend);
1.15      raeburn   878:     return $access_msg;
                    879: }
                    880: 
1.1       raeburn   881: sub parse_classlist {
1.6       raeburn   882:     my ($tmpdir,$dom,$crs,$class,$placeref,$groupID,$studentsref) = @_;
1.5       raeburn   883:     my $xmlfile = $tmpdir."/tmp/".$dom."_".$crs."_".$class."_classlist.xml";
1.6       raeburn   884:     my $uname = '';
                    885:     my @state;
1.44      raeburn   886:     my @items = ('autharg','authtype','email','firstname','generation','lastname','middlename','studentID','credits','inststatus');
1.6       raeburn   887:     my $p = HTML::Parser->new
                    888:     (
                    889:         xml_mode => 1,
                    890:         start_h =>
                    891:             [sub {
                    892:                  my ($tagname, $attr) = @_;
                    893:                  push @state, $tagname;
                    894:                  if ("@state" eq "students student") {
                    895:                      $uname = $attr->{username};
1.43      raeburn   896:                      $$studentsref{$uname}[ $$placeref{'groupID'} ] = $groupID;
1.49      raeburn   897:                      $$studentsref{$uname}[ $$placeref{'instsec'} ] = $class;
1.6       raeburn   898:                  }
                    899:             }, "tagname, attr"],
                    900:          text_h =>
                    901:              [sub {
                    902:                  my ($text) = @_;
1.43      raeburn   903:                  if ("@state" eq "students student startdate") {
1.8       raeburn   904:                      my $start = $text;
                    905:                      unless ($text eq '') {
                    906:                          $start = &process_date($text);
                    907:                      }
                    908:                      $$studentsref{$uname}[ $$placeref{'startdate'} ] = $start; 
                    909:                  } elsif ("@state" eq "students student enddate") {
                    910:                      my $end = $text;
                    911:                      unless ($text eq '') {
                    912:                          $end = &process_date($text);
                    913:                      }
                    914:                      $$studentsref{$uname}[ $$placeref{'enddate'} ] = $end;
1.6       raeburn   915:                  } else {
                    916:                      foreach my $item (@items) {
                    917:                          if ("@state" eq "students student $item") {
                    918:                              $$studentsref{$uname}[ $$placeref{$item} ] = $text;
                    919:                          }
                    920:                      }
                    921:                  }
                    922:                }, "dtext"],
                    923:          end_h =>
                    924:                [sub {
                    925:                    my ($tagname) = @_;
                    926:                    pop @state;
                    927:                 }, "tagname"],
                    928:     );
                    929:                                                                                                              
                    930:     $p->parse_file($xmlfile);
                    931:     $p->eof;
1.8       raeburn   932:     if (-e "$xmlfile") {
                    933:         unlink $xmlfile;
                    934:     }
1.3       raeburn   935:     return;
1.1       raeburn   936: }
                    937: 
1.8       raeburn   938: sub process_date {
                    939:     my $timestr = shift;
                    940:     my $timestamp = '';
                    941:     if ($timestr =~ m/^\d{4}:\d{2}:\d{2}/) {
                    942:         my @entries = split/:/,$timestr;
                    943:         for (my $j=0; $j<@entries; $j++) {
                    944:             if ( length($entries[$j]) > 1 ) {
                    945:                 $entries[$j] =~ s/^0//;
                    946:             }
                    947:         }
                    948:         $entries[1] = $entries[1] - 1;
                    949:         $timestamp =  timelocal($entries[5],$entries[4],$entries[3],$entries[2],$entries[1],$entries[0]);
                    950:     }
                    951:     return $timestamp;
                    952: }
                    953: 
1.1       raeburn   954: sub create_password {
1.53    ! raeburn   955:     my ($udom) = @_;
        !           956:     my %passwdconf = &Apache::lonnet::get_passwdconf($udom);
        !           957:     my ($min,$max,@chars);
        !           958:     if (ref($passwdconf{'chars'}) eq 'ARRAY') {
        !           959:         if ($passwdconf{'min'} =~ /^\d+$/) {
        !           960:             $min = $passwdconf{'min'};
        !           961:         }
        !           962:         if ($passwdconf{'max'} =~ /^\d+$/) {
        !           963:             $max = $passwdconf{'max'};
        !           964:         }
        !           965:         @chars = @{$passwdconf{'chars'}};
        !           966:     }
        !           967:     my @letts = qw(b c d f g h j k l m n p q r s t v w x y z);
        !           968:     my (@included,%reqd);
        !           969:     if (@chars) {
        !           970:         map { $reqd{$_} = 1; } @chars;
        !           971:     }
        !           972:     if ($reqd{'uc'}) {
        !           973:         my $letter = $letts[int( rand(21) )];   
        !           974:         $letter =~ tr/a-z/A-Z/;
        !           975:         if ($letter ne '') {
        !           976:             push(@included,$letter); 
        !           977:         }
        !           978:     }
        !           979:     if ($reqd{'lc'}) {
        !           980:         my $letter = $letts[int( rand(21) )];
        !           981:         if ($letter ne '') {
        !           982:             push(@included,$letter);
        !           983:         } 
        !           984:     }
        !           985:     if ($reqd{'num'}) {
        !           986:         my $number = int( rand(10) );
        !           987:         if ($number ne '') {
        !           988:             push(@included,$number);
        !           989:         }
        !           990:     }
        !           991:     if ($reqd{'spec'}) {
        !           992:         my @specs = qw(! # * & _ - + $);
        !           993:         my $special = $specs[int( rand(8) )];
        !           994:         if ($special ne '') {
        !           995:             push(@included,$special);
        !           996:         }
        !           997:     }
        !           998:     my $start = 0;
        !           999:     if (scalar(@included) > 0) {
        !          1000:         $start = scalar(@included);
        !          1001:     }
        !          1002:     my $end = 8;
        !          1003:     if ($min =~ /^\d+$/) {
        !          1004:         if ($min > $end) {
        !          1005:             $end = $min;
        !          1006:         } 
        !          1007:     }
        !          1008:     for (my $i=$start; $i<$end; $i++) {
1.8       raeburn  1009:         my $lettnum = int (rand 2);
                   1010:         my $item = '';
                   1011:         if ($lettnum) {
1.53    ! raeburn  1012:             $item = $letts[int( rand(21) )];
1.8       raeburn  1013:             my $uppercase = int(rand 2);
                   1014:             if ($uppercase) {
                   1015:                 $item =~ tr/a-z/A-Z/;
                   1016:             }
                   1017:         } else {
                   1018:             $item = int( rand(10) );
1.53    ! raeburn  1019:         }
        !          1020:         if ($item ne '') {
        !          1021:             push(@included,$item);
        !          1022:         }
1.8       raeburn  1023:     }
1.53    ! raeburn  1024:     my $passwd = join('',&Math::Random::random_permutation(@included));
        !          1025:     return $passwd;
1.9       raeburn  1026: }
                   1027: 
1.19      raeburn  1028: sub get_courseinfo {
                   1029:     my ($dom,$crs,$courseinfo) = @_;
                   1030:     my $owner;
                   1031:     if (defined($dom) && defined($crs)) {
1.44      raeburn  1032:         my %settings = &Apache::lonnet::get('environment',['internal.coursecode','internal.showphoto','description','internal.defaultcredits'],$dom,$crs);
1.19      raeburn  1033:         if ( defined($settings{'internal.coursecode'}) ) {
                   1034:             $$courseinfo{'inst_code'} = $settings{'internal.coursecode'};
                   1035:         }
                   1036:         if ( defined($settings{'description'}) ) {
                   1037:             $$courseinfo{'description'} = $settings{'description'};
                   1038:         }
1.31      raeburn  1039:         if ( defined($settings{'internal.showphoto'}) ) {
                   1040:             $$courseinfo{'showphoto'} = $settings{'internal.showphoto'};
1.28      raeburn  1041:         }
1.44      raeburn  1042:         if ( defined($settings{'internal.credithours'}) ) {
                   1043:             $$courseinfo{'defaultcredits'} = $settings{'internal.defaultcredits'};
                   1044:         }
1.19      raeburn  1045:     }
                   1046:     return;
                   1047: }
                   1048: 
1.38      raeburn  1049: sub place_hash {
                   1050:     my %place = (
                   1051:                   autharg   => 0,
                   1052:                   authtype  => 1,
                   1053:                   email     => 2,
                   1054:                   enddate   => 3,
                   1055:                   firstname => 4,
                   1056:                   generation => 5,
                   1057:                   groupID    => 6,
                   1058:                   lastname   => 7,
                   1059:                   middlename => 8,
                   1060:                   startdate  => 9,
                   1061:                   studentID  => 10,
1.44      raeburn  1062:                   credits    => 11,
                   1063:                   inststatus => 12,
1.49      raeburn  1064:                   instsec    => 13,
1.38      raeburn  1065:                 );
                   1066:     return %place;
                   1067: }
1.1       raeburn  1068: 
1.28      raeburn  1069: sub photo_response_types {
1.29      albertel 1070:     my %lt = &Apache::lonlocal::texthash(
1.28      raeburn  1071:                       'same' => 'remained unchanged',
                   1072:                       'update' => 'were updated',
                   1073:                       'new' => 'were added',
                   1074:                       'missing' => 'were missing',
                   1075:                       'error' => 'were not imported because an error occurred',
                   1076:                       'nouser' => 'were for users without accounts',
1.40      weissno  1077:                       'noid' => 'were for users without student/employee IDs',
1.29      albertel 1078: 					 );
1.28      raeburn  1079:     return %lt;
                   1080: }
                   1081: 
                   1082: 
1.1       raeburn  1083: 1;

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