Annotation of loncom/html/adm/help/tex/Domain_Configuration_Auto_Updates.tex, revision 1.1
1.1 ! raeburn 1: \label{Domain_Configuration_Auto_Updates}
! 2: An auto-update, run as a regular process, can update user information
! 3: stored in LON-CAPA for all users in a domain, for whom institutional
! 4: directory information is available. Which user records are updated
! 5: can be controlled by institutional status (e.g., Faculty, Staff, Student
! 6: etc.). If a user is affiliated with more than group, then the attributes
! 7: which can be updated will be the cumulative set for the different
! 8: groups to which the user belongs.
! 9:
! 10: If users are not affilliated with any institutional group, they can
! 11: be accommodated within the default \char`\"{}Other users\char`\"{}
! 12: group which is provided automatically. If no status types are defined
! 13: for your domain, this default group is entitled \char`\"{}All users\char`\"{}.
! 14:
! 15: Settings for auto-update are:
! 16:
! 17: \begin{itemize}
! 18: \item Set auto-enrollment as active or inactive in the domain.
! 19: \item Set whether user information changes should propagate to data stored
! 20: in classlist database files for the separate courses in which the
! 21: user has an active student role.
! 22: \item Set which of the following attributes: first name, middle name, last
! 23: name, generation, e-mail address, student/employee ID should be updated
! 24: within LON-CAPA if a different version to the one currently stored
! 25: is retrieved from the institutional directory.
! 26: \end{itemize}
! 27: In order for Autoupdate to work, the \&allusers\_info() routine in
! 28: localenroll.pm needs to be customized and a conduit established to
! 29: institutional data. In addition, if you wish to differentiate between
! 30: institutional user types in your LON-CAPA domain the \&inst\_usertypes()
! 31: routine in localenroll.pm will need to be customized to correspond
! 32: with the types used at your institution. These types are then used
! 33: to populate the \char`\"{}User population\char`\"{} column in each
! 34: of the \char`\"{}Updateable user information\char`\"{} row(s) in the
! 35: Auto-update data table in \char`\"{}Domain Configuration\char`\"{}.
! 36:
! 37: Warnings will be written to the Auto-update log file found in /home/httpd/perl/logs
! 38: if a possible username change is detected. Although the username is
! 39: the unique identifier in LON-CAPA, the student/employee ID operates
! 40: as an additional, mostly unique identifier. At present LON-CAPA does
! 41: not support username changes. For users who switch username (assuming
! 42: institutional authentication will no longer authenticate the user's
! 43: old username) is to convert the authentication type in LON-CAPA for
! 44: the user to \char`\"{}internal\char`\"{}, set an initial password,
! 45: make sure that permanent e-mail is set for the user, then e-mail the
! 46: user the initial password, and ask them to use the \char`\"{}\underbar{Forgot
! 47: password?}\char`\"{} link on the log-in page to change the password
! 48: to something secure.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>