If you install the complete ATG platform suite, together with the Quincy Funds demo and Commerce, the standard external user profile repository definition is defined as a composite of the /atg/userprofiling/userProfile.xml files in the following JAR files:

<ATG10dir>/DPS/config/profile.jar
<ATG10dir>/DSS/config/config.jar
<ATG10dir>/DCS/config/config.jar
<ATG10dir>/B2CCommerce/config/config.jar

plus the following XML file:

<ATG10dir>/DSSDemo/config/atg/userprofiling/userProfile.xml

If you install the B2CCommerce suite, the standard user profile repository definition is defined as a composite of the /atg/userprofiling/userProfile.xml files in the following JAR files:

<ATG10dir>/DPS/config/profile.jar
<ATG10dir>/DSS/config/config.jar
<ATG10dir>/DCS/config/config.jar
<ATG10dir>/B2BCommerce/config/config.jar
<ATG10dir>/B2BStore/config/config.jar

plus the following XML file:

<ATG10dir>/DSSDemo/config/atg/userprofiling/userProfile.xml

If you install any ATG applications that extend the standard external user profile definition, the definition also includes the /atg/userprofiling/userProfile.xml file located in the application’s ExternalUsers sub-module. This configuration allows all external profile properties to be visible to all internal ATG application users. For more information on these sub-modules, including where to run them, refer to the ATG Multiple Application Integration Guide.

The external user profile repository definition is specified by the definitionFiles property of the ProfileAdapterRepository component. This property names a file in the ATG configuration path. Each of the above-listed user profile repository definition files appears in the configuration path at /atg/userprofiling/userProfile.xml. The system uses XML file combination to combine these files into a single definition to use for the profile repository. XML file combination is described in detail in the XML File Combination section of the Nucleus: Organizing JavaBean Components chapter in the ATG Platform Programming Guide. This section describes some factors to remember in modifying the standard user profile repository definition with XML file combination.

When you extend a user profile repository definition, it is important to understand how the Dynamo Application Framework combines XML files. An item descriptor cannot have two properties with the same name. The xml-combine="replace" directive works only with property definitions that match exactly, from the outermost tag to the property tag.