This section covers what you can customize in the
application, using only the Java properties files provided. Detailed explanations
of individual properties can be found in the WEB-INF/classes/sample.properties file in the directory where you deployed the application.
NameFinder was designed as a Sun internal
web application. The default configuration therefore relies on Sun's LDAP
schema and directory information tree (DIT). The schema and DIT probably differ
from the schema and DIT in use at your organization.
In addition to customizations within the application, you can also customize
searches by using options in the search field. Furthermore, you can customize
what attributes to display within the browser-based interface. Refer to the
NameFinder online help for details.
As described in Configuring
NameFinder to Access Your Directory, you customize the WEB-INF/classes/NameFinder.properties file to allow the application to access your directory.
By convention, connection parameters are included in the first few lines
of the Java properties file. You can configure to which host-port combination
NameFinder connects. You can also configure whether to use LDAP
v2 or v3, and whether to bind as a particular user.
NameFinder connection properties only allow
you to configure simple authentication connections to the directory, however.
You cannot use connection properties to configure
connect using SSL or a SASL mechanism.
you configure attributes that define search options, attributes to search,
and labels for the values returned. The Java properties definitions for such
attributes take the following form:
A decimal number
Do not leave any numbers in the sequence that remain commented out.
NameFinder depends on having the numbers in ascending order
An option character for use in searches
For example, P is by default the phone number option.
Thus, search for the entry with phone number 1 234 567 8910 by
typing -P "1 234 567 8910" in the
Do not use F as an option character. This character is reserved to allow you to enter LDAP search filters, such as -F "(telephoneNumber=1 234 567 8910)", directly.
This parameter is called arg1 in WEB-INF/classes/sample.properties.
A character for use in defining table columns as a parameter
For example, you can use the default configuration. You use the default
by passing fields=nfeP as one of the options in the URL
NameFinder for a search that returns multiple
NameFinder displays results in a four-column
table that has column labels Lastname, Firstname, eMail, and Phone #.
This argument is called arg2 in WEB-INF/classes/sample.properties.
The LDAP attribute to search when using optChar
This argument is called arg3 in WEB-INF/classes/sample.properties.
The label to display for the corresponding attr value when showing results for a single LDAP entry
This argument is called arg4 in WEB-INF/classes/sample.properties.
The column label to display in the table header for the corresponding attr value when showing results for multiple LDAP entries
This argument is called arg5 in WEB-INF/classes/sample.properties.
You can leave variables blank in search attribute properties definitions.
In addition to connection
and search attribute properties,
you to define several other properties in the WEB-INF/classes/NameFinder.properties file. These other properties govern the following:
The default table layout for displaying results when searches return multiple entries
Lists of LDAP attributes to search when looking up phone numbers and email addresses
Which LDAP attributes correspond to
NameFinder attribute fields, which allow
NameFinder to be
abstract from particular LDAP schema
Table layouts for displaying team views and tables of a manager's direct reports
Refer to WEB-INF/classes/sample.properties for details.