File:  [LON-CAPA] / loncom / html / adm / help / tex / Domain_Configuration_Auto_Updates.tex
Revision 1.5: download - view: text, annotated - select for diffs
Wed Dec 4 17:52:02 2013 UTC (10 years, 7 months ago) by bisitz
Branches: MAIN
CVS tags: version_2_11_0_RC3, version_2_11_0_RC2, HEAD
Fixed typos

\label{Domain_Configuration_Auto_Updates}
An auto-update, run as a regular process, can update user information
stored in LON-CAPA for all users in a domain, for whom institutional
directory information is available. Which user records are updated
can be controlled by institutional status (e.g., Faculty, Staff, Student
etc.). If a user is affiliated with more than one group, then the attributes
which can be updated will be the cumulative set for the different
groups to which the user belongs.

If users are not affiliated with any institutional group, they can
be accommodated within the default \char`\"{}Other users\char`\"{}
group which is provided automatically. If no status types are defined
for your domain, this default group is entitled \char`\"{}All users\char`\"{}. 

Settings for auto-update are:

\begin{itemize}
\item Set auto-update as active or inactive in the domain.
\item Set whether user information changes should propagate to data stored
in classlist database files for the separate courses in which the
user has an active student role.
\item Set whether users with a particular status (e.g., Faculty, Staff, 
Student etc.) should have access to a user preference which permits them
to lock their existing user information, and disable automatic updates
of their own information, should it change in the institutional directory.
Note: this option is only shown if institutional groups have been defined. 
\item Set which of the following attributes: first name, middle name, last
name, generation, e-mail address, student/employee ID should be updated
within LON-CAPA if a different version to the one currently stored
is retrieved from the institutional directory.
\end{itemize}
In order for Autoupdate to work, the \&allusers\_info() routine in
localenroll.pm needs to be customized and a conduit established to
institutional data. In addition, if you wish to differentiate between
institutional user types in your LON-CAPA domain the \&inst\_usertypes()
routine in localenroll.pm will need to be customized to correspond
with the types used at your institution. These types are then used
to populate the \char`\"{}User population\char`\"{} column in each
of the \char`\"{}Updateable user information\char`\"{} row(s) in the
Auto-update data table in \char`\"{}Domain Configuration\char`\"{}.

Warnings will be written to the Auto-update log file found in /home/httpd/perl/logs
if a possible username change is detected. Although the username is
the unique identifier in LON-CAPA, the student/employee ID operates
as an additional, mostly unique identifier. At present LON-CAPA does
not support username changes. For users who switch username (assuming
institutional authentication will no longer authenticate the user's
old username) the recommendation is to convert the authentication type 
in LON-CAPA for the user to \char`\"{}internal\char`\"{}, set an 
initial password, make sure that permanent e-mail is set for the user, 
then e-mail the user and ask them to use the 
\char`\"{}\underbar{Forgot password?}\char`\"{} link on the log-in page 
to change the password to something secure.

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