--- loncom/html/adm/help/tex/Institutional_Integration_User_Categories.tex 2008/07/29 18:01:22 1.1 +++ loncom/html/adm/help/tex/Institutional_Integration_User_Categories.tex 2014/06/26 15:07:10 1.2 @@ -4,18 +4,38 @@ by the Autoupdate process which reconcil with institutional directory information. User type (or affiliation) can determine such things as (a) default portfolio quota, (b) the types of user information which may be updated in different contexts, -(c) whether a user can self-enroll in a course. The possible institutional -types in a domain are defined by \emph{inst\_usertypes()}. Examples -of institutional types might be: Faculty, Adjunct, Staff, Student -etc. In addition to any types defined in \emph{inst\_usertypes()}, a type +(c) whether a user can self-enroll in a course. + +Prior to LON-CAPA 2.11.0 the possible institutional types in a domain +were defined by \emph{inst\_usertypes()}. Examples of institutional +types might be: Faculty, Adjunct, Staff, Student etc. +In addition to any types defined in \emph{inst\_usertypes()}, a type {}``other'' will also be available for assignment to users who do not fall in any of the recognized categories of user. In the absence of any defined user categories, the type {}``other'' applies to all users from a domain. +Starting with LON-CAPA 2.11.0 use of the inst\_usertypes() +subroutine is deprecated. The domain configuration web GUI +accessible to Domain Coordinators is now used to +manage institutional types. If you have previously +customized the inst\_usertypes() routine, then values set there +will be used when displaying the "Institutional user types" +section in the domain config screen for: +"Default authentication/language/timezone/portal/types". + +Once a Domain Coordinator has visited that screen and saved the +settings, configuration thereafter will be via the web GUI of +values stored in the domain's configuration.db file on +the primary library server in the domain, and values in +inst\_usertypes() will no longer be consulted. However, if you have +created other custom routines in localenroll.pm which call +inst\_usertypes() internally, you will likely want to continue to +maintain it. + \textbf{\large inst\_usertypes}{\large \par} -The routine accepts three arguments: +The routine accepted three arguments: \begin{enumerate} \item \$dom - domain