[BACK]Return to localenroll.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / enrollment

Diff for /loncom/enrollment/localenroll.pm between versions 1.5 and 1.8

version 1.5, 2003/12/11 15:43:29 version 1.8, 2004/03/18 01:02:20
Line 29  package localenroll; Line 29  package localenroll;
 use strict;  use strict;
   
 ################################  ################################
   # sub run
   # set this to return 1 if you want the auto enrollment to run
   ################################
   
   sub run { return 0; }
   
   ################################
 # sub fetch_enrollment  # sub fetch_enrollment
 #  #
 # connects to the institutional classlist data source,  # connects to the institutional classlist data source,
Line 43  use strict; Line 50  use strict;
 # where DOMAIN = msu  COURSE = 43551dedcd43febmsul1   # where DOMAIN = msu  COURSE = 43551dedcd43febmsul1 
 # INSTITUTIONALCODE = fs03nop590001   # INSTITUTIONALCODE = fs03nop590001 
 # (MSU's course naming scheme - fs03 = Fall semester 2003, nop =  # (MSU's course naming scheme - fs03 = Fall semester 2003, nop =
 # department name, 590 = course number, 001 = section number.  # department name, 590 = course number, 001 = section number.)
 #  #
 # fetch_enrollment requires three arguments -  # fetch_enrollment requires three arguments -
 # $dom - DOMAIN e.g., msu  # $dom - DOMAIN e.g., msu
Line 98  use strict; Line 105  use strict;
 #</students>  #</students>
 #  #
 # The <startdate> and the <enddate> are the activation date and expiration date  # The <startdate> and the <enddate> are the activation date and expiration date
 # for this student's role. If they are absent, then the date set for  # for this student's role. If they are absent, then neither a start date nor an end
 # first automated enrollment is used as the default activation date, and the  # date will be set, and the student role will remain active until the role is 
 # date set for last automated enrollment is used as the default expiration date.  # explicitly expired using ENRL -> Drop students.    
   # An option to set a default activation date, and a default expiration date will
   # be added to loncreatecourse.pm, and lonpopulate.pm in a future release.
   # Once these default parameters are available, they will be used as the start date and
   # the end date in cases where the <startdate> and <enddate> fields are blank.
 # If dates are to included in the XML file, they should be in the format  # If dates are to included in the XML file, they should be in the format
 # YYYY:MM:DD:HH:MM:SS (: separators required).  # YYYY:MM:DD:HH:MM:SS (: separators required).
 #  #
Line 128  use strict; Line 139  use strict;
 ################################  ################################
   
 sub fetch_enrollment {  sub fetch_enrollment {
   my ($dom,$affiliatesref,$replyref) = @_;      my ($dom,$affiliatesref,$replyref) = @_;
      foreach my $crs (sort keys %{$affiliatesref}) {      foreach my $crs (sort keys %{$affiliatesref}) {
          $$replyref{$crs} = 0;          $$replyref{$crs} = 0;
      }      }
   }      my $okflag = 0;
   my $okflag = 0;      return $okflag;
   return $okflag;  
 }  }
   
 ###############################  ###############################
Line 151  sub fetch_enrollment { Line 161  sub fetch_enrollment {
 # official sections and provides a checkbox to use to  # official sections and provides a checkbox to use to
 # select enrollment in the LON-CAPA course from each official section.    # select enrollment in the LON-CAPA course from each official section.  
 #  #
 # get_sections requires one argument - the instituional coursecode  # get_sections requires one argument - the institutional coursecode
 # (in the MSU case this is a concatenation of semester code, department  # (in the MSU case this is a concatenation of semester code, department
 # and course number).   # and course number). 
 #   # 
Line 175  sub get_sections { Line 185  sub get_sections {
 # lonpopulate.pm to record that fact that a new course section  # lonpopulate.pm to record that fact that a new course section
 # has been added to LON-CAPA that requires access to institutional data  # has been added to LON-CAPA that requires access to institutional data
 # At MSU, this is required, as institutional classlists can only made  # At MSU, this is required, as institutional classlists can only made
 # available to faculty who are officially assigned to a course  # available to faculty who are officially assigned to a course.
 #   # 
 # The new_course subroutine is used to check that the course owner  # The new_course subroutine is used to check that the course owner
 # of the LON-CAPA course is permitted to access the institutional  # of the LON-CAPA course is permitted to access the institutional
Line 230  sub validate_courseID { Line 240  sub validate_courseID {
 # sub create_password   # sub create_password 
 #  #
 # This is called when the authentication method set for the automated   # This is called when the authentication method set for the automated 
 # enrollment process when enrolling new users in the domain is "local".  # enrollment process when enrolling new users in the domain is "localauth".
 # This could be signalled for the specific user by the value of local  # This could be signalled for the specific user by the value of localauth
 # for the <authtype> tag from the classlist.xml files, or if this is blank,  # for the <authtype> tag from the classlist.xml files, or if this is blank,
 # the default authtype, set by the domain coordinator when creating the course  # the default authtype, set by the domain coordinator when creating the course
 # with loncreatecourse.pm.  # with loncreatecourse.pm.
Line 246  sub validate_courseID { Line 256  sub validate_courseID {
 # (b) a flag to indicate whether a password had been created  # (b) a flag to indicate whether a password had been created
 # 0 means no password created  # 0 means no password created
 # 1 means password created.  In this case the calling module - Enrollment.pm  # 1 means password created.  In this case the calling module - Enrollment.pm
 # will send the LON-CAPA username and passwod to the new user's e-mail  # will send the LON-CAPA username and password to the new user's e-mail
 # (if one was provided), or to the course owner (if one was not provided and  # (if one was provided), or to the course owner (if one was not provided and
 # the new user was created by the automated process), or to the active  # the new user was created by the automated process), or to the active
 # course coordinator (if the new user was created using the 'update roster  # course coordinator (if the new user was created using the 'update roster
 # now' interface included in the Automated Enrollment Manager.    # now' interface included in the Automated Enrollment Manager).  
 # (c) a flag to indicate that the authentication method is correct - 'ok'.  # (c) a flag to indicate that the authentication method is correct - 'ok'.
 # If $authchk is not set to 'ok' then account creation and enrollment of the   # If $authchk is not set to 'ok' then account creation and enrollment of the 
 # new user will not occur.  # new user will not occur.
Removed from v.1.5  
changed lines
  Added in v.1.8

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