Return to Domconfig_Auto_Enrollment.tex CVS log

Up to [LON-CAPA] / loncom / html / adm / help / tex

Annotation of loncom/html/adm/help/tex/Domconfig_Auto_Enrollment.tex, revision 1.1

1.1     ! raeburn     1: If your institution can provide access to roster information for courses
        !             2: using LON-CAPA then your domain can offer automated enrollment once
        !             3: localenroll.pm has been customized on each of the library servers
        !             4: in your domain which serves as a home server for one or more courses.
        !             5: The required customization is the creation of connections to rosters
        !             6: for institutional course sections providing enrollment to each LON-CAPA
        !             7: course. These connections can involve queries of database tables,
        !             8: in real time, or can involve retrieval from a data source which is
        !             9: only updated periodically.
        !            10: 
        !            11: There are two configuration options: 
        !            12: 
        !            13: \begin{itemize}
        !            14: \item Set auto-enrollment as active or inactive in the domain. 
        !            15: \item Set the username:domain used in the notification messages sent when
        !            16: changes in enrollment occur as a result of auto-enrollment updates.
        !            17: By setting these to a specific user (you might create one for this
        !            18: purpose), you can view all auto-enrollment change messages for the
        !            19: entire domain by viewing the contents of the sent messages folder for that user.
        !            20: \end{itemize}
        !            21: Auto-enrollment settings for each course consist of items set by a
        !            22: Domain Coordinator within the \char`\"{}Modify Course\char`\"{} area,
        !            23: and those items set in a course context from the \char`\"{}\underbar{Automated
        !            24: Enrollment Manager}\char`\"{} link in the \char`\"{}Manage Users\char`\"{}
        !            25: menu. This link is only displayed if auto-enrollment has been set
        !            26: to be active in the domain.
        !            27: 
        !            28: The items which must be set by a Domain Coordinator include: 
        !            29: 
        !            30: \begin{itemize}
        !            31: \item institutional code (used in mapping institutional rosters to LON-CAPA
        !            32: courses)
        !            33: \item default authentication
        !            34: \item course owner
        !            35: \end{itemize}
        !            36: Your institution may have policies in place to control who may have
        !            37: access to student information contained within course rosters. In
        !            38: such cases, assignment of an appropriate course owner in LON-CAPA
        !            39: may facilitate access to institutional rosters. When a course is first
        !            40: created the initial Course Coordinator chosen will be identified as
        !            41: the course owner. If, instead a course is created using an uploaded
        !            42: XML course description file, the XML file will include tags to define
        !            43: the username and domain of the course owner.
        !            44: 
        !            45: Settings which control auto-enrollment which are modifiable by a Course
        !            46: Coordinator are described in the \underbar{Automated Enrollment help page}.
        !            47: 
        !            48: The auto-enrollment process will update user information (name, e-mail
        !            49: address, studentID etc.) for any student who is being added to the
        !            50: course, but will not change it in other case (i.e., drops, section
        !            51: switches) should there be a difference between the values in the institutional
        !            52: roster and the values in the LON-CAPA classlist. To change user information
        !            53: for students already in the course, the Auto-update process must be run
        !            54: (see below).
        !            55: 
        !            56: Warnings will be written to the Auto-enrollment log file found in
        !            57: /home/httpd/perl/logs if a possible username change is detected. Although
        !            58: the username is the unique identifier in LON-CAPA, the studentID operates
        !            59: as an additional, mostly unique identifier. The same studentID may
        !            60: not be assigned to more than one user - if an existing studentID is
        !            61: assigned to adifferent user, the change will not occur, unless forced
        !            62: (there's a checkbox for that). A blank studentID can be assigned,
        !            63: and in this case multiple users can share the same studentID. StudentIDs
        !            64: are used for LON-CAPA grading of scantron sheets, and are also used
        !            65: to detect changes in username by the auto-enrollment and auto-update
        !            66: processes.
        !            67: 
        !            68: At present LON-CAPA does not support username changes, although this
        !            69: functionality will be supported in the future. In the meantime, what
        !            70: you must do for users who switch username mid-semester (assuming institutional
        !            71: authentication will no longer authenticate the user's old username)
        !            72: is to convert the authentication type in LON-CAPA for the user to
        !            73: \char`\"{}internal\char`\"{}, set an initial password, make sure that
        !            74: permanent e-mail is set for the user, then e-mail the user the initial
        !            75: password, and ask them to use the \char`\"{}\underbar{Forgot password?}\char`\"{}
        !            76: link on the log-in page to change the password to something secure.