Georgetown University Home  |  A-Z Index  |  Contents  |  Directories  |  Search 
 UIS » Web development » Web application development  » ColdFusion » Custom tags
 CF_GUDirectoryLookup


Description

This tag is used to retrieve public information about a Georgetown user from the Georgetown NetID directory.

Attributes

  • NetID -- Optional. If not present, the username of the current user (CGI.REMOTE_USER) is used. This requires that the tag be used in an access-restricted web directory.

Usage

If the current user is authenticated with a valid NetID, or if a NetID is specified using the NetID attribute, this tag returns a structure variable named GUDirectoryLookup containing the following information:

GUDirectoryLookup.FullName The user's full name, first name first.
GUDirectoryLookup.LastName The user's last name.
GUDirectoryLookup.FirstName The user's first name.
GUDirectoryLookup.Title The user's job title, if applicable.
GUDirectoryLookup.Affiliations A comma-delimited list of the user's affiliation(s) with Georgetown (Employee, Student, Faculty, Alumni).
GUDirectoryLookup.PrimAffiliation The user's primary affiliation with Georgetown (Employee, Student, Faculty, or Alumni).
GUDirectoryLookup.Campus The user's campus.
GUDirectoryLookup.Department The user's four-digit department code (not the department name).
GUDirectoryLookup.Email The user's email address.
GUDirectoryLookup.Phone The user's phone number.

Only information that would be publicly available in Georgetown's online directory can be retrieved. If information for a field is not available, it will be blank. If no valid NetID is available, or if the user's NetID record is not public, all fields will be blank.

This tag should be used sparingly with respect for the load that it imposes on the Georgetown directory server. You should not use this tag simply to retrieve and display contact information about a single individual. Instead, you should link directly to the individual's record in the online directory. You also should not use this tag to carry out user authorization or to display dynamic content based on directory information such as affiliation. Instead, you should use the CF_GUAuthorizeUser tag.

Example

This example uses the GUDirectoryLookup tag to look up information about user jhoya:

    <CF_GUDirectoryLookup NetID="jhoya">

This example results in a structure variable named GUDirectoryLookup containing the values listed in the prior section. If user jhoya is not publicly listed in the NetID directory or if no such user exists, the variables will be blank.

 
 Georgetown University Home  |  A-Z Index  |  Contents  |  Directories  |  Search 
© Copyright 2001, Georgetown University