Using synctime-field to include time/date modified information on synced objects
Created: 2015-04-29 10:07:00Modified: 2026-03-03 09:37:58
Tags: Active Directory UnitySync
If you would like to add When Modified information to your synced objects, make the following changes to your configuration.
NOTE: The example below is for an Active Directory Destination. Clients have successfully implemented this configuration change for other directory types, but it has not been tested for ALL directory types. We recommend running a Simulation with the Log File level set to 3-Detailed once making the change to determine if it will work as desired in your environment.
UnitySync generates several internal variables at sync time. One of them is ~synctime~ which provides a time/date stamp value. You can use this internal variable to stamp modified objects with When Modified information.
Add the following line to your config.txt. You may access via the Raw Config button on the Custom tab or open the config.txt file in your connections folder:
synctime-field=extensionAttribute1
When synctime-field is in use, the specified attribute need not be included in the map file. If it is, it will be igored.
Important Note: You should NOT include ~synctime~ in your custom map file.
When you use the synctime-field configuration entry, the destination extensionAttribute1 will be set only on Add or Modify of an object. If you include ~synctime~ (rather than use the parameter in your config.txt as instructed), this will cause a modify of ALL objects on EVERY Sync run.
So do NOT do this:
extensionAttribute1=~synctime~
If you already have a custom object map file, you can change the mapping for the attribute in use as a reminder that synctime-field is applied to your config.txt, for example:
#extensionAttribute1=See Config.txt for synctime-field setting
If the default map file is in use, there is no need to create a custom map file just for this. The default mapping for the specified attribute is simply ignored.
Please contact support@dirwiz.com if you have any questions about this configuration option.