Previous Topic: Correlate on Shortname

Next Topic: Attribute Mapping

Configure Shortname Verification

The LND connector automatically generates unique shortnames. By default the LND connector searches existing Address Books for shortnames. However, if you store shortnames in non-standard locations and want to verify that shortnames that are automatically generated do not conflict with existing short names, you can change the default search behavior. You can specify the databases and views you want to search for shortnames by configuring the connector.xml file.

To configure shortname verification

  1. Navigate to the folder jcs_home/conf/override/lnd/connector.
  2. Add the following to the <property name="defaultConnectorConfig"> section of the SAMPLE.connector.xml file:
    <property name="shortNameSearchViews">
    	<map>
    	<entry key="names.nsf"><value>$Users</value></entry>
    	</map>
    </property
    

    This configuration specifies the databases and views to search for short names. This configuration replaces the default connector behavior of searching existing Address Books for shortnames.

    Note: For more information about customizing a connector.xml file, see Connector Configuration File in the Java CS Implementation Guide.

  3. To search multiple views, add extra <entry> lines. For example:
    <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>
    

    Note: You can only specify one view per database. For example, you cannot do the following:

    <property name="shortNameSearchViews">
    
    	<map>
    	<entry key="db1.nsf"><value>$view1</value></entry>
    	 <entry key="db1.nsf"><value>$view2</value></entry>
    	<entry key="db1.nsf"><value>$view3</value></entry>
    	</map>
    	</property>
    
  4. Rename the SAMPLE.connector.xml file to connector.xml.
  5. Copy the file to the following folder on the Java CS:

    conf/override/lnd

  6. Restart the Java CS.