Connector Guides › Connectors Guide › Connecting to Endpoints › Lotus Notes/Domino Connector › Connector-Specific Features › Custom Attribute Support

Custom Attribute Support

Several enhancements have been made for custom attribute support. They include:

• Custom attributes eTLNDCustomAttribute01-50 and eTLNDCustomCapabilityAttribute01-50 (policySync="yes") can be mapped using the XML file <jcs-home/conf/override/lnd/lnd_custom_metatdata.xml. This file adheres to the XML schema that can be found here:

  <jcs-home>/conf/xsd/datamodel.xsd
  

  The custom metatdata file, if present, is merged with the static lnd_metadata.xml file included in the connector to provide the complete runtime metadata to be used by the connector.

• Two sample custom metadata files are included for reference. To active either of these mappings, make a copy of the sample file (not changing the directory) and rename this copy to lnd_custom_metatdata.xml.

  SAMPLE.lnd_custom_metadata.xml includes two simple mappings to provide easy verification of the custom mapping functionality.

• DJX_SAMPLE.lnd_custom_metadata.xml includes mappings for each of the attributes used for the DJX extension to LND. This file provides a useful starting point (or complete solution) for users interested in DJX. This file also includes an example of an LND "Dialog" field being handled as a Boolean value.
• Only power users should modify the custom metatdata file and should take precautions like saving a backup copy of any existing file before updating. Tests to verify mapping changes should be conducted immediately after modifications are made, as any syntax errors introduced will render any LND connector hosted by the modified Java CS inoperable until a valid custom file is reinstated (or the offending custom mapping file deleted). Error messages in the Provisioning Manager clearly distinguish failures in the parsing of this file so remedial action can be taken immediately.
• If customized mappings need to be active on multiple Java CS installations, the same lnd_custom_metadata.xml file needs to be copied to

  <jcs-home>/conf/override/lnd/ 
  

  on each of them.

• All metadata settings that can be used in custom mapping files are documented in the MetaDataUtil.java class of the Java CS available as either JavaDoc with the Java CS SDK or as part of the "Programming Guide for Java Connector Server r12. You can find this guide in the r12 Bookshelf.
• Attribute values entered on the Custom Attributes tab are subject to validation by the connector. For example, integer fields emit a validation failure when non-digit characters are present.
• The values provided for any custom attribute configured to be date or dateTimes on the Custom Attributes tab, must be entered in the UTC time zone, not local time, unless the computers on which the client is running (for example, Provisioning Manager / etautil script) and the LND endpoint are configured to use the same time zone..