The Personalization module includes a standard profile repository definition with the configuration path name /atg/userprofiling/userProfile.xml, located in <ATG9dir>/DPS/config/profile.jar. This is the default repository definition used by the ProfileAdapterRepository. You can use it as is, use it as a model, or extend it, as determined by the user profiling needs of your ATG application. You can use the standard user profile repository definition with no changes if the following conditions are true:
the standard user profile repository definition includes all the profile properties that you need in your application, and
the database schema defined in the standard user profile repository definition fits your database requirements.
If the standard user profile repository definition includes profile properties you don’t need, no particular harm is done. Your ATG application can ignore the unneeded properties, so long as those profile properties allow null values.
The standard profile repository definition in the Personalization module defines the following item descriptors:
Item Descriptor Name | Description |
|---|---|
| represents a single user, typically an external user (a customer or other visitor to your Web site) |
| the contact information for a user, including name, postal address, phone number and fax number |
| properties used for contacting a user by e-mail, including properties used by the Targeted E-mail facility |
| properties that define the non-assignable roles assigned to a user |
| properties that define the global roles assigned to a user |
| represents an organization |
| defines the folders in which you can place organizations |
| defines the folders in which you can place global roles |
Other ATG modules, including the Quincy Funds demo and ATG Commerce, extend this profile repository definition, adding new item descriptors and properties. Each ATG module that extends the profile repository definition includes its own definition file, each of which is also located in the configuration path at /atg/userprofiling/userProfile.xml. The system combines all of these profile repository definition files into a single composite repository definition, using the XML file combination rules described in the XML File Combination section of the Nucleus: Organizing JavaBean Components chapter in the ATG Programming Guide.
For more information on defining organizations and roles, see the Working with the Dynamo User Directoryy chapter in this manual.
