ProfileItemFinder

The /atg/userprofiling/ProfileItemFinder component is used by the Personalization module to find users, either by attribute (for example, a login name or email address) or by ID. For example, when a user logs in using a profile form handler, the supplied username and password are passed on to ProfileItemFinder in order to locate the user in the profile repository. The component represents the standard way for any user directory to find a user.

The code below is an example of a ProfileItemFinder.properties file configured for an LDAP-based user directory:

$class=atg.userprofiling.RepositoryLinkProfileItemFinder

profileTools=ProfileTools
propertyManager=PropertyManager
profileRepository=ProfileAdapterRepository
linkedRepository=/atg/adapter/ldap/LDAPRepository
linkedProfileTypeMap=user=user
linkPropertyLocal=login
linkPropertyRemote=login
loginLinkedPropertyName=login
passwordLinkedPropertyName=password
firstNameLinkedPropertyName=firstName
lastNameLinkedPropertyName=lastName
emailLinkedPropertyName=email
createLocalProfiles=true

The following table describes how to set the properties in this component:

Property	Description
`profileTools`	The profile tools component that this finder uses to find repository items. Default: `/atg/userprofiling/ProfileTools`
`propertyManager`	The Personalization module’s standard property manager. Default: `/atg/userprofiling/PropertyManager`
`profileRepository`	The repository in which this finder finds repository items. Default: `/atg/userprofiling/ProfileAdapterRepository`
`linkedRepository`	The repository in which the items implicitly linked to SQL repository items reside. Default: `/atg/adapter/ldap/LDAPRepository`
`linkedProfileTypeMap`	The map of local SQL repository item types to remote LDAP item types. The default assumes that your SQL user item type is `user` and your LDAP user item type is also `user`. If you change either your SQL or LDAP user view names, you must also change these map entries. Default: `user=user`
`linkPropertyLocal`	The name of the property of SQL repository `user` items that implicitly links them to LDAP `user` items. The `linkPropertyLocal` property must be set to the same value as `linkPropertyLocal` for the link property in the `user` item descriptor in the `userProfile.xml` file. Default: `login`
`linkPropertyRemote`	The name of the property of LDAP `user` items that implicitly links them to SQL repository `user` items. The `linkPropertyRemote` property must be set to the same value as `linkPropertyRemote` for the link property in the `user` item descriptor in the `userProfile.xml` file. Default: `login`
`createLocalProfiles`	Tells this profile finder whether to create local SQL repository user items when a remote LDAP user item is found. Default: `true`

ATG Personalization Programming Guide

ProfileItemFinder