ATG Personalization Programming Guide

Profile Migration Manager Properties

You can configure the following properties of the Profile Migration Manager:

sourceRepository

Specify the path of the ProfileAdapterRepository component from which you want to copy items. It resolves by default to /atg/userprofiling/ProfileAdapterRepository. If you are running your application with the –layer Preview switch, you can also specify an ExternalProfileRepository component as the source.

destinationRepository

Specify the path of the InternalProfileRepository component into which the items will be copied. The property is set to /atg/userprofiling/InternalProfileRepository by default.

itemDescriptorMapping

This property lists the item descriptors in the source repository and shows the item descriptors they will be copied to in the destination repository. By default, all item descriptors in the source are mapped to item descriptors with matching names in the destination. To exclude an item from the migration, remove its item descriptor and mapping from this list.

If a specified item descriptor does not exist in the destination repository, an error is generated when the migration is started.

Use single commas to separate item descriptors and double commas to separate properties, as shown:

itemdesc1=property,,property,,property,itemdesc2=property,,property

includedItemReferences

Profile items typically have references to items in other repositories, for example the Orders repository. This property indicates the references that should be copied. The default configuration excludes the following references:

Use single commas to separate item descriptors and double commas to separate references, as shown:

itemdesc1=ref,,ref,,ref,itemdesc2=ref,,ref,itemdesc3=ref,,ref

overwriteDestinationRepository

Use to indicate whether to overwrite any items in the destination repository that match items in the source. Items match if they have the same repository ID. Set to false by default. If an item in the source repository has the same repository ID as a profile in the destination, and overwriteDestinationRepository is set to false, no migration is attempted for that item. If overwriteDestinationRepository is set to true, the source item replaces the destination item.

The default properties file for the ProfileMigrationManager component is shown below.