The corporate look up feature of Lotus Notes® Traveler allows mobile users to search for and find information about other users in the Domino® directory. It also allows them to find information using remote directories if directory assistance is configured. This is useful when a user must contact another person in the organization who is not in the contact list of the user.
The corporate look up feature works automatically for customers using the default Domino directory to provide the names, telephone numbers, and email addresses. However, customers that use a Domino directory may still find it useful to customize the corporate look up results as described below. Companies configure their corporate directories in different ways. What contact information is important varies from one company to another, as do the fields in which that information is stored within the directories.
The following customization options can be applied to the corporate look up feature.
Configuring how many characters are typed before the query is performed
To improve performance, a default of four characters must be typed before the actual look up initiates. You can configure this value by setting NAME_LOOKUP_MIN_LENGTH
in the TrueSyncServer
section of the NTSConfig.xml
Configuring which items should be retrieved from the directory
The items to retrieve from the directory are configured by modifying the nameLookupItems
property in data\traveler\cfg\NTSConfig.xml
. By default, corporate look up retrieves these items, which are used in the Domino Names and Address Book:
You may add other items that come from either the Domino Directory or external directories configured in directory assistance. The field names of the Domino Directory can be found by viewing the $Users
view of the Domino Directory. The column names are the field names returned. For external directories, contact your administrator to determine the field names or use a third-party tool like LDAPBrowser
to determine the field names.
Modifying the behavior of the search performed by the Domino server
To modify the behavior of the search performed by the Domino server, the nameLookupFlags
attribute can be changed. Possible values are 0, 8, 32, 40
- 0 means that the look up will not match partial names and will stop searching once a match is found.
- 8 means that the look up will match partial names but again will only return the first value found.
- 32 will not match partial names, but will perform an exhaustive search of all directories including ones specified in directory assistance and will return all results.
- 40 (default) will match partial names and perform an exhaustive search of all directories.
Configuring the maximum number of results to return to the client
The maximum number of search results to return to a client can be configured by modifying the MaxResults
property in data\traveler\cfg\namelookupTemplate\nameLookup-AS.xslt
By default, this value is set to 25
, ensuring that the number of records sent to the device is limited.
Configuring the mapping from look up to device
Once you know what fields are being returned from your look up, you can map them to fields on the device. Mapping is done by customizing the file nameLookup-AS.xslt
located in data\traveler\cfg\namelookupTemplate
. By default, this file is configured to map the standard Domino Directory fields to the device fields. The fields that can be used/understood by the device are defined by the ActiveSync protocol. Currently only these fields are defined:
To change the field mapping to use a different field for an email address:
To display the last name before the first name:
<xsl:element xmlns="GAL:" name="DisplayName"></xsl:element>
<xsl:value-of select="concat(LastName, ', ', FirstName)"></xsl:value-of>
Extensive changes to the XSLT file should not be necessary. However, if you need more information about XSLT, see http://www.w3.org/TR/xslt
Directory Assistance Considerations
When using an LDAP directory through directory assistance, other configurations can be made within the directory assistance configuration to affect the behavior of the query performed. For example, the "mail filter" query under the LDAP tab in a directory assistance LDAP entry can be changed to tell directory assistance which attributes in LDAP should be searched. For more information, see the Directory Assistance documentation for Lotus® Domino.
Parent topic: Configuring Lotus Notes Traveler server