--- loncom/html/adm/help/tex/Course_Automated_Enrollment.tex 2013/12/04 17:52:02 1.10 +++ loncom/html/adm/help/tex/Course_Automated_Enrollment.tex 2017/04/01 15:22:59 1.14 @@ -2,7 +2,8 @@ If your system administrator has configured your LON-CAPA domain to have access to a data feed for class lists for your institution and your domain coordinator has enabled automatic course enrollment updates, then you can control the behavior of these updates using the \textbf{Automated Enrollment} Manager. \begin{enumerate} -\item Select \includegraphics[width=0.03\paperwidth]{cprv} +\item Mouseover the \textbf{People} item in the inline menu and click \textbf{Users} or select +\includegraphics[width=0.03\paperwidth]{cprv} \textbf{Manage course users} on the Main Menu. \item At the \textbf{User Management} screen, select \includegraphics[width=0.03\paperwidth]{roles} @@ -27,15 +28,24 @@ is intended for cases where a course is 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 agreement 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}