version 1.21, 2007/07/25 20:43:48
|
version 1.23, 2007/08/28 20:04:50
|
Line 512 sub allusers_info {
|
Line 512 sub allusers_info {
|
############################### |
############################### |
# sub get_userinfo |
# sub get_userinfo |
# |
# |
# Incoming data: four required arguments and t optional arguments |
# Incoming data: four required arguments and additional optional arguments |
# Retrieves institutional data for a single user either by username |
# Two modes of operation: |
# if $uname is included as second argument, or by ID if $id is |
# (1) Retrieves institutional data for a single user either by username |
# included as a third argument. Either (b) or (c) must be provided. |
# if $uname is included as second argument, or by ID if $id is |
|
# included as a third argument. Either (b) or (c) must be provided. |
|
# (g), (h) and (i) will be undefined. |
|
# (2) Retrieves institutional user data from search of an institutional |
|
# directory based on a search. (g) and (h) are required. |
|
# (i) is optional. (b) and (c) will be undefined. |
|
# |
# (a) $dom - domain |
# (a) $dom - domain |
# (b) $uname - username of user |
# (b) $uname - username of user |
# (c) $id - student/faculty ID of user |
# (c) $id - student/faculty ID of user |
Line 537 sub allusers_info {
|
Line 543 sub allusers_info {
|
# 2. lastname; 3. username |
# 2. lastname; 3. username |
# (h) $srchterm - optional if $uname or $id defined, otherwise required |
# (h) $srchterm - optional if $uname or $id defined, otherwise required |
# String to search for. |
# String to search for. |
# (i) $srchtype - optional. Allowed value: contains |
# (i) $srchtype - optional. Allowed values: contains, begins (defaults |
|
# to exact match otherwise). |
# |
# |
# returns 1 parameter - ('ok' or other value). |
# returns 1 parameter - ('ok' or other value). |
# side effects - populates the $instusers and $instids refs to hashes. |
# side effects - populates the $instusers and $instids refs to hashes. |