Connector Guides › Connectors Guide › Groupware Connectors › Lotus Notes/Domino Connector › Connector-Specific Features › How New Short Names are Created and Verified

How New Short Names are Created and Verified

Every Lotus Notes/Domino account has a unique short name.

When you create a new LND account in Identity Manager, you can enter the account's short name, or you can allow the connector to create it for you. The connector uses the account's first name, last name, and (if necessary) numbers to generate a unique short name.

It works like this:

1. You create a new LND account in Identity Manager, leaving the Short Name field blank.
2. After you click Submit, the connector uses an algorithm to create a short name.

   The short name includes the first letter of the first name, some or all letters from the last name, and some numbers if necessary.

3. The connector checks the new short name against the existing short names in the available address books.
4. If the short name already exists, the connector modifies the new short name and checks it again.
5. When the new short name is found to be unique, the new account is created.

   Note: If the connector cannot create a unique short name, the creation of the new account fails. If this happens, you should enter the new short name yourself, instead of allowing the connector to create it.

Example: How the connector generates a short name

In this example, you create a new account with the following details:

• First name: Peter
• Last name: Smith

When you create the new LND account, you leave the Short Name field blank.

The connector creates the short name psmith, and checks it for uniqueness. In this example, the short name psmith already exists.

The connector creates the new short name psmith1, and checks it for uniqueness. This short name is not in the available address books, so the new account is created.

Configure the Location for Verifying Short Names

Normally, the new short name is checked for uniqueness in the available address books. However, you can configure Identity Manager to check the new short name's uniqueness in one or more other databases. To set this up, you need to edit a configuration file.

To change the database view used to verify short names

1. Find CUSTOM_SHORTNAME_VALIDATION.connector.xml, in jcs-home/conf/override/lnd.

   Note: jcs-home is the installation location of the Java Connector Server. For more information, see Connector Configuration File and Default Installation Directories in Java Connector Server Implementation Guide.

2. Copy the file into the same directory, and rename it to connector.xml.
3. Open the new XML file, and find the <property name="shortNameSearchViews"> section, which is commented out.
4. Remove the comment marks to activate the shortNameSearchViews section.
5. Edit the <entry> section to point to the database view that contains the short names:

   <property name="shortNameSearchViews">
       <map>
           <entry key="database-name.nsf"><value>$view-name</value></entry>
       </map>
   </property>
   

   where

   database-name

   Specifies the name of a database in which to search for matching short names

   view-name

   Specifies the view in that database. You can specify only one view for each database.

   Note: To search multiple database views, add extra <entry> lines.

6. Save the file.
7. Restart the Java Connector Server.

Example: Point to multiple databases

<property name="shortNameSearchViews">
    <map>		        
       <entry key="db1.nsf"><value>$view1</value></entry>
  	<entry key="db2.nsf"><value>$view2</value></entry>
  	<entry key="db3.nsf"><value>$view3</value></entry>
    </map>
</property>