Synchronization Rules

Synchronization rules, also called syncOptions are defined through the lsc.syncoptions property.

This section describes synchronization rule options available. You should replace TASKNAME by a task name specified in the global configuration option lsc.tasks.

This is the full name of the JAVA class used to provide synchronization option mechanism. For this instance of LSC, you must use the org.lsc.beans.syncoptions.PropertiesBasedSyncOptions value.

Default action on the destination directory. Here, three values are possible :

• K to keep data as is in the destination (means no modification at all, unless no value exists, and we create it with a create_value);
• F for allowing modification on the data (update, create or delete), default;
• M for merging values already in the destination directory with values from the data source.

Specify the value for <ATTRIBUTE> in a newly created object in the destination. Note that if present, this value will be used for <ATTRIBUTE> if it's action type is K, F or M (and if <ATTRIBUTE> is in the lsc.tasks.TASKNAME.dstService.attrs list).

This can contain a simple text value (between quotes) or a JavaScript function.

Examples:

lsc.syncoptions.TASKNAME.description.create_value = \
     "Default description for new users"
lsc.syncoptions.TASKNAME.employeeType.create_value = \
     srcBean.getAttributeValueById("type")
lsc.syncoptions.TASKNAME.uid.create_value = \
     ldapdst.attr("cn=Values,o=company", "nextUidNumber")

Specify the value for <ATTRIBUTE> in an existing entry in the destination, if it doesn't already have a value (if the action type is F and if <ATTRIBUTE> is in the lsc.tasks.TASKNAME.dstService.attrs list). This is useful for importing data into a directory that may be modified later, so that we don't overwrite it.

This can contain a simple text value (between quotes) or a JavaScript function.

Examples:

lsc.syncoptions.TASKNAME.allowAccessToHomePhone.default_value = FALSE

Specify the value for <ATTRIBUTE> in the destination if the action type is F, regardless of existing values (if <ATTRIBUTE> is in the lsc.tasks.TASKNAME.dstService.attrs list).

This can contain a simple text value (between quotes) or a JavaScript function.

Examples:

lsc.syncoptions.TASKNAME.cn.force_value = \
     srcBean.getAttributeValueById("givenName") \
     + " " + srcBean.getAttributeValyeById("sn").toUpperCase()