[LON-CAPA-admin] Automated enrollment

[Stuart Raeburn]

Hi Hon-Kie,

> others were added as cc to the course but when I try to add their sections,
> the system complains that the owner does not have privileges to access the
> enrollment data.

If you are seeing the message:

"The sections listed below could not be included in the sections for  
this LON-CAPA course, because the owner of this course - <owner> -  
does not have rights to view enrollment in those classes as determined  
by your institution's policies on access to official classlists."

(where <owner> is the course owner), then you need to look at the  
new_course() subroutine in your customized  
/home/httpd/lib/perl/localenroll.pm file.

When you add a new section to sections already being used for  
auto-enrollment for a particular course (with institutional code,  
e.g., fs14phy1000) a request is propagated to  
localenroll::new_course() in your customized  
/home/httpd/lib/perl/localenroll.pm file.

Note: there is some documentation within the default localenroll.pm  
file shipped with a LON-CAPA release.  To view that from the command  
line, do:

su www
perldoc /home/httpd/lib/perl/localenroll-std.pm

The new_course() subroutine currently accepts four arguments:
$course_id,$owner,$dom,$coowners

where $course_id is the institutional course identifier (including  
section number), and $owner is the username:domain of the course  
owner, $dom is the course's domain, and $coowners is a comma separated  
list of username:domain for any co-owners of the course.

The complete chain whenever a new course section is being affiliated  
with a LON-CAPA course in People -> Users -> Automated Enrollment ->  
Section Settings  -> (Enrollment checked) + click "Go" button is:

lonpopulate::print_sections_response() contains a call to:
lonnet::auto_new_course() which contacts lond on the course's homeserver,
lond::validate_course_owner_handler() which contains a call to:
localenroll::new_course()

The value returned by localenroll::new_course() is then propagated  
back up the chain.  If the value is not 'ok', then the message noted  
above is output.

At MSU, whenever an additional Course Coordinator is added to a  
course, a check is made to see if that person is listed as an official  
"instructor of record" in the MSU course assignments database for the  
specific course, and if the person is, then the person is  
automatically added in LON-CAPA as a co-owner for the LON-CAPA course.  
  This then means that MSU's Enrollment Services roster information  
becomes available for any course section(s) for which that person is  
the officially assigned instructor.

The domain configuration which determines whether to automatically  
assign co-ownership can be set by a Domain Coordinator via:

Main Menu -> Set domain configuration -> Display (Auto-enrollment  
settings checked)
(Yes/No radio buttons in row: "Automatically assign co-ownership").

For more information see this documentation:
https://loncapa.msu.edu/adm/help/Domain_Configuration_Auto_Enrollment.hlp

If you do not automatically assign co-ownership, then the course owner  
can select the Course Coordinator role and use:

Settings -> Course Settings -> Display (General course settings  
checked) to display the course settings page, and then check the  
checkboxes for any active Course Coordinators in the "Invite other  
Coordinators to become co-owners" box (Course Co-owners row) + click  
"Save Changes".

Any Course Coordinators invited to be co-owners will use the same menu  
to indicate their agreement to be listed as co-owners (which then  
potentially allows the automated enrollment process access to student  
rosters in sections for which they are instructor of record).


Stuart Raeburn
LON-CAPA Academic Consortium


Quoting "H. K. Ng" <hkng at fsu.edu>:

> Hi,
>
> We have a number of courses with the same course number (like PHY1000) that
> are taught by different instructors. An instructor setup his course but
> then it was decided among the instructors to combined their courses. So the
> others were added as cc to the course but when I try to add their sections,
> the system complains that the owner does not have privileges to access the
> enrollment data. So question which routine check for such access? I tried
> modifying get_sections but that doesn't help. It is check thru' new_course?
>
> Thanks,
> -hk
>