--- loncom/html/adm/help/tex/Course_Automated_Enrollment.tex 2013/08/27 17:27:19 1.8 +++ loncom/html/adm/help/tex/Course_Automated_Enrollment.tex 2016/08/20 16:06:50 1.13 @@ -18,24 +18,33 @@ from the roster \item Access start: the default start time for student roles added by auto-enrollment \item Access end: the default end time for student roles added by auto-enrollment \item Section mappings: Mapping of institutional section numbers to section -numbers used within the LON-CAPA course. The is mapping permits students +numbers used within the LON-CAPA course. This mapping permits students in one or more institutional sections to be identified in the LON-CAPA course as belonging to a particular section (or to no section). \item Cross-listings mapping: Mapping of institutional courses (including -section number) to section numbrs within the LON-CAPA course. Cross-listing +section number) to section numbers within the LON-CAPA course. Cross-listing is intended for cases where a course is listed by an institution under more than one institutional course code. \item Notification messages: Enable/Disable delivery of LON-CAPA mail to specified recipients (selected from active Course Coordinators). -\item Student photos: Enable/Disable automatic import of student photos from an institutional repository. This functionality requires that (a) conduit has been established from your library server(s) to a directory containing student photos, and (b) the \&institutional\_photos() routine in localenroll.pm has been customized to use this conduit. Your institution may require the course owner to indicate acceptance of policies governing use of digital student photos. If this is the case, the \&photo\_permission() routine will have been customized for your domain, and the course owner will need to click a button to acknowledge agrement to the policy, before the option to enable use student photos is enabled in a course. +\item Student photos: Enable/Disable automatic import of student photos from an institutional repository. This functionality requires that (a) a conduit has been established from your library server(s) to a directory containing student photos, and (b) the \&institutional\_photos() routine in localenroll.pm has been customized to use this conduit. Your institution may require the course owner to indicate acceptance of policies governing use of digital student photos. If this is the case, the \&photo\_permission() routine will have been customized for your domain, and the course owner will need to click a button to acknowledge agreement to the policy, before the option to enable use student photos is enabled in a course. \item Enrollment status: Students in a course are identified internally by type (auto or manual) depending on whether they were auto-enrolled. -Only users of type 'auto' will be dropped from the course if auto-enrollment +Only users of type `auto' will be dropped from the course if auto-enrollment detects expired enrollment. By default, status type is automatically -changed from 'manual' to 'auto', if a manually enrolled student subsequently +changed from `manual' to `auto', if a manually enrolled student subsequently appears in the institutional roster when auto-enrollment is run. This automatic migration can be prevented for individual students by locking the status type. +\item Zero enrollment failsafe: When enrollment comes from more than one institutional +course section (including cross-listing), there is a possibility that +institutional data retrieval might succeed for some, but not all sections. +In order to avoid expiring student roles in sections for which institutional +enrollment data could not be retrieved, a failsafe value can be set. When the +existing enrollment in a LON-CAPA course section exceeds that failsafe value (an integer), +dropping of existing students in the affected section(s)) by automated enrollment +update is disabled. A failsafe value set in a course will override a default value +set for the domain. \end{itemize}