CVS log for loncom/enrollment/Autoupdate.pl

Up to [LON-CAPA] / loncom / enrollment

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

- Fix path to id_check() routine in localenroll.pm

- Sanity checking during automated update of user information using
  institutional data to prevent deletion of first and last name, or
  student/employee ID, in the case of institutional data feed issues.

- Remove trailing whitespace.

- Provide mechanism to (optionally) log counts to autoupdate.log when running
  Autoupdate.pl to update user information for users in a domain.

- Bug 6959 Automated update can be configured to skip checking for changes
  in user information for users deemed inactive.

- Accommodate sub-directory structure of user directories containing dot(s)
  within the first three characters of the username.

- Log error if localenroll::allusers_info() returns other than 'ok'.

- &descend_tree() - new first arg ($dom).
  - required for exclusion of courseIDs as users when building %users hash

- Make Autoupdate.pl suitable for institutions which only allow a LON-CAPA
  server to retrieve institutional user information when the user's
  username is included in the query.

- Check directory in lonUsers/$dom/$1/$2/$3/$uname is for a real user
  by testing for existence of passwd file.
- Coding style
- Use lonRole perl Var to check if current server is a library server.

- Users processed in alphabetical order, so logs are easier to use.

- Include time zone in starting timestamp as well as ending time stamp
  for Autoupdate run.

- Bug 5805.
  - Allow existing non-empty entries for user information (lastname, middlename, firstname, generation, id and permanentemail) to be overwritten with empty entries, if field is included in $candelete array ref (new arg for lonnet::modifyuser().
  - Overwriting with empty entries allowed when:
    (a) Updating user information for a single user from "Modify User"        (domain, author or course context) - subject to domain config        for user modification.
    (b) Autoupdate.pl updates from institutional directory data,
        subject to domain config for Autoupdate.

- Consistent naming for generation field.

- middlename and generation can be modified by Autoupdate.pl
- provide existing values for user information in fields which are not modifiable
   in call to lonnet::modifyuser() to future proof against removal of existing safeguards
   in that routine.

Setting Institutional Affiliation(s).
- institutional affiliation saved as inststatus in user's environment.db is a colon-separated list of escaped affiliations.

- Domain Coordinators in user's domain (have mau priv.) can modify institutional status of a user via "Modify User" or "Upload List of Users".

- Unescape each status type.

Propagating changes in ID made by Domain Coordinator to classlist.db file in any courses in which user has active or future student roles. Update name changes too.

loncommon.pm
- Pass ref to %got_rules to &user_rule_check(), so retrieval of rules only occurs once per domain. Retrieve rules for both username and ID
- &instrule_disallow_msg() takes a fourth argument ($mode) so message is different for messages generated for uploaded CSV file of users and single user modification.

loncreateuser.pm
- Propagate name changes and ID change to courses if Domain Coordinator is updating user data.
- Only display permanent e-mail on results page (no personal data changes) if one is defined.
- &print_user_modification_page() takes additional argument - $context - if domain adds the checkbox to force an ID change.

lonuserutils.pm
- check for $context was mistakenly checking $setting
- check whether Domain Coordinator wishes to change authentication for existing users should be $checkauth eq 'Yes'
- propagate name changes and ID change to courses if Domain Coordinator is updating user data, and had checked boxes for force ID change, and force course changes
- &update_classlist() moved to lonuserutils.pm from Autoupdate.pl
- &propagate_id_change() added to propagate ID and name changes to courses
- include cr (for Custom role) in option for Course roles for DC when setting filters for user lists.
- summary of filters used (displayed above tabular data) is customized to be an appropriate message for the choice of filters used in all cases.
- &Apache::lonnet::flushcourselogs() after processing adds/modifications in CSV file of users called in all contexts.

Autoupdate.pl
- &update_classlist() moved to lonuserutils.pm

- replace limit to primary domain server with library servers only.
- filter out courseIDs from just the current server n search for real users
- iterate over the keys of the roleshash
- correct name information keys.

- Include permanentemail in fields to retrieve from user's environment.db
- Get all courseIDs for domain - exclude these from users to check
- classlists toggle in domain configuration is 1 or 0 (not yes/no)
- is_course() was moved from loncommon to lonnet
- include permenentemail in fields sent to modifyuser
- write outcomes to log file

Institutional status is stored as an array under the hash key of inststatus, instead of type  -- see localenroll::query_user_tables() documentation.

- style police

- Initialize language handler
- Logging to an autoupdate.log file

Only run Autoupdate for the domain if the server is the primary library server for the domain.

- lonsql
  - Need to escape results from userlog queries (escaping of all results from lonsql eliminated in 1.50).
  - Allow filtering of user's activity.log for 'Role'
  - Include host in information returned for userlog query

- Autoupdate.pl
  - &lonnet::get_my_roles() by default gets roles from nohist_userroles.  Use in Autoupdate wants information about a user's own roles (from roles.db) - use context as argument
  - warning messagea when username changed (assumes fixed student ID). prints to screen
for now (log to file would be preferred)

- lonnet.pm
  - documentation for &userfileupload
  - get_my_roles() now includes optional context which determines which db file is target for dump (default is nohist_userroles, context of 'userroles' sets target to roles.db
  - documentation for &userlog_query() - now includes hostID
  - documentation updated for &get_my_roles().

Adding cvs version header.

Support automated update of instiutional users in a domain, based on domain preferences.
Autoupdate.pl --
- Institutional data now gathered for all users in a single call to localenroll.
- Correction to check to see if Autoupdate should run
- Accumulate updateable fields for all institutional types with which user is affiliated
- Use modifyuser() in lonnet to store updated user information
- affiliations_check() checks for changes in institutional status

localenroll.pm --
- correct documentation for instcodes hash reference
- allusers_info() - retrieve institutional user data for all users.
- get_userinfo() - retrieve institutional data for a single username or ID
- inst_usertypes() - provide institutional types (short and long titles).

First pass at a script to update user information based on an institutional datafeed. Will require a get_userinfo() routine in localenroll.pm which will retrieve the user's data from the institutional source. Work in progress.